Try it free

OpenTelemetry metrics ingest API

  • Reference
  • Published Sep 12, 2022

Ingests OpenTelemetry metrics into Dynatrace. Use this endpoint as a target for OpenTelemetry exporters. For more information, see Dynatrace OTLP API endpoints.

The request consumes an application/x-protobuf payload.

POSTSaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/otlp/v1/metrics
POSTEnvironment ActiveGateCluster ActiveGatehttps://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/otlp/v1/metrics

Authentication

Api-Token:

To execute this request, you need an access token with metrics.ingest scope.

To learn how to obtain and use it, see Personal access tokens.

Platform Token / OAuth:

Required scope: openpipeline:metrics:ingest

To learn how to obtain and use it, see Platform tokens or OAuth clients.

Parameters

ParameterTypeDescriptionInRequired
bodybyte[]An ExportMetricsServiceRequest message in binary protobuf format.bodyRequired

Response

Response codes

CodeTypeDescription
200-

The request has been received and will be processed.

400-

The request could not be processed. This may happen if the message is malformed.

413-

The OTLP message exceeded the payload size limit.

415-

The request was sent with an unsupported content type. This API supports requests in binary protobuf format with content type application/x-protobuf.

500-

The request could not be processed due to an internal server error.

503-

The service is currently unavailable. This may happen if the module is paused.

4XXErrorEnvelope

Client side error.

5XXErrorEnvelope

Server side error.

Related topics

  • Dynatrace OTLP API endpoints