Ingest SDLC events
Latest Dynatrace
You can configure external tools to send software development lifecycle (SDLC) events to Dynatrace via API.
This guide shows you how to ingest JSON data into Dynatrace using the events API and the POST method of the platform/ingest/v1/events.sdlc
endpoint.
Steps
Authenticate
The platform/ingest/v1/events.sdlc
endpoint uses access token authentication.
To generate an access token
- Go to Access Tokens.
- Select Generate new token.
- Enter a token name.
- Find and select the following scopes:
- OpenPipeline – Ingest Events, Software Development Lifecycle (openpipeline.events_sdlc)
- OpenPipeline – Ingest Events, Software Development Lifecycle (Custom) (openpipeline.events_sdlc.custom)
- Select Generate token.
- Select Copy and paste the token to a secure location because it's required in another step.
Copy the endpoint path and send an event
-
Copy the endpoint to the endpoint path:
https://{your-environment-id}.live.dynatrace.com/platform/ingest/v1/events.sdlc
. -
Run the following sample command to send an event to your environment endpoint
platform/ingest/v1/events.sdlc
via POST request.The sample command indicates a JSON content type and provides the JSON event data using the
-d
parameter. Make sure to substitute<your-endpoint-URL>
with the URL of the endpoint you copied.<your-API-token>
with the token you generated.
curl -i -X POST "<your-endpoint-URL>" \-H "Content-Type: application/json" \-H "Authorization: Api-Token <your-API-token>" \-d "{\"event.type\":\"test\", \"event.status\":\"finished\"}"Your request is successful if the output contains the 202 response code, for example
HTTP/2 202
Verify ingestion
To verify that your SDLC event has been ingested successfully, query it via DQL, for example, in Notebooks.
-
Go to Notebooks.
-
Choose or create a notebook.
-
Select > DQL to add a new section with a DQL query input field.
-
Enter the following DQL query:
fetch events| filter event.kind == "SDLC_EVENT"| filter event.type == "test"| filter event.status == "finished"