Metric Usage Analysis
The Metrics Usage Analyzer gives you a detailed view of your ingested metrics and labels. Use it to identify high-volume or high-cardinality metrics, understand ingestion patterns, detect inefficient time series, and optimize your data pipeline.
This tool works with pre-aggregated statistics updated from the ingestion pipeline. Variations, labels, and trends reflect real-time ingestion data.
By regularly using the Metrics Usage Analyzer, observability teams can:
- Detect wasteful or unused metrics
- Reduce cardinality
- Control ingestion volume
Open the Usage Analysis tab
- Navigate to Settings > Usage & Plans > Metric Data.
- The Usage Analysis tab opens by default.
- Use the three sub-tabs to explore:
- Metrics: Ingested metrics with usage, cardinality, and samples
- Labels: All labels attached to metrics
- Blocked: Metrics that have been blocked from ingestion
Review top-level usage
At the top of the Metrics sub-tab you will see:
- Total Metric Usage Units – Billing units generated by metrics
- Fraction of Total Usage – Share of total data attributed to metrics
Note
Metric usage is billed in units. Select Show in Data Usage to compare with the overall Data Usage dashboard.
Explore the Metrics table
The Metrics table lists usage details per metric. Key columns include:
- Usage: Data volume in GB and billing units
- % Usage: Share of total usage
- Samples: Total datapoints ingested
Note
Sample counts may differ from PromQL results because Coralogix applies a 15-second deduplication window.
- Dimensions – Unique label keys
- Variations – Unique combinations of label keys
- Cardinality – Unique time series per metric
- % Cardinality – Share of total series cardinality
Note
Variations reflect label set combinations. For example, (host, region)
vs (host, app, region)
.
Drill into a specific metric
Click a metric name to open detailed views:
- Time-based cardinality trends
- Metric usage per day (bytes ingested)
- Variation usage per day (bytes per variation)
- Label usage per day (bytes per label key)
- Variations with their usage statistics
- Labels and their cardinality impact
Block noisy or unused metrics
- In the Action column of the table, select Block to stop ingesting a metric.
Note
Blocking reduces both data volume and cost by preventing storage and queries of low-value metrics.
Unblock metrics when needed
- Open the Blocked tab.
- Select Unblock for any metrics you want to resume ingesting.
Investigate label usage
In the Labels tab, you can:
- Search for a specific label (for example,
task_id
) - View all metrics that use the label
- Investigate cardinality and value distribution for that label
Permissions
You must have the METRICS.DATA-ANALYTICS#HIGH:READ
permission to access this section. For more information, see Create Roles & Permissions.