Skip to main content

Prometheus Alertmanager

Causely can send enriched causal insights directly to your existing Prometheus Alertmanager. This lets you keep using your current alerting pipeline while gaining deeper visibility into what's actually going wrong.

By routing causal insights from Causely to Alertmanager, your team can receive high-signal notifications that include context like impacted services, severity, and SLO relevance—without needing to define new Prometheus alert rules.

Prometheus Alertmanager can be used as a notification destination in Causely.
How you configure this integration depends on how notifications are managed in your environment.

Causely supports two configuration paths:

  • Managed Notifications (recommended)
    Routing rules are configured in the Causely UI based on impact, severity, and context.
    Prometheus Alertmanager is used purely as a delivery destination, allowing you to inject high-signal causal insights into your existing Alertmanager pipeline without duplicating Prometheus alert rules.

  • Mediator-based Notifications (advanced)
    Notifications are configured programmatically using the Causely Mediator and sent directly to your Prometheus Alertmanager webhook endpoint.

Routing and notification rules for Managed Notifications are configured in the Causely UI: Set up notification routing in the UI

Mediator-based Configuration​

To enable the Prometheus Alertmanager integration, update your causely-values.yaml file to include the executor, your Alertmanager webhook URL and optional authentication.

For example, add the following in your causely-values.yaml file like this:

executor:
  enabled: true

notifications:
  alertmanager:
    enabled: true
    url: 'http://your-alertmanager-url/api/v2/alerts' # Replace with your actual Alertmanager URL
    auth: 'user:password' # Optional
note

Replace the placeholder values with your actual Alertmanager URL and any authentication credentials you use.

To install the Causely agent with the Alertmanager integration enabled, run:

causely agent install --cluster-name <cluster-name> --values ./causely-values.yaml

Notification Payload Format​

Causely sends structured alert payloads to Alertmanager, including service-level impact and diagnostic summaries. For an example and explanation of each field, refer to the Notification Payload Format page.