Metering and tracking usage for decision runtime

IBM® Usage Metering Service (UMS) reports information about decision services for metering, such as the number of successfully executed decision services. The metering mode for the consumption entitlement is configured by default.

IBM Usage Metering Service

Usage metrics of Decision Intelligence Client Managed Software are collected with UMS and sent to IBM Software Central. UMS captures the metrics and generates usage reports, which can be used for auditing purposes and evidence of compliance.

For Decision Intelligence Client Managed Software, the metrics of the number of successfully executed decision services are collected.

For more information, see Collecting and sending metrics to IBM Software Central

Consumption entitlement

The MONTHLY_API_CALL metric that is reported by the decision runtime represents the daily number of executed decisions. For example, if an application executes decision services 10,000 times per hour in one day, the metric shows 240,000 calls for that day.

The MONTHLY_API_CALL metric for Decision Intelligence Client Managed Software includes only successful decision service executions that occurs within a day, which means any failed execution is excluded. Decision services that are executed after midnight are counted in the report for the following day.

Note: About Establishment:
  • Establishment is not a metric that is tracked by License Service or Usage Metering Service.

  • An Establishment is a single physical site, including the surrounding campus and satellite offices located within 50 kilometers, of Licensee's site address.

    Licensee must obtain an entitlement for each Establishment at or for which the Program will be used. Licensee is permitted to deploy an unlimited number of copies of the Program within the Establishment. An entitlement for an Establishment is unique to that Establishment and may not be shared, nor may it be reassigned other than for the permanent closing of the Establishment.

  • Establishment, and Monthly API Call entitlements are not alternative means for licensing the Program. Licensee must obtain the appropriate number of Establishment entitlements as well as the appropriate number of Monthly API Call.

Reporting frequency

There are two stages in reporting with UMS.

  1. Reporting from Decision Intelligence Client Managed Software to UMS is scheduled every 20 minutes by default.

    You can configure the frequency of this reporting by using the spec.usage_metrics.reporter.cronjob_schedules parameter in the Decision Intelligence Client Managed Software custom resources (CR). For more information about this parameter, see Decision runtime parameters.

  2. Reporting from UMS to IBM Software Central is scheduled once per day at 00:05 AM by default.

    You can configure the frequency of this reporting by using the spec.sender.softwareCentral.frequency parameter in the IBMUsageMetering CR.

The UNIX cron format is used to specify time in both of the parameters.