This documentation supports the 20.08 version of BMC Helix Platform. 
To view an earlier version, select 20.02 from the Product version menu.

Measuring the cognitive service consumption

BMC SaaS Operations and administrators can monitor the consumption of the BMC Helix Cognitive Automation by using the Cognitive Consumption dashboard on the BMC Helix Innovation Studio UI. You can also download the consumption reports, configure thresholds, and configure notifications so that you receive an email when the consumption exceeds the specified threshold. 

You can view the consumption reports of various IBM Watson services provisioned to work with BMC Helix Platform.

By monitoring the cognitive service consumption, you can get answers to the following questions and make informed decisions:

  • How much of a service am I using?
  • How many unique users logged in to chatbot in a given month or over a period of time?
  • Is there a need to purchase more capacity?

Reports on the Cognitive Consumption dashboard

OperationReport name and Time rangeParameter measuredExample
Chat
  • Users (N)—monthly
  • User summary—annual (from activation of the service)

Number of unique users logged in to a chatbot



  • Conversations (N)—monthly
  • Conversation Summary—annual (from activation of the service)

Number of chat conversations

Important: The BMC Helix Chatbot consumption is changed from conversation-based measurement to user-based measurement. If you have already purchased BMC Helix Chatbot based on the number of chat conversations, you can continue to view the conversation data, however, you will not see the number of unique users data.

The following actions are considered as a chat conversation:

  • When a chat session times out
  • When a developer clears the chat session to mark the session complete
  • When a conversation has 50 responses

BMC Helix Cognitive Automation

  • API Calls (N)—monthly
  • API Call Summary—annual (from activation of the service)

Number of API calls made for classification, summarization, or tone analysis.

Cognitive search
  • Documents (N)—monthly
  • Document Summary—annual (from activation of the service)
  • Document Storage (GB)—monthly
  • Document Storage Summary—annual (from activation of the service)


  • Number of documents uploaded to a collection in IBM Watson Discovery
  • Size of the documents uploaded to the collection in IBM Watson Discovery

Methods for monitoring cognitive service consumption

You can monitor the cognitive service consumption in the following ways:

  • View the Cognitive Consumption dashboard.
    The dashboard displays cognitive service consumption statistics that enable an administrator to obtain a usage report for their company. 
    For more information about downloading the consumption statistics, see To download the cognitive service usage report from the Cognitive Consumption dashboard.
  • Configure the threshold and email notifications when the cognitive service usage exceeds a specified threshold.
    You can configure the email addresses and three thresholds each for API calls, document storage capacity, and conversation capacity.  For more information about configuring the threshold and email addresses for notifications, see 
    To configure thresholds and email notifications.

  • View the notification history
    The notification history displays the list of notifications that are triggered when the cognitive service usage exceeds the specified threshold. The notification history displays entries only after
    notifications are triggered. For more information, see To view the notifications history.

 To download the cognitive service usage report from the Cognitive Consumption dashboard

  1. Log in to BMC Helix Innovation Studio and navigate to the Administration tab. 
  2. Select Configure My Server > Telemetry
    The Cognitive Consumption dashboard displays statistics for each operation—chatbot, cognitive search, and cognitive service automation (includes auto-categorization, summarization, tone analysis).

  3. Download the cognitive service usage report.

    1. Click Download.

    2. In the Download CSV File dialog box, select a predefined time or enter a specific period.
    3. Click Download.

The CSV report is downloaded. The following image shows a sample report:

 To configure thresholds and email notifications for cognitive service usage

You can configure up to three thresholds and 10 email addresses.

  1. Log in to BMC Helix Innovation Studio and navigate to the Administration tab. 
  2. Select Configure My Server > Telemetry
  3. Click the Notifications icon  that corresponds to the operation for which you want to configure the thresholds.
  4. Configure the capacity and threshold.
    1. In the Capacity section, enter the total capacity. 
      Example: In the Capacity section for Chatbot Users, enter 100. 
    2. In the Threshold 1 (%) field, enter the threshold for when you want to trigger the first notification. 
      Example: 20.  If the total capacity is 100 users, the first notification is triggered when the number of users exceed 20. 
    3. In the Threshold 2 (%) field, enter the threshold for when you want to trigger the second notification.
      Example: 40. If the total capacity is 100 users, then the second notification is triggered when the number of users exceed 40.
    4. In the Threshold 3 (%) field, enter the threshold for when you want to trigger the third notification. 
      Example: 60. If the total capacity is 100 users, then the third notification is triggered when the number of users exceed 60.
  5. Configure the email addresses.
    1. From the Available Email Notifications recipients list, which displays the email addresses of all the users created in the Foundation data for a tenant, select the email addresses to which you want to send the cognitive service consumption notifications. 
      You can select up to 10 email addresses. To add people to the Foundation data, see Creating or modifying Person data.
    2. To add the email addresses to the Selected Email Notifications Recipients list, click 
    3. Click Save. 

 To view the notification history

  1. Log in to BMC Helix Innovation Studio and navigate to Administration tab. 
  2. Select Configure My Server > Telemetry
  3. Click the Notifications icon  that corresponds to the operation for which you want to view the notifications history. 
  4. Click Notification History

Related topic

BMC Helix Platform licensing model

Reporting and analyzing chatbot usage

Was this page helpful? Yes No Submitting... Thank you

Comments