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 your ingested metrics you must use the new Explorer.
You can also push the data points directly from a OneAgent-monitored host to the Extensions Execution Controller (EEC) OneAgent module over a secure channel using the local
http://localhost:<port>/metrics/ingest endpoint, which doesn't require token authentication. The default port is
14499. Using this method, the Dynatrace reserved
dt.entity.host=<host-ID> dimension is added to each metric. For more information, see OneAgent metric API. .
The request consumes a
plain/text payload. The payload is limited to
This request is an Early Adopter release and may be changed in non-compatible way.
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.
Data points, provided in the line protocol. Each line represents a single data point.
|202||The provided metric data points are accepted and will be processed in background.|
|400||Some data points are invalid. Valid data points are accepted and will be processed in background.|
A successful request doesn't return any content.
curl command, you'll ingest the
cpu.temperature metric assigned to the
curl -X POST --data-ascii "cpu.temperature,dt.entity.host=HOST-06F288EE2A930951,cpu=1 55" https://mySampleEnv.live.dynatrace.com/api/v2/metrics/ingest \ -H 'Authorization: Api-Token abcdefjhij1234567890' \ -H "Content-Type: text/plain; charset=utf-8" \