Skip to main content
Connecting Alertmanager allows Traversal to query active and historical alerts from your Alertmanager endpoint, including Grafana-managed Alertmanager deployments.

What Traversal reads

  • Alerts — active and grouped alerts via the Alertmanager API

Setup

1

Find your Alertmanager URL

Enter the base URL Traversal should send Alertmanager API requests to.If you already use Alertmanager in Grafana, go to Connections > Data sources > Alertmanager and copy the value in HTTP URL.Common examples:
  • https://alertmanager.example.com:9093
  • https://alertmanager-us-central1.grafana.net
Do not enter:
  • a Grafana dashboard URL
  • a full API path such as /api/v2/alerts or /api/v2/alerts/groups
If the Grafana data source is provisioned or Grafana is handling authentication for you, ask your administrator for the direct URL and credentials Traversal should use.
2

Configure authentication (if required)

If your endpoint requires authentication, enter a bearer token.Only set Organization ID if your deployment expects the X-Scope-OrgID header for multi-tenant access.
3

Configure in Traversal

Go to Company Knowledge > Integrations, select Alertmanager, and enter the URL, optional token, and optional organization ID.

Private network access

If the service endpoint is not 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 does not need public internet exposure. See Set up the Traversal Connector for deployment and network requirements.

More information