What Traversal reads
- Entities and topology: host, service, process, and application entities, plus their dependency relationships
- Problems: Davis-detected problems and their evidence
- Metrics: time-series data and dimensional metadata
- Events: deployment events and other point-in-time signals
- Logs: classic log queries and Grail (DQL) log queries
- Spans and traces: APM spans and trace context
- Settings: read-only access to configuration objects, such as anomaly-detection rules
Authentication
Traversal talks to Dynatrace through two API surfaces. You can connect either one or both.Pick what fits your tenant:
- Dynatrace Managed or self-hosted: Classic API only. Grail is SaaS-only.
- SaaS, Grail-only: OAuth client only. Problems and entities are still reachable through DQL.
- SaaS, mid-migration or using both surfaces: provide both. Traversal routes each query to the surface that owns the data.
Setup
1
Create a Classic API token
Skip this step if you’re connecting only Grail.In Dynatrace, open Settings → Integration → Dynatrace API → Generate token and name the token (for example, Click Generate token and copy the token. Dynatrace shows it only once.Note your Classic Environment URL in the format
traversal). Then choose the read-only scopes to grant. Traversal uses whichever scopes the token carries, so grant the scopes for the data you want available during investigations.Minimum:Recommended additions (grant whichever your security policy allows):
entities.read alone is enough to connect, but Traversal has nothing else to read until you grant the scopes for the other data types.https://<env-id>.live.dynatrace.com. The environment ID is the subdomain of your Dynatrace UI URL.For Dynatrace Managed deployments, the URL format is
https://<your-domain>/e/<env-id>. Traversal supports both.2
Create a Platform OAuth client
Skip this step if you’re connecting only the Classic API.In Dynatrace, open Account Management → Identity & access management → OAuth clients → Create client. Name the client (for example, Click Create client and copy the Client ID, Client secret, and Account URN. The secret is shown only once.Note your Platform URL in the format
traversal) and choose which storage scopes to grant. Traversal queries whichever data types the client can read, so grant the storage scopes for the signals you want available during investigations.Minimum:Recommended additions (grant whichever your security policy allows):
Traversal can’t read any data from Grail until you grant the relevant
storage:*:read scopes.https://<env-id>.apps.dynatrace.com. The environment ID is the same as in your Classic URL. Only the host suffix differs (.apps. instead of .live.).3
Configure in Traversal
Go to Integrations, select Dynatrace, and fill in the section for each surface you’re connecting.Classic API
- Classic Environment URL: for example,
https://abc12345.live.dynatrace.com - API Token: the
dt0c01...token you generated for the Classic API
- Platform URL: for example,
https://abc12345.apps.dynatrace.com - OAuth Client ID: starts with
dt0s02. - OAuth Client Secret: the secret you copied
- Account URN: format
urn:dtaccount:<uuid>, found in Account Management → Overview
Private network access
If the service endpoint isn’t directly reachable by Traversal (as is common with self-hosted services), deploy a Traversal Connector in a network that can reach it. When configuring the integration, select that connector under Network Access Needed. The service endpoint doesn’t need public internet exposure. See Set up the Traversal Connector for deployment and network requirements.Troubleshooting
- Classic connection fails with an
entities.readpermission error.entities.readis the only scope required to connect. Other scopes are needed only for the corresponding queries. Regenerate the token withentities.readgranted. - Integration saves but a specific Dynatrace query returns “no data” or a permission error. The corresponding scope is likely missing on the token (Classic) or OAuth client (Grail). Add the scope from the tables above and re-save the integration.
- Classic URL pasted on the Platform host, or the reverse. Traversal rejects URLs that mix the two surfaces. Use
*.live.dynatrace.comfor Classic and*.apps.dynatrace.comfor Grail. - Grail OAuth connection fails with an SSO error. Check the Client ID, Client Secret, and Account URN. The Account URN uses the format
urn:dtaccount:<uuid>from your Dynatrace Account Management page. It isn’t the environment ID.