Monitoring subscription usage

IBM Hybrid Cloud Mesh provides subscription usage for real-time monitoring of your subscriptions.

You can view subscription usage by using the Mesh console, the CLI, and the API. Your subscription entitles you to a number of Resource Units for each month, which you can easily track.
Note: To view subscription usage, you must be an Administrator.

Resource Units

You can track your usage of Resource Units by month to check whether you are on track for your subscription or have a surplus. You can view your Resource Units usage from the Mesh console and the CLI.

Resource Units are the application and service deployments that are counted for each use. The count starts when a resource is managed by, processed by, or used by the cloud service. The count happens when traffic appears between an application and service deployment on the overlay network. The count includes interactions with Red Hat® Service Interconnect.

Viewing subscription usage

To monitor subscription usage in the Mesh console, click Manage > Subscription usage from any page.

You can also get subscription usage by using the CLI. The subscription usage service includes two types of usage data:

Historical data
Shows the number of Resource Units that are used for each month. The data is aggregated by month, but excludes the current month.
Current month data
Shows the number of Resource Units that are used each day for the current month. The data is aggregated by day.

By using the CLI, you can set the also view the data on a daily basis.

To list all Resource Units:

palmctl get resource-units

To get the details of one specific Resource Unit by using an ID of 1:

palmctl get resource-unit --id 1

To get subscription usage aggregated by month:

palmctl get resource-usage history --from YYYYMM --to YYYYMM

To get subscription usage aggregated by day for the current month to date:


palmctl get resource-usage mtd
Note: Resource Units are specific to a month. You can use different Resource Units daily during the month. The resource-usage mtd retains the Resource Unit count for the current month. In the next month, the Resource Units count does not change.