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 Export with OTLP.

The request consumes an application/x-protobuf payload.

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

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

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.