Ingestion APIs

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.

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.

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/metrics`
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.

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`

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

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

OpenPipeline Ingest API - POST Built-in security events

Ingests security events from built-in endpoints.

Endpoint URL	`https://{your-environment-id}.live.dynatrace.com/platform/ingest/v1/events.security`
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

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/events.security`
Method	POST
Authentication	Access token
Token scope	OpenPipeline - Ingest Security Events (Custom) (`openpipeline.events_security.custom`)
Payload	`application/json`

Business events

To get started ingesting business events in the Dynatrace platform, see Ingest business events via API. For more information on licensing, see DDUs for business events.

Business events API

Captures business events in Dynatrace.

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