Query savings plan usage and coverage
After purchasing a savings plan, you can analyze its performance by tracking two key metrics: usage and coverage. Usage helps you determine if your commitment is being wasted, while coverage shows how much of your spending the plan covers. This topic describes how to view your savings plan usage and coverage, and how to use these metrics to optimize your plan.
Query savings plan usage
Usage indicates how much of your savings plan commitment is being used. A higher usage rate means you are making full use of your savings plan.
Formula: Savings plan usage = Deducted Amount / Total Amount (Savings Plan), where:
-
Deducted Amount: The amount of pay-as-you-go bills that the savings plan actually offsets within a specific period.
-
Total Amount (Savings Plan): The plan's hourly commitment multiplied by the number of hours in its term.
Example
A user purchases a 3-year, all-upfront, general-purpose savings plan. From October 1, 2025, to December 31, 2025, the Total Amount (Savings Plan) is 160.80 CNY, and the Deducted Amount is 127.41 CNY.
Usage = 127.41 / 160.80 = 79.24%. A usage rate of 79.24% means that while the savings plan is effective, about 20% of your commitment is wasted. To increase this rate and maximize value, adjust your resource usage.
You can query your savings plan usage in the following ways:
Console
-
Log on to the Expenses and Costs console. In the left-side navigation pane, choose Account > Savings Plan.
-
Click the Usage tab. You can view usage data by Time Dimension or by setting Filters.
-
Time Dimension: You can query data by hour, day, or month. Hourly data is available for the last 30 days, daily data for the last 90 days, and monthly data for the last 18 months.
-
Filters: Use criteria like type and region to view the usage of specific instances.
-
Query by Budget: You can create a Usage or coverage budget in Budget Management and query usage data based on the budget. For more information, see Budget Management.
-
-
After you set the search conditions, the page displays aggregate data such as Expected Amount, Total Amount (Savings Plan), and Saved Amount. Below the aggregate data, you can view the Usage (%) trend and the Usage Details to help you analyze the overall usage status.
OpenAPI
You can use the following API operations to query usage.
|
API operation |
Description |
|
Queries aggregate usage of savings plans. |
|
|
Queries the usage details of savings plans. |
Usage report data is finalized two days (T+2) after the billing cycle. Data queried before this time is continuously updated and may be incomplete due to billing delays. The data is for reference only and should not be used for reconciliation.
The Usage tab does not support querying total-amount savings plans. You can view the usage of a total-amount savings plan on the Overview page.
Query savings plan coverage
Coverage is the percentage of your pay-as-you-go costs covered by a savings plan. A higher coverage rate indicates that the savings plan is more effective at reducing your costs.
Formula: Savings plan coverage = Deducted Amount / Total spend on eligible resources, where:
-
Deducted Amount: The pay-as-you-go amount that is offset by the savings plan.
-
Total spend on eligible resources: The sum of the plan's total amount and any pay-as-you-go overage charges.
Example
A user purchases a 3-year, all-upfront, general-purpose savings plan. From October 1, 2025, to December 31, 2025, the Deducted Amount is 1.23 CNY, and the total spend is 1.23 CNY.
Coverage = 1.23 / 1.23 = 100%. This indicates the savings plan fully covered your pay-as-you-go costs, achieving maximum savings.
You can query your savings plan coverage in the following ways:
Console
-
Log on to the Expenses and Costs console. In the left-side navigation pane, choose Account > Savings Plan.
-
Click the Coverage tab. You can view coverage data based on the following conditions or by setting Filters.
-
Time Dimension: You can query data by hour, day, or month. Hourly data is available for the last 30 days, daily data for the last 90 days, and monthly data for the last 18 months.
-
Filters: View the coverage of specific instances. You can search by criteria such as product, type, and region.
-
Query by Budget: You can create a Usage or coverage budget in Budget Management and query coverage data based on the budget. For more information, see Budget Management.
-
By shared account: If you share savings plans, you can select a specific account to view its portion of the coverage.
-
-
After you set the search conditions, the page displays aggregate data such as Total Coverage (%) and Deducted Amount. Below the aggregate data, you can view the Coverage Rate trend and the Coverage Details.
In the Filters panel on the right, set Query by Budget, Time Dimension (daily only), and Filters (Product Detail, Owner Account, Region, Instance Type, and Tag).
OpenAPI
You can use the following API operations to query coverage.
|
API operation |
Description |
|
Queries aggregate coverage of savings plans. |
|
|
Queries the coverage details of savings plans. |
Coverage data is finalized two days (T+2) after the billing cycle.
The Coverage tab does not support querying total-amount savings plans. You can view the coverage of a total-amount savings plan on the Overview page.
Savings plan optimization
Analyze usage and coverage to optimize your savings plan.
|
Usage |
Coverage |
Analysis |
Action |
|
High |
High |
Your commitment is correctly sized and provides significant savings. |
Maintain the current configuration and review it periodically. |
|
High |
Low |
The plan is fully utilized, but significant pay-as-you-go spending remains uncovered. |
Increase your savings plan commitment to cover more spending and further reduce costs. |
|
Low |
High |
Your commitment exceeds your actual spending. The plan is underutilized. |
Reduce the savings plan commitment or switch to a plan type that better fits your usage. |
|
Low |
Low |
A mismatch between your resource usage and the plan's scope wastes your commitment and causes missed savings. |
Adjust your resource usage strategy and instance types to prioritize offsetting pay-as-you-go bills with your savings plan. |
For workloads that use Auto Scaling, 100% coverage is often not the most cost-effective target. Use the Savings Plan Purchase Recommendation tool to find the right balance between coverage and usage for elastic workloads.