Skip to content

Dynatrace

Dynatrace problem notification webhooks POST JSON to Exhale. Each tenant gets a unique HTTPS URL token. Exhale scrubs the payload, upserts a Pulse (source=dynatrace), and runs triage when the problem state maps to OPEN / similar.

See Incoming integrations for how Dynatrace fits alongside PagerDuty, New Relic, and Manual webhook.

OpenAPI: POST /webhooks/dynatrace (header token) and POST /webhooks/dynatrace/{token}.


Endpoint

After Connect in Connections → IntegrationsObservability & alertsDynatrace:

Preferred (keeps tokens out of proxy access logs):

POST https://exhale.kolstromsystems.com/webhooks/dynatrace

Send header X-Exhale-Webhook-Token: {token}.

Path form (also supported):

POST https://exhale.kolstromsystems.com/webhooks/dynatrace/{token}

Design partners may substitute https://exhale-staging.kolstromsystems.com as the host.

  • token — opaque URL segment; this token authenticates the delivery.
  • Response: 202 Accepted with pulse_id, status, created, and message.

Unknown tokens return 404. Disabled or expired-trial tenants return 403.


Customer setup

  1. Sign in as adminConnections → IntegrationsDynatrace.
  2. Click Connect Dynatrace and copy the webhook URL.
  3. In Dynatrace, open Problem notifications, add a custom webhook integration, and paste the Exhale URL.
  4. Include PID and State in the custom payload (Dynatrace placeholders such as {PID} / {State}).
  5. Send test alert creates a synthetic pulse and marks the integration configured.

Rotate webhook token invalidates the previous URL immediately — update Dynatrace after rotating.


Payload shape

FieldRequiredNotes
PIDYesStable id for dedupe (source=dynatrace)
StateNoOPEN, CLOSED, …
ProblemTitleNoPulse title

Lifecycle mapping

Dynatrace statePulse status
OPEN, OPENED, NEW, activeReceived → triage
CLOSED, RESOLVED, MERGEDResolved

Example

bash
TOKEN="your-url-token"
curl -i -X POST "https://exhale.kolstromsystems.com/webhooks/dynatrace/${TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"PID":"P-1","State":"OPEN","ProblemTitle":"High CPU"}'

Full detail (dedupe, fixtures, security): Dynatrace webhooks in the repository wiki. Planning track: Observability ingest v2.

Exhale by Kolstrom Systems LLC