Metrics Reference

English | 简体中文

Metrics Reference

All business and target-scoped runtime metrics include target. Monetary series must never be aggregated across currency, provider, or cost_basis unless the query intentionally compares accounting views.

Cost metrics

Metric	Type	Additional labels	Meaning
aws_cost_daily_amount	gauge	provider,cost_basis,currency	Current UTC billing-day total
aws_cost_month_to_date_amount	gauge	provider,cost_basis,currency	Current UTC month-to-date total
aws_cost_service_daily_amount	gauge	provider,cost_basis,currency,aws_service	Daily cost by service
aws_cost_service_month_to_date_amount	gauge	provider,cost_basis,currency,aws_service	MTD cost by service
aws_cost_region_daily_amount	gauge	provider,cost_basis,currency,aws_region	Daily cost by region
aws_cost_region_month_to_date_amount	gauge	provider,cost_basis,currency,aws_region	MTD cost by region
aws_cost_account_daily_amount	gauge	provider,cost_basis,currency,linked_account_id	Daily cost by linked account
aws_cost_account_month_to_date_amount	gauge	provider,cost_basis,currency,linked_account_id	MTD cost by linked account
aws_cost_month_forecast_mean_amount	gauge	provider,cost_basis,currency	Remaining-month forecast mean, including today
aws_cost_month_forecast_lower_bound_amount	gauge	provider,cost_basis,currency	Remaining-month lower bound
aws_cost_month_forecast_upper_bound_amount	gauge	provider,cost_basis,currency	Remaining-month upper bound
aws_cost_account_info	gauge	linked_account_id,account_name,account_status	Non-sensitive Organizations metadata, value 1
aws_cost_tag_daily_amount	gauge	provider,cost_basis,currency,tag_key,tag_value	Daily allowlisted tag cost
aws_cost_tag_month_to_date_amount	gauge	provider,cost_basis,currency,tag_key,tag_value	MTD allowlisted tag cost

Commitment and anomaly metrics

Metric	Type	Labels
aws_commitment_utilization_ratio	gauge	target,commitment_type,time_unit
aws_commitment_coverage_ratio	gauge	target,commitment_type,time_unit
aws_commitment_unused_hours	gauge	target,commitment_type,time_unit
aws_commitment_covered_spend_amount	gauge	target,commitment_type,time_unit,currency
aws_commitment_on_demand_cost_amount	gauge	target,commitment_type,time_unit,currency
aws_commitment_net_savings_amount	gauge	target,commitment_type,time_unit,currency
aws_cost_anomaly_active	gauge	target
aws_cost_anomaly_count	gauge	target
aws_cost_anomaly_impact_amount	gauge	target,currency
aws_cost_anomaly_last_detected_timestamp_seconds	gauge	target

commitment_type is bounded to savings_plan and reservation. No plan, reservation, or anomaly identifier is exposed.

Budget metrics

All budget metrics use target,budget_name,currency,budget_type,time_unit:

• aws_budget_limit_amount
• aws_budget_actual_amount
• aws_budget_forecasted_amount

Only COST budgets are accepted. Missing actual or forecast data omits that series.

Exporter metrics

Metric	Type	Primary labels
aws_cost_exporter_collector_up	gauge	target,collector
aws_cost_exporter_last_success_timestamp_seconds	gauge	target,collector
aws_cost_exporter_last_attempt_timestamp_seconds	gauge	target,collector
aws_cost_exporter_cache_age_seconds	gauge	target,collector
aws_cost_exporter_snapshot_series	gauge	target,collector
aws_cost_exporter_refresh_total	counter	target,collector,status
aws_cost_exporter_refresh_duration_seconds	histogram	target,collector
aws_cost_exporter_aws_api_requests_total	counter	target,operation,status
aws_cost_exporter_aws_api_retries_total	counter	target,operation,reason
aws_cost_exporter_aws_api_request_duration_seconds	histogram	target,operation
aws_cost_exporter_scheduler_skipped_runs_total	counter	target,collector,reason
aws_cost_exporter_dimension_overflow_values_total	counter	target,dimension
aws_cost_exporter_pagination_pages_total	counter	target,operation
aws_cost_exporter_cache_publish_errors_total	counter	target,collector,operation
aws_cost_exporter_build_info	gauge	version,revision,go_version
aws_cost_exporter_scheduler_shutdown_timeouts_total	counter	process-global

operation, status, reason, collector, provider, basis, and commitment labels use bounded enums. Raw AWS errors and request IDs cannot become labels.

The logical request, successful page, and retry counters are related to AWS activity but are not interchangeable with AWS-billed HTTP attempts.