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:
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:
There are two buttons that allow you to configure multiple metrics at a time:
Click on any metric name to display its details sidepanel for more information regarding the metric’s metadata and tags:
The name of your metric in the Metrics Explorer, dashboards, etc.
A metric name may emit multiple ingested custom metrics depending on its associated tag value combinations. Ingested custom metrics represent all of the data originally submitted with code.
Learn more in the custom metrics documentation.
Unlike ingested custom metrics, indexed custom metrics represent those that remain queryable across the Datadog platform. This number may be impacted by adding or removing percentile aggregations or by use of Metrics without Limits™. Learn more in the Metrics without Limits™ documentation.
The total number of hosts reporting a metric.
The total number of unique tag values attached to a metric.
The metadata attached to your metric. Most of the metadata can be edited on the metric summary page or with the Datadog API.
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 you hover over a metric. Formatting is automatically applied for readability. For example, bytes (B) may be displayed as kilobytes (KiB).
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.
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.
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.
The tags table offers multiple ways to explore all of the tag keys and tag values that are actively reporting in your metric’s data.
Use the tags table to:
For any particular tag key, you can:
key:value to further filter the list of metrics displayed on the Metrics Summary page.key:value pair in the Metrics Explorer.key:value for filtering across the application.Metrics without Limits* provides you control over the size of your custom metrics without requiring any agent or code-level changes.
Note: Metrics without Limits* is only available for custom metrics.
You can configure tags using the bulk metric tag configuration button or the Manage Tags button in a metric’s details side panel.
Note: The exclusion of tags is not supported in the allowlist-based customization of tags. Adding tags starting with ! is not accepted. Also, the cardinality estimator requires the metric to be older than 48 hours.
Once your metric has been configured with Metrics without Limits*, you can view which tags remain Queryable – ultimately those that contribute to Indexed Custom Metrics volume. And you can toggle back to all originally submitted and ingested tags that contribute to your Ingested Custom Metrics volume.
For custom metrics of the count, gauge, or rate metric type, you can further refine your metric’s configurations by optionally including additional aggregations with the advanced mode of Metrics without Limits*. By default, Datadog stores the most frequently queried aggregation combination depending on the metric’s type to preserve the mathematical accuracy of your configured metric’s query as listed below:
SUMAVGMore aggregations are available should they be valuable to you. You can add or remove aggregations at any time with no required Agent or code-level changes.
Note: Configuring your count, rate, or gauge metric and removing an aggregation may impact existing dashboards and monitors.
Additional helpful documentation, links, and articles:
