Ingestion APIs

Latest Dynatrace
Reference
5-min read

In this article, you can find reference material on the most important information, such as the endpoint URL, the access type, and required Token scopes, for each API you can leverage to ingest data types in the Dynatrace Platform.

Request query parameters

Each request query parameter becomes a top-level record attribute. If there is a pre-existing attribute in the payload with the same name, the attribute from the query parameter overrides the pre-existing attribute value. An overridden original value is preserved in a new field with name syntax overwritten<index>.<original field name>, for example, overwritten1.myField.

Logs

To get started ingesting logs in the Dynatrace platform, see Log ingestion. For more information on licensing, see DDUs for Log Management and Analytics or Log Management and Analytics overview (DPS).

Log Monitoring API

Pushes custom logs to Dynatrace.

Endpoint URL	`https://{your-environment-id}.live.dynatrace.com/api/v2/logs/ingest`
Endpoint URL	`https://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/logs/ingest`
Method	POST
Authentication	Access token
Token scope	Ingest logs (`logs.ingest`)
Payload	`text/plain` `application/json`

OTLP ingest API

Pushes custom logs to Dynatrace.

Endpoint URL	`https://{your-environment-id}.live.dynatrace.com/api/v2/otlp/v1/logs`
Method	POST
Authentication	Access token
Token scope	Ingest logs (`logs.ingest`)
Payload	`application/x-protobuf`

Metrics

To get started ingesting metrics in the Dynatrace platform, see Quick start guide. For more information on licensing, see Metrics powered by Grail overview (DPS).

Metrics API

Pushes custom data points to Dynatrace.

Endpoint URL	`https://{your-environment-id}.live.dynatrace.com/api/v2/metrics/ingest`
Method	POST
Authentication	Access token
Token scope	Ingest metrics (`metrics.ingest`)
Payload	`text/plain`

OpenTelemetry metrics ingest API

Ingests OpenTelemetry metrics into Dynatrace.

Endpoint URL	`https://{your-environment-id}.live.dynatrace.com/api/v2/otlp/v1/metrics`
Method	POST
Authentication	Access token
Token scope	Ingest metrics (`metrics.ingest`)
Payload	`application/x-protobuf`

Spans

To get started ingesting spans in the Dynatrace platform, see Distributed Tracing. For more information on licensing, see https://dt-url.net/wt03q1d.

OpenTelemetry trace ingest API

Ingests OpenTelemetry traces to Dynatrace.

Endpoint URL	`https://{your-environment-id}.live.dynatrace.com/api/v2/otlp/v1/traces`
Method	POST
Authentication	Access token
Token scope	Ingest OpenTelemetry traces (`openTelemetryTrace.ingest`)
Payload	`application/x-protobuf`

Events

For more information on licensing, see Events powered by Grail overview (DPS).

Generic events

To get started ingesting generic events in the Dynatrace platform, see How to ingest data (events).

OpenPipeline Ingest API - POST Built-in generic events

Ingests generic events from built-in endpoints.

Endpoint URL	`https://{your-environment-id}.live.dynatrace.com/platform/ingest/v1/events`
Method	POST
Authentication	Access token
Token scope	OpenPipeline - Ingest Events (`openpipeline.events`)
Payload	`application/json`

OpenPipeline Ingest API - POST Custom generic events

Configures custom endpoints to ingest generic events.

Endpoint URL	`https://{your-environment-id}.live.dynatrace.com/platform/ingest/custom/events`
Method	POST
Authentication	Access token
Token scope	OpenPipeline - Ingest Events (Custom) (`openpipeline.events.custom`)
Payload	`application/json`

Davis events

To get started ingesting Davis events in the Dynatrace platform, see How to ingest data (events).

Events API v2 - POST an event

Ingests a custom event to Dynatrace.

Endpoint URL	`https://{your-environment-id}.live.dynatrace.com/api/v2/events/ingest`
Method	POST
Authentication	Access token
Token scope	Ingest Events (`events.ingest`)
Payload	`application/json`

SDLC events

To get started ingesting Software Development Lifecycle (SDLC) events in the Dynatrace platform, see Ingest SDLC events.

OpenPipeline Ingest API - POST Built-in SDLC events

Ingests SDLC events from built-in endpoints.

Endpoint URL	`https://{your-environment-id}.live.dynatrace.com/platform/ingest/v1/events.sdlc`
Method	POST
Authentication	Access token
Token scope	OpenPipeline - Ingest Events, Security Development Lifecycle (`openpipeline.sdlc`)
Payload	`application/json`

OpenPipeline Ingest API - POST Custom SDLC events

Configures custom endpoints to ingest SDLC events. For details, see Ingest SDLC events.

Endpoint URL	`https://{your-environment-id}.live.dynatrace.com/platform/ingest/custom/events.sdlc`
Method	POST
Authentication	Access token
Token scope	OpenPipeline - Ingest Events, Security Development Lifecycle (Custom) (`openpipeline.sdlc.custom`)
Payload	`application/json`

Security events (new)

To get started ingesting security events in the Dynatrace platform, see Security events ingest.

Migrate by September 2025

The endpoints events.security are planned to be deprecated. Migrate your configurations to security.events endpoints by end of September 2025. The previous endpoints will remain available until the migration is complete.

For a full overview of what's changing and step-by-step guidance on how to migrate, follow the instructions in the Grail security table migration guide.

OpenPipeline Ingest API - POST Built-in security events (new)

Ingests security events from built-in endpoints.

Endpoint URL	`https://{your-environment-id}.live.dynatrace.com/platform/ingest/v1/security.events`
Method	POST
Authentication	Access token
Token scope	OpenPipeline - Ingest Security Events (Built-in) (`openpipeline.events_security`)
Payload	`application/json`

OpenPipeline Ingest API - POST Custom security events (new)

Configures custom endpoints to ingest security events. For details, see Ingest custom security events via API.

Endpoint URL	`https://{your-environment-id}.live.dynatrace.com/platform/ingest/custom/security.events`
Method	POST
Authentication	Access token
Token scope	OpenPipeline - Ingest Security Events (Custom) (`openpipeline.events_security.custom`)
Payload	`application/json`

Events—Security events (legacy)

OpenPipeline Ingest API - POST Built-in security events (legacy)