Документация Grafana Документация GlaberGraph Источники данных Amazon CloudWatch Оповещения

Оповещения Amazon CloudWatch

Источник данных Amazon CloudWatch поддерживает Grafana Alerting. Вы можете создавать правила оповещений по метрикам CloudWatch и CloudWatch Logs, чтобы Grafana уведомляла вас, когда метрика пересекает пороговое значение или когда запрос к логам возвращает значение, удовлетворяющее условию оповещения.

Это Grafana Alerting, оцениваемый Grafana, а не CloudWatch alarms. Чтобы вместо этого визуализировать историю существующих CloudWatch alarms, см. раздел Аннотации Amazon CloudWatch.

Прежде чем начать

Прежде чем создавать правила оповещений с данными CloudWatch, убедитесь, что у вас есть:

• Настроенный источник данных Amazon CloudWatch.
• Разрешения на создание правил оповещений в Grafana.
• Знакомство с концепциями Grafana Alerting.

Поддерживаемые типы запросов для оповещений

Правила оповещений требуют запросов, возвращающих числовые данные, которые Grafana может сравнить с пороговым значением. CloudWatch поддерживает оповещения для следующих типов запросов:

Создание правила оповещения

Чтобы создать правило оповещения с использованием данных CloudWatch:

1. Перейдите в Alerting > Alert rules.
2. Нажмите New alert rule.
3. Введите имя для правила оповещения.
4. В разделе Define query and alert condition:
   • Выберите ваш источник данных Amazon CloudWatch.
   • Настройте запрос, например запрос Metrics для CPUUtilization или запрос Logs, использующий команду stats.
   • Добавьте выражение Reduce, если ваш запрос возвращает несколько рядов.
   • Добавьте выражение Threshold, чтобы определить условие оповещения.
5. Настройте раздел Set evaluation behavior:
   • Выберите или создайте папку и группу оценки.
   • Задайте интервал оценки.
   • Задайте период ожидания (pending period).
6. Добавьте метки (labels) и аннотации, чтобы обеспечить контекст для уведомлений.
7. Нажмите Save rule.

Подробные инструкции см. в разделе Create a Grafana-managed alert rule.

Пример: оповещение по порогу метрики

Этот пример срабатывает, когда средняя загрузка CPU EC2 превышает 80%:

1. Создайте новое правило оповещения.
2. Настройте запрос:
   • Namespace: AWS/EC2
   • Metric name: CPUUtilization
   • Statistic: Average
   • Dimensions: InstanceId
3. Добавьте выражения:
   • Reduce: Last, чтобы получить самую свежую точку данных.
   • Threshold: Is above 80.
4. Задайте оценку каждую 1 минуту с периодом ожидания 5 минут.
5. Сохраните правило.

Пример: оповещение по количеству ошибок в логах

Этот пример создаёт оповещение, когда количество записей логов, содержащих Exception, превышает порог. Для оповещений CloudWatch Logs требуется запрос, возвращающий числовые данные, которые можно получить с помощью команды stats:

1. Создайте новое правило оповещения.

2. Настройте запрос:

   • Выберите CloudWatch Logs в качестве режима запроса.

   • Выберите регион и группы логов для запроса.

   • Введите следующий запрос:

     Copy

     filter @message like /Exception/
         | stats count(*) as exceptionCount by bin(5m)

3. Добавьте выражения:

   • Reduce: Max, чтобы получить наибольшее количество за период.
   • Threshold: Is above 10.

4. Задайте оценку каждые 5 минут.

5. Сохраните правило.

Тайм-ауты CloudWatch Logs при оценке оповещений

Для запросов CloudWatch Logs Grafana опрашивает AWS до завершения запроса или достижения тайм-аута. Во время оценки оповещений тайм-аут, заданный в файле конфигурации Grafana, имеет приоритет над настройкой Query Result Timeout в источнике данных. Задайте тайм-аут конфигурации достаточно большим, чтобы ваши запросы к логам успевали завершиться.

Рекомендации

Следуйте этим рекомендациям, чтобы создавать надёжные оповещения с данными CloudWatch.

Тестируйте запросы перед настройкой оповещений

Убедитесь, что ваш запрос возвращает числовые данные, прежде чем создавать оповещение:

1. Перейдите в Explore.
2. Выберите ваш источник данных Amazon CloudWatch.
3. Выполните запрос, который планируете использовать для оповещений.
4. Убедитесь, что результат числовой и подходит для сравнения с порогом.

Свёртка нескольких рядов

Когда запрос возвращает несколько временных рядов, используйте выражение Reduce, чтобы свести их в одно значение с помощью Last, Mean, Max, Min или Sum.

Обработка условий отсутствия данных

Настройте поведение правила, когда данные не возвращаются, в разделе Configure no data and error handling. Выберите No Data, Alerting или OK в зависимости от того, следует ли считать отсутствие данных проблемой.

Устранение неполадок с оповещениями

Если ваши оповещения CloudWatch работают не так, как ожидается, используйте следующие разделы для диагностики распространённых проблем.

Оповещения не срабатывают

• Убедитесь, что запрос возвращает числовые данные в Explore.
• Убедитесь, что интервал оценки даёт достаточно времени для появления данных.
• Проверьте состояние правила оповещения и любые сообщения об ошибках в интерфейсе Alerting.

Запросы к логам для оповещений завершаются по тайм-ауту

• Увеличьте тайм-аут в файле конфигурации Grafana, который имеет приоритет во время оценки оповещений.
• Сузьте диапазон времени или добавьте фильтры, чтобы уменьшить объём данных, сканируемых запросом.

Дополнительную помощь см. в разделе Устранение неполадок Amazon CloudWatch.

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

• Grafana Alerting
• Create a Grafana-managed alert rule
• Amazon CloudWatch query editor