> ## 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.

# Alertmanager

> Connect Alertmanager to query active and historical alerts during investigations.

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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Configure in Traversal">
    Go to **Company Knowledge > Integrations**, select Alertmanager, and enter the URL, optional token, and optional organization ID.
  </Step>
</Steps>

## More information

* [Find the Alertmanager HTTP URL in Grafana](https://grafana.com/docs/grafana/latest/datasources/alertmanager/)