Skip to content

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.

Metrics home

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

  1. Navigate to Settings > Usage & Plans > Metric Data.
  2. The Usage Analysis tab opens by default.
  3. 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

labels tab

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.