Metrics

Submit metrics

The metrics end-point allows you to post time-series data that can be graphed on Datadog’s dashboards. The maximum payload size is 3.2 megabytes (3200000 bytes). Compressed payloads must have a decompressed size of less than 62 megabytes (62914560 bytes).

If you’re submitting metrics directly to the Datadog API without using DogStatsD, expect:

  • 64 bits for the timestamp
  • 64 bits for the value
  • 40 bytes for the metric names
  • 50 bytes for the timeseries
  • The full payload is approximately 100 bytes. However, with the DogStatsD API, compression is applied, which reduces the payload size.
post/api/v1/series

Request

  • Base URL
    https://api.datadoghq.com
  • URL
    https://api.datadoghq.com/api/v1/series
  • Auth
    API key in header DD-API-KEY

Headers

Content-Encoding'deflate' | 'gzip'

HTTP header used to compress the media-type.

Example:deflate

Request body text/json

Example request

{
  "series": [
    {
      "metric": "system.load.1",
      "points": [
        [
          1475317847,
          0.7
        ]
      ]
    }
  ]
}

Response

Payload accepted

Changes

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