Viewing your usage

Viewing service usage details in the console

The usage summary widget provides a view of your month-to date-spending, last month spending, average monthly spending, and next month's predicted usage at a glance. For a more granular view of your usage and specific costs that are associated with services, view your usage from the usage page.

Viewing your usage by using the API

You can programmatically view your usage by calling the IBM Cloud Usage Reports API. You can base the query in your API call on an account, org, resource group, or resource instance.

The following examples show queries that you can use to view account level usage:

curl -X GET -H "Authorization: {iam_token}" -H "Accept: application/json" "{base_url}/v4/accounts/{account_id}/usage/{billingmonth}"

ServiceCall<AccountUsage> getAccountUsage(GetAccountUsageOptions getAccountUsageOptions)

getAccountUsage(params)

get_account_usage(self,
        account_id: str,
        billingmonth: str,
        *,
        names: bool = None,
        accept_language: str = None,
        **kwargs
    ) -> DetailedResponse

(usageReports *UsageReportsV4) GetAccountUsage(getAccountUsageOptions *GetAccountUsageOptions) (result *AccountUsage, response *core.DetailedResponse, err error)

Exporting your usage details to a CSV file

You can export a summary of your account's usage, or information about your services and instances, to a CSV file. By exporting your CSV file, you can easily find usage and cost information estimates for each resource for chargebacks to your customers or to understand more about your costs. Because the report includes usage data for the entire account, you need Administrator access on the Billing service to export usage details.

This is not an estimate of your final bill. Instance costs don’t reflect your final bill because other charges or discounts might be applied to your account.

1. In the console, go to Manage > Billing and usage, and select Usage.

2. Click Export CSV and select one of the options:

   • Click Summary for a high-level overview of the usage and associated costs for your account.
   • Click Instance for detailed usage information about each service instance.

   You can use the tag related columns in the instance CSV file to help analyze the resources in your account. For example, you might have multiple projects in an account, each with a Kubernetes cluster. You can organize the CSV data according to the project tag on each instance so that you can better analyze the individual projects' cost. For more information about tagging, see Working with tags.

   Consider creating tags as a key:value pair to group related tags. The key becomes a column in the CSV file and the value is populated in the respective rows of the column. If you don't follow a key:value tag style, the tags appear in the Other Tags column.

Viewing your usage by using the CLI

As an alternative to the console, you can view your usage by using the IBM Cloud command-line interface (CLI). Use the following commands to retrieve resource usage and billing information.

1. Log in, and select the account.

   ibmcloud login
   

2. View usage by running the ibmcloud billing command as shown in the following examples.

   • View usage for the current month.

     ibmcloud billing account-usage [-d YYYY-MM] [--output FORMAT] [-q, --quiet]
     

   • View monthly usage for an org (account admin or org billing manager only):

     ibmcloud billing org-usage ORG_NAME [-d YYYY-MM] [--output FORMAT] [-q, --quiet]
     

   • View monthly usage for a resource group (account admin or resource group admin only):

     ibmcloud billing resource-group-usage GROUP_NAME [-d YYYY-MM] [--output FORMAT] [-q, --quiet]
     

   • View monthly resource instances usage under the current account:

     ibmcloud billing resource-instances-usage [-o ORG] [-g RESOURCE_GROUP] [-d YYYY-MM] [--output FORMAT] [-q, --quiet]