Viewing your usage

Viewing service usage details by using 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 by using the console

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]
     

Viewing device and service purchase information by using the console

You can view your device usage and service purchases for classic infrastructure devices and services by going to Manage > Billing and usage in the IBM Cloud console.

View information about your classic infrastructure device and service purchases by selecting an option from the Sales navigation:

• Select Device upgrades to view specific information, such as which devices are upgraded and the date the case was created and completed. To view this page, you need an access policy with the Viewer role or higher on the Billing service.

  You can view all open and closed cases for your infrastructure device upgrades. You can also track the progress of the case, view a logged correspondence with support, and keep track of cases that are opened and completed.

• Select Orders to view a list of all the orders made in your account. To view this page, you need the Add/Upgrade Storage (StorageLayer), Add Server, or Add/Upgrade Services classic infrastructure permission.

• Select Cancellations to view all cancellations on your account. To view this page, you need both the Cancel server and Cancel services classic infrastructure permissions.

  You can view a list of all of the cancellations made in the account, and you can view them by type of device or service. The cancellations show the device name and the case number. This list tracks ongoing and closed cases, and you can view your messages with support.

• Select Shipments to view your digital shipments, such as data transfer requests or physical shipments. To view this page, you need an access policy with the Viewer role or higher on the Billing service.

Viewing billing and usage information by using the console

To view billing and usage for classic infrastructure resources, you need an access policy with the Viewer role or higher on the Billing account management service. See IAM access for more information.

• Select Billing items to view billing items and their associated devices. Billing items are services and products that are not a server, such as storage. Associating a billing item with a device helps you track and organize costs in your invoice.

  By default, the Billing items page displays all associated billing items. You can change your view by clicking the Associated Billing Items menu and selecting another option. You can associate or disassociate one item, or expand the Bulk Actions operation for multiple items at a time. You can cancel individual billing items at any time.

• Select Invoices to view detailed invoices that list your device and service usage and the billed amount for each item.

  To view your billed usage for the current invoicing period, click the link with your next invoice date under Next Recurring Invoice.

  You can download a PDF or spreadsheet copy of an invoice for your offline records by clicking the Download icon and selecting your download options.

Viewing your classic infrastructure usage by using the API

You can programmatically view your classic infrastructure 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. For more information, see Viewing your usage by using the API.

Some accounts must use the SoftLayer API to retrieve usage information for classic infrastructure resources. For more information, see SoftLayer_Billing_Invoice and SoftLayer_Billing_Invoice_Item.