Viewing and tracking license usage

License Service collects and measures the license usage of your product at the cluster level. You can retrieve this data upon request for monitoring and compliance. You can also retrieve an audit snapshot of the data that is audit evidence.

About License Service

License Service is required for monitoring and measuring license usage of the IBM Cloud Paks® and IBM® stand-alone containerized software in accord with the pricing rule for containerized environments. Manual license measurements are not allowed.

License Service

Note: Only one instance of License Service is deployed per cluster regardless of the number of IBM Cloud Paks and containerized products that you have installed on this cluster.

Deployment

License Service is automatically deployed as a part of your product, and has minimal impact on cluster capacity. License Service works in the background and does not require any configuration or user engagement.

To make sure that this service is successfully deployed, see: Validating License Service deployment.

Storage

License Service does not require persistent storage.

Using License Service for container licensing

After the automatic deployment, License Service collects and measures the license usage of the products that are deployed on the cluster. This data is required for compliance and audit purposes. With License Service, you can use the dedicated APIs to retrieve an audit snapshot for the cluster.

Core license metrics

Currently, supported core-based metrics for container licensing are Processor Value Unit (PVU) and Virtual Processor Core (VPC). For core license metrics, you are obliged to use License Service and periodically generate an audit snapshots to fulfill container licensing requirements. For more information, see Audit snapshot.

If your cluster has hyperthreading, also referred to as Simultaneous multithreading (SM) or Hyperthreading (HT), enabled, see Hyperthreading.

Non-core metrics

License Service additionally collects information about license usage of IBM® software that is enabled for reporting and licensed with other non-core metrics. You can use this data to track the license usage of these products, and determine your entitlement needs. For more information, see Reported metrics.

Viewing license usage on the Licensing dashboard

If License Service is automatically deployed with you IBM Cloud Pak®, you can track your license usage on the Licensing dashboard. The Licensing dashboard is an intuitive report that shows details of the license usage on one or more clusters. For more information about the Licensing dashboard and the information it presents, see Viewing license usage on the Licensing dashboard.

To view the Licensing dashboard, you must first deploy License Service Reporter, and configure the data sources to fill the report with data. For more information, see Tracking license usage in multicluster environment with License Service Reporter.

You can also view your license usage through the dedicated APIs. For more information, see Retrieving license usage data.

Tracking license usage in multicluster environment

Note: In multicluster environment, the cumulative report is not required for audit.

You can use the data that is collected by License Service from individual clusters to track the cumulative license usage in a multicluster environment. For detailed information, see Tracking license usage in a multicluster environment.

You can use License Service Reporter for that purpose. License Service Reporter is not obligatory. It is an extension of License Service that aggregates license usage data from multiple clusters and gives you clear view for the entire environment. License Service Reporter is deployed on one cluster and uses extra resources for aggregation. To use this functionality, additional configuration is needed. For more information, see Tracking license usage in multicluster environment with License Service Reporter.

If you prefer to track license usage without deploying License Service Reporter, you can follow the non-automated procedure. For more information, see Manually tracking license usage in multicluster environment.