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 your Loki instance is publicly accessible 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.
If your Loki URL is a cluster-internal address (e.g. a Kubernetes service URL), it will not be reachable from Traversal. Use the Grafana proxy path instead.
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