Metering and tracking usage for decision runtime

IBM® License Service (ILS) 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.

License Service

License Service discovers the software that is installed in your infrastructure, and generates reports:
  1. You deploy Automation Decision Services to your Kubernetes cluster.
  2. You deploy License Service to the same cluster.
  3. You can start retrieving a report for the license usage.

For more information about License Service, see the License Service External link opens a new window or tab.

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 Automation Decision Services 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.

The metric is refreshed every 10 minutes by default. You can modify the refresh interval by using the spec.decision_runtime.ils.flush_interval parameter.

Note: About Establishment:

  • Establishment is not a metric that is tracked by License 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.

Parameters for License Service

The spec.decision_runtime.ils.flush_interval parameter is used for License Service. For more information, see Decision runtime parameters.

Retrieving license usage

To view the license usage, retrieve the License Service token, and access the http://$LICENSING_URL/status?token=$TOKEN URL:
export TOKEN=$(kubectl get secret ibm-licensing-token -o jsonpath={.data.token} -n ibm-common-services | base64 -d)
You can also retrieve the license report in a ZIP file by running the following command:
curl -k https://$LICENSING_URL/snapshot?token=$TOKEN --output report.zip

For more information, see APIs External link opens a new window or tab.