Metrics API - POST ingest data points

Pushes custom data points to Dynatrace.

Provided data points must follow the Metrics ingestion protocol. You don't have to register the metric first. After Dynatrace has ingested and processed the data, you can use it just like any other metrics in Dynatrace, such as in charts or metric events.

To view datapoints of the ingested metric, you can use:

The request consumes a plain/text payload. The payload is limited to 1,000 lines.

POST
  • Managed https://{your-domain}/e/{your-environment-id}/api/v2/metrics/ingest
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/v2/metrics/ingest
  • Environment ActiveGate https://{your-activegate-domain}/e/{your-environment-id}/api/v2/metrics/ingest

Authentication

To execute this request, you need the Ingest metrics (metrics.ingest) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.

Parameters

Parameter Type Description In Required
body

Data points, provided in the line protocol. Each line represents a single data point.

body optional

Response

Response codes

Code Description
202

The provided metric data points are accepted and will be processed in the background.

400

Some data points are invalid. Valid data points are accepted and will be processed in the background.

Response body

A successful request doesn't return any content.

Example

With this curl command, you'll ingest the cpu.temperature metric assigned to the HOST-06F288EE2A930951 dimension.

curl -L -X POST 'https://mySampleEnv.live.dynatrace.com/api/v2/metrics/ingest' \
-H 'Authorization: Api-Token abcdefjhij1234567890' \
-H 'Content-Type: text/plain' \
--data-raw 'cpu.temperature,dt.entity.host=HOST-06F288EE2A930951,cpu=1 55'