DAdatadog
Metrics

Get metric metadata

Get metadata about a specific metric.

get/api/v1/metrics/{metric_name}

Request

  • Base URL
    https://api.datadoghq.com
  • URL
    https://api.datadoghq.com/api/v1/metrics/{metric_name}
  • Auth
    • API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
    • or OAuth 2
      Authorization code: /oauth2/v1/authorize
      Token URL: /oauth2/v1/token scopes: metrics_read

Path parameters

metric_namestring required

Name of the metric for which to get metadata.

Response

OK

descriptionstring

Metric description.

integrationstring

Name of the integration that sent the metric if applicable.

per_unitstring

Per unit of the metric such as second in bytes per second.

short_namestring

A more human-readable and abbreviated version of the metric name.

statsd_intervalinteger

StatsD flush interval of the metric in seconds if applicable.

typestring

Metric type such as gauge or rate.

unitstring

Primary unit of the metric such as byte or operation.

Example response

{
  "per_unit": "second",
  "type": "count",
  "unit": "byte"
}

Changes

No recorded changes to this operation across all 1 revision of this API.