Skip to main content
Connecting Datadog lets Traversal use your logs, metrics, traces, and monitors during investigations so it can surface anomalies, correlate signals, and generate grounded root-cause explanations.

​
What Traversal reads

  • Logs — queried from your log indexes
  • Metrics — time-series data and tag metadata
  • Spans / Traces — APM span data
  • Incidents — active and historical incident records
  • Events — event stream data
  • Monitors — monitor state and alert history
  • Dashboards — dashboard panel definitions

​
Setup

1

Create an API key

The API key identifies your Datadog organization. In Datadog, go to:Organization Settings → API Keys → New KeyName it (e.g. traversal) and copy the value — it won’t be shown again.
2

Create an Application key

The application key authorizes API queries on behalf of a user. Go to:Organization Settings → Application Keys → New KeyName it (e.g. traversal) and copy the value — it won’t be shown again.
Create the application key under a dedicated read-only Datadog user.The key inherits that user’s permissions — no explicit scopes needed. Traversal will have read-only access to everything that user can see.
Recommended for most setups. Create a service user with the Datadog Read Only Role and generate the application key under that account.
3

Find your API URL

Your API URL is based on your Datadog site. To find it, look at your browser URL when logged in to Datadog and match it below:
Browser URLAPI URL to use
app.datadoghq.comhttps://api.datadoghq.com
us3.datadoghq.comhttps://api.us3.datadoghq.com
us5.datadoghq.comhttps://api.us5.datadoghq.com
app.datadoghq.euhttps://api.datadoghq.eu
ap1.datadoghq.comhttps://api.ap1.datadoghq.com
ap2.datadoghq.comhttps://api.ap2.datadoghq.com
app.ddog-gov.comhttps://api.ddog-gov.com
4

Configure in Traversal

Go to Company Knowledge → Integrations, select Datadog, and enter:
  • Datadog API URL
  • API key
  • Application key

​
More information