OpenTelemetry logs ingest API
Ingests OpenTelemetry logs 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.
| POST | SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/otlp/v1/logs |
| Environment ActiveGateCluster ActiveGate | https://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/otlp/v1/logs |
Authentication
To execute this request, you need an access token with logs.ingest scope.
To learn how to obtain and use it, see Tokens and authentication.
Parameters
When using log processing with the custom processing pipeline (OpenPipeline), ingest supports all JSON data types for attribute values. This requires SaaS version 1.295+ when using the SaaS API endpoint or ActiveGate version 1.295+ when using the ActiveGate API endpoint. In all other cases, all ingested values are converted to the string type.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| body | byte[] | An ExportLogsServiceRequest message in binary protobuf format. | body | required |
Response
Response codes
| Code | Type | Description |
|---|---|---|
| 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. |
| 500 | - | The request could not be processed due to an internal server error. |
| 503 | - | The service is currently unavailable. |
| 4XX | ErrorEnvelope | Client side error. |
| 5XX | ErrorEnvelope | Server side error. |