Enable usage reporting

Overview on usage reporting

Customers have the option to enable usage reporting to track software consumption across a hybrid cloud environment. Usage data shows on the following pages:

• Current usage — shows usage across all products on the account that report usage.
• Product usage — shows usage details on individual products on the account that report usage.
• Software — shows usage details on individual products on the account that report usage, as well as subscription plan details.

To enabled usage reporting, leverage the following technologies:

• IBM License Service — reports usage on operator-based products deployed to OpenShift. Users can configure their OpenShift environment to deliver usage to Workspace.
• IBM License Metric Tool — reports usage on products that are deployed to environments other than OpenShift, including virtual machines, selected public clouds, logical partitions, and physical computers. Users can export data from the tool to Workspace.

Enable usage reporting through IBM License Service

Usage data collected by IBM License Service can be integrated with your Workspace. The data transfer applies only to information about the products that are deployed on a cluster and enabled for License Service integration. Data shows on Current usage and Product usage pages. To integrate IBM License Service, prepare your OpenShift environment using the following procedure.

Prerequisites

• Install the following items to a supported version of Red Hat® OpenShift® Container Platform:

  • Red Hat Marketplace Operator
  • IBM License Service Operator
    • License Service as a part of an IBM Cloud Pak (included in IBM Cloud Pak foundational services version 3.12 or later)
    • License Service version 1.9.0 or later without an IBM Cloud Pak

About this task

To enable usage reporting, edit the IBMLicensing custom resource using OpenShift console or OpenShift Command-line Interface.

Note: For IBM License Service version 1.12.0 and higher, usage reporting is automatically enabled when License Service is deployed. For more information, refer to About IBM License Service version 1.12.0 and higher.

Procedure

1. Open IBMLicensing custom resource:

   • From OpenShift console
     1. Log in to your OpenShift console.
     2. Go to Operators > Installed Operators.
     3. From the Project drop-down list, select ibm-common-services
     4. Select IBM Licensing Operator.
     5. Select the IBM License Service tab. The instance of License Service custom resource is listed.
     6. From the overflow action menu, select Edit IBMLicensing.
   • From the command line
     1. Run the following command:

     oc edit IBMLicensing instance -n ibm-common-services
     Copy to clipboardCopied!

2. Add the following line to the IBMLicensing section:

   rhmpEnabled: true
   Copy to clipboardCopied!

   For example:

   apiVersion: operator.ibm.com/v1alpha1
   kind: IBMLicensing
   metadata:
     name: instance
   spec:
     version: 1.9.0
     datasource: datacollector
     httpsEnable: true
     instanceNamespace: ibm-common-services
     rhmpEnabled: true
   Copy to clipboardCopied!

3. After you edit the YAML, save your changes.

Result

Usage reporting is now enabled. Usage data shows throughout the experience after 36 hours.

About IBM License Service version 1.12.0 and higher

Starting from License Service version 1.12.0, the integration with Red Hat Marketplace is automatically enabled when License Service is deployed. You do not need to edit the IBMLicensing custom resource and add the rhmpEnabled parameter.

Note that the integration is automatically enabled only when the rhmpEnabled parameter has not been already set. Otherwise, the set value has a higher priority. When you previously set the rhmpEnabled parameter to false this setting is not overwritten.

To verify whether the integration is enabled, check the IBMLicensing custom resource. See the status of the rhmpEnabled parameter, which is listed under status > features.

Enable usage reporting through IBM License Metric Tool

Usage data collected by IBM License Metric Tool can be exported to your Workspace. Data shows on Current usage and Product usage pages.

To enable usage reporting, refer to the following process:

1. Get a pull secret, and then
2. Configure export settings through IBM License Metric Tool.

Note: Once enabled, usage data shows throughout the experience within the hour.

Get pull secret

Use the pull secret to export data to your Workspace from ILTM.

Procedure

1. On the main menu, click your user name, click My Account, click Pull secrets, and then click Create pull secret.
2. On the Pull secret name box, enter a unique name for your pull secret.
3. To get your pull secret, on the Your pull secret box, click the Copy button (copy icon).
4. Click Save.

Result

You copied your pull secret.

Next steps

Using your pull secret, configure export settings through IBM License Metric Tool.