Документация Grafana Документация GlaberGraph Источники данных Alertmanager

Источник данных Alertmanager

Grafana включает встроенную поддержку реализаций Alertmanager в Prometheus и Grafana Mimir. После добавления источника данных Alertmanager вы можете использовать выпадающий список Choose Alertmanager в Grafana Alerting для просмотра и управления ресурсами Alertmanager, такими как silences, contact points и notification policies. Вы также можете включить Alertmanager, чтобы он принимал оповещения, управляемые Grafana.

Реализации Alertmanager

Источник данных поддерживает следующие реализации Alertmanager. Реализацию можно указать на странице Settings источника данных.

При использовании реализации Prometheus вы можете управлять silences в интерфейсе Grafana Alerting. Contact points, notification policies и templates доступны только для чтения, поскольку Prometheus Alertmanager API не поддерживает операции записи для этих ресурсов.

Настройка источника данных

Чтобы добавить и настроить источник данных Alertmanager, выполните следующие шаги:

Аутентификация

Источник данных поддерживает все стандартные методы HTTP-аутентификации Grafana, включая basic auth и TLS. Если аутентификация SigV4 включена глобально в Grafana, она также доступна для этого источника данных.

Дополнительные сведения о параметрах аутентификации и настройках подключения см. в разделе Data source management.

Проверка подключения

Нажмите Save & test, чтобы проверить подключение. При успешном подключении возвращается Health check passed.

Provisioning источника данных

Вы можете выполнять provisioning источников данных Alertmanager с помощью файлов конфигурации или Terraform.

Поля jsonData, используемые в обоих методах:

Файл конфигурации

Дополнительные сведения см. в разделе Provisioning data sources.

YAML Copy

apiVersion: 1

datasources:
  - name: Alertmanager
    type: alertmanager
    url: http://localhost:9093
    access: proxy
    jsonData:
      implementation: prometheus
      handleGrafanaManagedAlerts: false
    basicAuth: true
    basicAuthUser: <USERNAME>
    secureJsonData:
      basicAuthPassword: <PASSWORD>

Terraform

Чтобы выполнить provisioning источника данных с помощью Terraform, используйте ресурс grafana_data_source:

hcl Copy

resource "grafana_data_source" "alertmanager" {
  name = "Alertmanager"
  type = "alertmanager"
  url  = "http://localhost:9093"

  json_data_encoded = jsonencode({
    implementation            = "prometheus"
    handleGrafanaManagedAlerts = false
  })
}

Со всеми доступными параметрами конфигурации можно ознакомиться в документации по ресурсу источника данных провайдера Grafana.

Устранение неполадок источника данных Alertmanager

В этом разделе описаны распространённые проблемы при настройке или использовании источника данных Alertmanager.

“Health check failed.”

Симптомы:

• Save & test возвращает Health check failed.
• URL Alertmanager может быть недоступен или возвращать неожиданный ответ.

Возможные причины и решения:

“It looks like you have chosen Prometheus implementation, but detected a Mimir or Cortex endpoint.”

Симптомы:

• Save & test завершается с этим сообщением, когда для Alertmanager Implementation задано значение Prometheus.

Решение:

Введённый URL является endpoint Alertmanager Mimir или Cortex, а не Prometheus. Измените Alertmanager Implementation на Mimir или Cortex и снова нажмите Save & test.

“It looks like you have chosen a Mimir or Cortex implementation, but detected a Prometheus endpoint.”

Симптомы:

• Save & test завершается с этим сообщением, когда для Alertmanager Implementation задано значение Mimir или Cortex.

Решение:

Введённый URL является endpoint Prometheus Alertmanager. Измените Alertmanager Implementation на Prometheus и снова нажмите Save & test.

Оповещения, управляемые Grafana, не принимаются

Симптомы:

• Экземпляры оповещений, управляемые Grafana, не появляются в этом Alertmanager.
• Переключатель Receive Grafana Alerts включён в настройках источника данных, но оповещения не поступают.

Решение:

Одного включения Receive Grafana Alerts в источнике данных недостаточно. Также необходимо включить пересылку оповещений в Alerting > Administration в интерфейсе Grafana. Обе настройки должны быть включены, чтобы оповещения, управляемые Grafana, пересылались в этот Alertmanager.

Contact points и notification policies доступны только для чтения

Симптомы:

• Вы можете просматривать, но не редактировать contact points, notification policies или templates в интерфейсе Grafana Alerting.

Причина:

Вы используете реализацию Prometheus. Prometheus Alertmanager API не поддерживает операции записи для этих ресурсов.

Решение:

Если вам нужен полный доступ на чтение и запись к contact points и notification policies, переключитесь на Alertmanager Mimir или Cortex и обновите настройку Alertmanager Implementation.

Связанные ресурсы

• Grafana Alerting
• Configure external Alertmanagers
• Prometheus Alertmanager documentation
• Grafana Mimir documentation
• Grafana community forums