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​

If you would like to configure the Prometheus 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: prometheus-notification-config
  namespace: causely
  labels:
    causely.ai/notif-config: AlertManager
data:
  notif_config_name: prometheus
  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

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.