Fractal Techware

Alert runbooks /

AlertmanagerFailedToSendAlerts

Alertmanager is receiving alerts but a noticeable share of its notification attempts to one integration are failing.

   
Severity warning
Source Alertmanager’s own /metrics (0.25+)
Key metrics alertmanager_notifications_failed_total, alertmanager_notifications_total (label integration)

What it means

For every notification Alertmanager counts attempts and failures per integration (slack, pagerduty, email, webhook, opsgenie and so on). The alert fires when the failure ratio for an integration stays above a small fraction for several minutes.

Alertmanager retries, so some messages still get through late. But if failures are total for an integration, people routed only to that receiver are not being paged at all. Treat it as urgent if the failing integration is your paging path.

Common causes

First checks

  1. Identify the failing integration and instance:
    sum by (instance, integration) (rate(alertmanager_notifications_failed_total[5m]))
    
  2. Read the exact error, which includes the receiver name and HTTP status:
    kubectl -n monitoring logs <alertmanager-pod> -c alertmanager | grep -i "notify" | tail -n 20
    
  3. Test egress from inside the pod (if the image has a shell and wget):
    kubectl -n monitoring exec <alertmanager-pod> -c alertmanager -- wget -qO- -T 5 https://hooks.slack.com >/dev/null; echo $?
    
  4. Send a test alert end to end:
    amtool alert add TestNotification severity=warning \
      --alertmanager.url=http://<alertmanager>:9093
    
  5. Check the receiver config with amtool check-config if you recently changed credentials.

Fixing it

Rotate or restore the credential, fix egress (proxy settings in http_config, NetworkPolicy, CA bundle), or raise group_interval and grouping to reduce volume if you are rate limited. Keep a second, independent notification path for critical alerts.