Ingest API

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.

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

Events

To get started ingesting events in the Dynatrace platform, see How to ingest data (events). For more information on licensing, see Events powered by Grail.

Default API (built-in endpoints) for generic events

Captures events of the generic type in Dynatrace.

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

Default API (custom endpoints) for generic events

Captures events of the generic type in Dynatrace.

Endpoint URL	`https://{your-environment-id}.dynatrace.com/platform/ingest/custom/events`
Method	POST
Authentication	Access token
Token scope	OpenPipeline - Ingest Events (Custom) (`openpipeline.events.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}.apps.dynatrace.com/platform/classic/environment-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`