Usage

In this guide, you'll learn how to monitor your Cloud organization's standard and Flex Usage.

View Usage on Cloud#

In your organization's settings, you can view your current plan and usage limits. These usage limits depend on the plan your organization is on, and are applied across all projects within the organization.

Note: Organizations on the Enterprise plan don't have usage limits, and therefore don't have a Usage tab in their settings.

To view your organization's usage:

  1. Make sure you're viewing the correct organization's dashboard in Cloud.
  2. Click on the icon in the organization switcher at the top left of the Cloud dashboard.
  3. Choose "Organization Settings" from the dropdown.
  4. Change to the "Usage" settings from the sidebar.

In the Usage settings, you'll find a table with the list of resources your organization is using, along with their current usage levels and limits based on your plan.

Usage table in the Usage settings


What is Flex Usage?#

Your organization has a set of usage limits based on its current plan. These usage limits are applied across all projects within the organization.

Usage that exceeds the limits of your plan is considered Flex Usage. For example, if your plan allows for 100GB data transfer, any usage beyond that limit would be classified as Flex Usage.

To learn how your Flex Usage is billed, refer to the Billing guide.

Monitor Flex Usage#

You can view additional Flex Usage for each resource and its charge in the usage table. For each resource, the table has the following columns useful for monitoring Flex Usage:

  • Flex: The amount of usage beyond your plan limits. For example, the additional data transfer amount.
  • Charge: The cost associated with the Flex Usage.

If you have Flex Usage, you can also see the flex charges visualized in the chart above the table.

Usage Chart Per Resource#

In the "Billable metrics" section of the Usage settings, you can view a chart for each resource showing your usage over time with forcasted usage. For example, you can view the usage chart for data transfer, Compute, object storage, etc...

Usage Chart Types

At the type of the "Billable metrics" section, you can find a "Cumulative" toggle. When enabled, the charts will display cumulative usage over time. When disabled, the charts will show daily usage.

Cumulative usage helps you understand the total usage up to a specific date, while daily usage provides insights into your usage patterns on a day-to-day basis.

Cumulative usage toggle in the Billable metrics section

Understanding the Charts

In each chart, there are two line types:

  1. Green lines: Represent your actual usage for the resource over time. This is the usage that has already occurred.
  2. Grey lines: Represent the forecasted usage for the resource. This is an estimate of your future usage based on historical data.

There's also a horizontal orange dashed line indicating your plan's usage limit for that resource. If your actual usage (green line) exceeds this limit, the excess is considered Flex Usage.

Usage chart showing actual and forecasted usage with plan limit


Download Cloud Usage Report#

To download your organization's usage as a JSON file:

  1. Make sure you're viewing the correct organization's dashboard in Cloud.
  2. Click on the icon in the organization switcher at the top left of the Cloud dashboard.
  3. Choose "Organization Settings" from the dropdown.
  4. Change to the "Usage" settings from the sidebar.
  5. Click the button at the top right.

The JSON file will be downloaded automatically.


View Usage for Different Date Ranges#

By default, the usage table and Flex Usage chart show data for the current billing cycle on Cloud.

To view usage for a different billing cycle, click on the "Current billing cycle" dropdown at the top of the Usage settings. You can then select the previous billing cycle, or a custom date range.

After making your selection, the usage table will update automatically after a few seconds.

Usage table updated for different billing cycle

Was this guide helpful?
Ask Anything
Ask any questions about Medusa. Get help with your development.
You can also use the Medusa MCP server in Cursor, VSCode, etc...
FAQ
What is Medusa?
How can I create a module?
How can I create a data model?
How do I create a workflow?
How can I extend a data model in the Product Module?
Recipes
How do I build a marketplace with Medusa?
How do I build digital products with Medusa?
How do I build subscription-based purchases with Medusa?
What other recipes are available in the Medusa documentation?
Chat is cleared on refresh
Line break