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.

All Grafana Alertmanager delivery runs through the Causely Mediator.

How you define Grafana Alertmanager destinations depends on your setup:

  • Managed Notifications (recommended)
    Routing rules and Alertmanager credentials are configured in the Causely UI. The UI stores configuration that the Mediator reads at runtime.

  • Mediator-based configuration (advanced)
    Define Alertmanager destinations programmatically with environment variables or Kubernetes secrets instead of the UI. Uses the same Mediator delivery path as managed notifications.

For routing rules and filters in the UI, see Set up notification routing in the UI.

Mediator-based configuration (advanced)​

If you prefer not to use the UI, define Grafana Alertmanager destinations with a Kubernetes secret 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.

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.