Enable usage reporting

Overview on usage reporting

Customers have the option to enable software usage reporting to track software consumption across a hybrid cloud environment. The usage may consist of license, billable, paygo and adoption usage as well as infrastructure events. The usage data is shown on the Usage page.

The following technologies are able to gather and report usage data to IBM Software Central:

  • IBM Metrics Operator — reports usage on products that store metrics in Prometheus.
  • IBM License Service — reports license usage for IBM products deployed on OpenShift and requires IBM Metrics operator to send usage data to IBM Software Central.
  • IBM License Metric Tool — reports license usage for products that are deployed to environments other than OpenShift or Kubernetes, including virtual machines, selected public clouds, logical partitions, and physical computers.
  • IBM Data Reporter Operator — gathers license usage for selected IBM products, but primarily gathers adoption usage data. Prerequisites IBM Metrics Operator.
  • IBM Software — IBM software products that are configured to report usage data. IBM Software products can onboard through the provided link
  • IBM MCSP — reports usage data submitted by IBM software products that have been on-boarded to MCSP.

Your product may instruct you to install one or many of these technologies.

Enabling license usage reporting for IBM products deployed on Red Hat OpenShift

To report license usage for IBM products deployed on Red Hat OpenShift to IBM Software Central, both IBM License Service and IBM Metrics Operator need to be installed on each cluster from which license usage data needs to be reported.

IBM License Service tracks license usage for all IBM Products deployed on OpenShift, which are licensed based on Virtual Processor Core (VPC) and Processor Value Unit (PVU) metrics. It also has capability to gather usage data for other license metrics from deployed products via dedicated APIs. IBM License Service uses IBM Metrics Operator to send the gathered license usage data to IBM Software Central.

Data sent to IBM Software Central

License and usage data are collected from the OpenShift cluster Prometheus instance. Details of the data and format are described in the metering API documentation.

Procedure

  1. Install and Configure IBM Metrics Operator

    1. Configure one of the following storage provisioning options to define storage for IBM Metrics Operator and Openshift User Workload Monitoring.
    2. Enable Openshift User Workload Monitoring on your cluster. See IBM Metrics Operator for more information. You may apply the following configuration to the cluster to enable User Workload Monitoring. 
      oc apply -f - <<EOF
      apiVersion: v1
      data:
        config.yaml: |
          prometheus:
            resources:
              requests:
                cpu: 70m
                memory: 1Gi
            retention: 168h
            volumeClaimTemplate:
              spec:
                resources:
                  requests:
                    storage: 40Gi
      kind: ConfigMap
      metadata:
        name: user-workload-monitoring-config
        namespace: openshift-user-workload-monitoring
      ---
      apiVersion: v1
      kind: ConfigMap
      metadata:
        name: cluster-monitoring-config
        namespace: openshift-monitoring
      data:
        config.yaml: |
          enableUserWorkload: true
      EOF
    3. Create or get your pull secret
      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.
    4. Install the IBM Metrics Operator from your OpenShift cluster OperatorHub from the Certified Operators catalog, or by running the following to create the operator Subscription 
      oc new-project ibm-software-central
      oc apply -f "https://swc.saas.ibm.com/provisioning/v1/rhm-operator/rhm-operator-subscription?metrics=true&approvalStrategy=Automatic"
    5. Create a Kubernetes secret in the installed namespace with the name redhat-marketplace-pull-secret and key PULL_SECRET with the value of the pull secret 
      oc create secret generic redhat-marketplace-pull-secret -n ibm-software-central --from-literal=PULL_SECRET=${PULL_SECRET}
    6. Update MarketplaceConfig to accept the license. A default MarketplaceConfig CustomResource is automatically created by the ibm-metrics-operator when the secret redhat-marketplace-pull-secret is created 
      oc patch marketplaceconfig marketplaceconfig -n ibm-software-central --type='merge' -p '{"spec": {"license": {"accept": true}}}'

  2. Install IBM License Service Operator (if not installed)

    IBM License Service should be installed as part of your IBM products deployed on OpenShift. This is usually done automatically, but a manual procedure may be also described as part of the IBM products’ deployment, which should be your primary reference. If IBM License Service is not yet present on the cluster, you can refer to the following generic resources to install it:

Result

Usage reporting to IBM Software Central is now enabled. It is queued and uploaded daily.

Enabling license usage reporting for traditionally deployed IBM products

The tool for tracking license usage for traditionally deployed IBM software is IBM License Metric Tool (ILMT). This covers software running on any virtualization other that OpenShift or Kubernetes (VMs, LPARs, LDOMs, zones as well as bare metal servers). License usage data collected by ILMT can be uploaded to IBM Software Central where it is consolidated with license usage from OpenShift clusters (delivered through IBM License Service) delivering global license usage for each offering across all deployment types (with breakdown into clusters and ILMT).

To enable usage reporting, you need to coinfigure ILMT using the following procedure:

Procedure

  1. Create or get your pull secret
    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.
  2. Configure export settings through IBM License Metric Tool.
  3. Since ILMT is not automatically uploading data to IBM Software Central, you need to periodically upload the data manually by repeating last step from the procedure above.

Result

License usage data is uploaded to IBM Software Central and will show on Usage page within one hour.

Enabling adoption and license usage reporting through IBM Data Reporter Operator on Red Hat OpenShift

IBM Data Reporter Operator allows IBM products to report primarily adoption usage data, but this channel is also used by selected products to upload license usage. Adoption usage is a collection of product specific parameters describing product deployment, configuration and usage patterns.

IBM Data Reporter Operator uses IBM Metrics Operator to upload collected data to IBM Software Central.

Data sent to IBM Software Central

The product specifies the usage event data to send to IBM Software Central.

Procedure

  1. Install IBM Metrics Operator as a prerequisite
  2. Install IBM Data Reporter Operator from your OpenShift cluster OperatorHub Certified Operators catalog, or by running the following to create the operator Subscription 
    oc new-project ibm-software-central
    oc apply -f "https://swc.saas.ibm.com/provisioning/v1/rhm-operator/rhm-operator-subscription?datareporter=true&approvalStrategy=Automatic"

Result

Adoption usage reporting is now enabled. Data submitted by products to IBM Data Reporter Operator is uploaded hourly. At the moment adoption data is not shown in IBM Software Central, but allows IBM product teams to analyze usage statistics for improved future product development.