Skip to main content
Connecting Loki allows Traversal to query and analyze logs from your Grafana Loki instance during incident investigations.

​
What Traversal reads

  • Logs — queried via LogQL against your log streams
  • Labels — stream label names and values used to scope queries to the right services

​
Setup

Use this if Traversal or a Traversal Connector can reach your Loki instance directly and you want to connect to it independently of Grafana.
1

Find your Loki URL

Use your Loki server’s base URL, e.g. https://loki.yourcompany.com.For a private or cluster-internal address, route requests through a Traversal Connector that can reach it. You can also use the Grafana proxy path.
2

Configure authentication (if required)

If your Loki instance requires authentication, provide an API token. Leave blank if your instance is unauthenticated.
3

Note your org ID (multi-tenant only)

If your Loki deployment uses multi-tenancy, find your tenant/org ID. Traversal sends it as the X-Scope-OrgID header on every request.
4

Configure in Traversal

Go to Company Knowledge → Integrations, select Loki, and enter:
  • Loki URL
  • API token (optional)
  • Organization ID (optional, for multi-tenant deployments only)

​
More information