Metrics Summary

Metrics Summary


The Metrics Summary page displays a list of your metrics reported to Datadog under a specified time frame: the past hour, day, or week.

Search your metrics by name or tag using the Metric or Tag search fields:

Filter by Tag

Facet panel

The search bars provide the most comprehensive set of actions to filter the list of metrics. But facets can also quickly filter your metrics by:

  • Configuration : Quickly identify metrics with tag configurations or additional percentile aggregations
  • Metric Type : Quickly identify distributions vs non-distributions (counts, gauges, rates)
  • Distribution Metric Origin: Quickly identify which product the distribution metrics have originated from (for example, Generate Metrics from Logs, Generate Metrics from Spans, etc.)

Configuration of multiple metrics

There are two buttons that allow you to configure multiple metrics at a time:

  • Calculate Percentiles: Add percentile aggregations to multiple distribution metrics.
  • Configure Tags: Configure tags on multiple distribution metrics (Metrics without Limits™ beta users are able to use this functionality on counts, gauges, and rates as well).
Bulk Metric Tag Configuration

Metric details sidepanel

Click on any metric name to display its details sidepanel for more information regarding the metric’s metadata and tags:

Metric name

The name of your metric in the Metrics Explorer, dashboards, etc.

Distinct metrics reported

A metric name may emit multiple distinct metrics depending on its associated tag value combinations. This number varies with the timeframe chosen on the page.

Learn more in the custom metrics documentation.


The total number of hosts reporting a metric.

Tag values

The total number of unique tag values attached to a metric.

Learn more about tagging.

Metrics metadata

The metadata attached to your metric. Most of the metadata can be edited on the metric summary page or with the Datadog API.

Metric unit

The unit for your metric (byte, second, request, query, etc.). See the metric unit page for more details.

When submitting custom metrics to Datadog, it is possible to change the unit of measurement that displays when hovering over the metric in your graph. Note: This does not change how a metric graph is displayed—it only changes the units of measurement that raw values are considered as, when hovering over a metric. Formatting is automatically applied for readability. For example, bytes (B) may be displayed as kibibytes (KiB).

Metric type

The type for your metric (gauge, rate, count, distribution). See the metric type page for more details.

Warning: Editing the metric type changes that metric’s behavior for ALL your dashboards and monitors.

Integration name

If the metric is coming from a supported integration, the metadata lists the integration name. This information cannot be edited.


The collection interval for the metric in seconds.

Metric description

The metric description helps you understand what a metric does. Descriptions are pre-populated for metrics coming from supported integrations. Use this field to update the descriptions for your custom metrics.

Tags table

The tags table offers a variety of ways to explore all the tag keys and tag values that are actively reporting in your metric’s data.

Use the tags table to:

  • Sort tag keys by the Count column (count of unique tag values).
  • Search through the paginated table of tags for a particular tag key.
  • Export the tags table as a downloadable CSV.
  • Toggle between tags you’ve configured on your metric vs the metric’s originally submitted tags

For any particular tag key, you can:

  • Inspect all tag values of that tag key.
  • Use a specific tag key:value to further filter the list of metrics displayed on the Metrics Summary page.
  • Open a graph of this metric filtered by your tag key:value pair in the Metrics Explorer.
  • Copy any tag key:value for filtering across the application.
Tags Table

Learn more about tagging.

Further reading

Additional helpful documentation, links, and articles: