Skip to main content

Grafana Alertmanager

Causely can send causal insights directly to your existing Grafana Alertmanager setup, allowing your team to respond quickly with actionable context. This integration enables you to route high-signal alerts into your existing alerting workflows, no additional rules or duplication needed.

Grafana 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.
    Grafana Alertmanager is used purely as a delivery destination, allowing you to route high-signal alerts into existing Alertmanager workflows without duplicating rules.

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

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

Mediator-based Configuration​

If you would like to configure the Grafana Alertmanager integration, you can do so by enabling the executor and specifying your Alertmanager URL and optional authentication in the causely-values.yaml file.

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

executor:
  enabled: true

notifications:
  alertmanager:
    enabled: true
    url: 'https://alertmanager-prod-us-east-0.grafana.net/alertmanager/api/v2/alerts' # Replace with your actual Grafana alert endpoint (cloud or self-hosted)
    auth: 'user:password'
note

Replace the placeholder values with your actual Alertmanager URL and optional credentials.

If you're using Grafana Cloud, refer to your instance's alerting endpoint. This integration expects a webhook-compatible URL where Causely can post causal insights.

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​

For details on the structure and fields included in Causely webhook alerts, including what will be sent to Alertmanager, refer to the Notification Payload Format page.

It includes a sample payload and field-by-field breakdown to help you parse and route alerts effectively.