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

Step 1 Authenticate

The platform/ingest/v1/events.sdlc endpoint uses access token authentication.

To generate an access token

  1. Go to Access Tokens.
  2. Select Generate new token.
  3. Enter a token name.
  4. 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)
  5. Select Generate token.
  6. Select Copy and paste the token to a secure location because it's required in another step.

Step 2 Copy the endpoint path and send an event

  1. Copy the endpoint to the endpoint path: https://{your-environment-id}.live.dynatrace.com/platform/ingest/v1/events.sdlc.

  2. 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

Step 3 Verify ingestion

To verify that your SDLC event has been ingested successfully, query it via DQL, for example, in Notebooks.

  1. Go to Notebooks.

  2. Choose or create a notebook.

  3. Select Add > DQL to add a new section with a DQL query input field.

  4. Enter the following DQL query:

    fetch events
    | filter event.kind == "SDLC_EVENT"
    | filter event.type == "test"
    | filter event.status == "finished"