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 notifications in the causely-values.yaml file.

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

mediator:
  notifications:
    enabled: true

You can define a Grafana Alertmanager notification integration through the Causely UI, or by creating a secret in your Kubernetes cluster, in the causely namespace:

apiVersion: v1
kind: Secret
type: Opaque
metadata:
  name: grafana-notification-config
  namespace: causely
  labels:
    causely.ai/notif-config: AlertManager
data:
  notif_config_name: grafana
  notif_config_global: false
  notif_config_token: "user:password"
  notif_config_type: AlertManager
  notif_config_url: https://alertmanager-prod-us-east-0.grafana.net/alertmanager/api/v2/alerts
  notif_config_filters: []
  notif_config_filters_enabled: true
note

Replace the placeholder values with your actual Alertmanager URL in the "notif_config_url" field and optional credentials in the "notif_config_token" field

If you're using Grafana Cloud, refer to your instance's alerting endpoint.

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.