Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.traversal.com/llms.txt

Use this file to discover all available pages before exploring further.

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