Usage Reports | MuleSoft Documentation
# Usage Reports
Usage reports provide comprehensive monthly and daily summaries that give you valuable insights into your resource use across Anypoint Platform products. By correlating your usage with billing cycles, you can gain insights into the factors influencing your costs, which enables you to proactively manage your budget and make informed decisions to optimize your resource allocation.
When you use an Anypoint Platform product that is metered, MuleSoft measures your usage and aggregates the records on a daily and monthly basis. Monthly and daily usage reports have a three-day latency, meaning that today’s usage is available in three days. All reports are calculated using the UTC time standard. For example, a daily usage is aggregated from 00:00 to 00:00 UTC.
Daily usage retention is three months and monthly usage retention is up to five years.
Organizations that have a usage-based pricing model can compare actual usage from the report against the existing contract. However, usage reports are not for billing purposes. For more information about usage metrics and pricing, read Anypoint Platform Pricing and Usage and Pricing Metrics Reference
Some usage data, such as monthly statements and vCore allocation, appears in different areas of Anypoint Platform or Salesforce products.
  * Monthly statements for Mule runtime, including Mule flows, Mule messages, and data throughput are sent to the primary billing contact.
Automation credits for RPA, Composer, Intelligent Document Processing (IDP), Salesforce Flow Orchestration, and MuleSoft for Flow are sent to the primary billing contact.
For more information, see Monthly Account Summaries documentation in Salesforce.
  * Alerts for usage reaching 80% and 90% of the contractual entitlement are sent automatically to the primary billing contact email address. The primary billing contact gets alerts monthly once thresholds are reached.
For more information, see the Salesforce Usage Alerts FAQ knowledge article.
  * Runtime Manager vCore allocation information and other metrics appear in Access Management.
For more information, see Runtime Manager Metrics.


Government Cloud and Anypoint Private Cloud Edition usages aren’t available in usage reports.
## Products Available in Usage Reports
The following products are available in usage reports:
  * Anypoint MQ
  * API Experience Hub
  * API Governance
  * API Manager
  * Flex Gateway
  * Intelligent Document Processing (IDP)
  * Mule Runtime
  * Object Store v2


## Supported Mule Runtime Versions
To view usage reports for Mule runtime, all applications (in production and sandbox) must use these Mule versions:
Deployment Type | Version Requirements  
---|---  
CloudHub 2.0 | The latest date-patch versions for 4.3.0 and later  
CloudHub | The latest date-patch versions for 3.9 and 4.2.0 and later  
Runtime Fabric |  One of these versions or any later date-patch: Mule 4 image versions:
  * 4.5.0 and later
  * 4.4.0-20230111-1
  * 4.3.0-20221212-2
  * 4.2.2-20221027-7
  * 4.2.1-20221027-7
  * 4.2.0-20221027-6

Mule 3 image versions:
  * 3.9.5-20230424-2
  * 3.9.4-20230424-1
  * 3.9.3-20230424-1
  * 3.9.2-20230424-1
  * 3.9.1-20230424-1

  
Hybrid Standalone |  One of these versions or any later date-patch:
  * 4.6.0 and later
  * 4.4.0-20221111
  * 4.3.0-20221024

Runtime Manager Agent 2.7.0 and later  
You must redeploy your apps with a supported version, either manually or during the monthly patching cycle. The monthly patching cycle is applicable only for CloudHub and CloudHub 2.0 applications.
You can roll back to a previous successful application configuration. However, if an app is using a Mule version not supported by usage reports, you must choose a compliant Mule version before deploying changes. After deployment, a new configuration with the previously chosen settings and a supported runtime is created.
## Before You Begin
Usage reports are available only when you’re signed in to the root organization and don’t appear at the business group level.
To access usage reports, you need the Usage Viewer permission. If you don’t have this permission, contact your organization administrator to request access. The Usage Viewer permission must be applied at the root organization level rather than the business group level.
## Access Usage Reports
  1. Sign in to Anypoint Platform using an account that has the Usage Viewer permission for your root organization.
  2. In the Anypoint Platform navigation bar, click the business group selector, and ensure you are at the root organization level.
  3. In the Anypoint Platform navigation bar, click your username icon and select **Usage Reports**.
  4. Select the product for which to view a usage report.
  5. Click **Monthly Usage Report** or **Daily Usage Report**.
  6. Select the month or day of the usage report to view. For the selected product, only dates that Anypoint Platform collected data for are available.
The usage report appears, displaying an assortment of usage metrics that are dependent on the product you selected.


## Export Usage Reports to a CSV File
You can export both daily and monthly usage reports to CSV files. These metrics match the data available in usage reports.
  1. Navigate to the usage report to download.
  2. Click **Export as CSV**.


## Usage API
Use the Anypoint Usage API to programmatically access usage data. The API provides both daily and monthly details. Usage metrics are organized by business group and application. This provides detailed insight into product consumption.
To use the API, see the API documentation for the Anypoint Usage API for access and implementation details. Users must have Usage Viewer permission to access the Usage API.
## Usage Reports on Hyperforce
All features of Usage Reports are supported on Hyperforce.
## See Also
  * Anypoint API Governance Overview
  *