Network Performance Monitoring is now generally available! Network Monitoring is now available!


A Datadog metric is defined by the properties below. Refer to the Metrics Introduction documentation to learn how to graph metrics within Datadog.

<METRIC_NAME>The name of your metric.
<METRIC_VALUE>The value of your metric.
<TIMESTAMP>The timestamp associated with the metric value. Note: Metric timestamps cannot be more than 10 minutes in the future or more than 1 hour in the past.
<CONTEXT>The set of tags associated with your metric.
<METRIC_TYPE>The type of your metric. See the metric type documentation.
<INTERVAL>If the <TYPE> of the metric is RATE or COUNT, it defines the corresponding interval.

If a metric is not submitted from one of the 350+ Datadog integrations, it’s considered a Custom Metric. Note: Some standard integrations emit custom metrics.

Naming metrics

Follow these rules for naming metrics:

  • Must start with a letter.
  • Must only contain ASCII alphanumerics, underscores, and periods.
    • Other characters, including spaces, are converted to underscores.
    • Unicode is not supported.
  • Must not exceed 200 characters. Fewer than 100 is preferred from a UI perspective.

Metrics reported by the Agent are in a pseudo-hierarchical dotted format (e.g. http.nginx.response_time). The hierarchy is neither enforced nor interpreted, but it can be used to infer things about servers. For example, if hostA and hostB are both reporting http.nginx.* those must be web frontends.

Note: Metric names are case sensitive in Datadog.

Submitting metrics

There are multiple ways to send metrics to Datadog:

You can also use one of the Datadog-official and community contributed API and DogStatsD client libraries to submit your metrics

Further reading