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. You can also provide metadata for the ingested metric via the Settings API.
To view datapoints of the ingested metric, you can use:
- Data explorer
- GET metric data points request of the Metric v2 API.
The request consumes a text/plain
payload. The payload is limited to 1 MB.
POST | ManagedDynatrace for Government | 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 an access token with metrics.ingest
scope.
To learn how to obtain and use it, see Tokens and authentication.
Parameters
Parameter | Type | Description | In | Required |
---|---|---|---|---|
body | string | Data points, provided in the line protocol. Each line represents a single data point. | body | required |
Request body objects
The RequestBody
object
The object doesn't provide any parameters.
Response
Response codes
Code | Type | Description |
---|---|---|
202 | ValidationResponse | The provided metric data points are accepted and will be processed in the background. |
400 | ValidationResponse | Some data points are invalid. Valid data points are accepted and will be processed in the background. |
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 dt0c01.abc123.abcdefjhij1234567890' \
-H 'Content-Type: text/plain' \
--data-raw 'cpu.temperature,dt.entity.host=HOST-06F288EE2A930951,cpu=1 55'