datadog_monitor – Управляет мониторами Datadog
Обзор
- Управляет мониторами в Datadog.
- Параметры, как описано на https://docs.datadoghq.com/api/.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- datadog
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_key строка / обязательно | Ваш ключ API Datadog. | |
| app_key строка / обязательно | Ваш ключ приложения Datadog. | |
| escalation_message строка | Сообщение для включения при повторном уведомлении. Поддерживает обозначение уведомлений «@имя_пользователя». Не применимо, если renotify_interval=None. | |
| evaluation_delay строка добавлено в 2.7 | Время задержки оценки (в секундах). Эффективно для редких значений. | |
| id строка | Идентификатор события. Если указано, будет использоваться вместо имени для поиска события. | |
| locked логическое значение |
| Указывает, должны ли изменения в данном мониторе быть ограничены создателем или администраторами. |
| message строка | Сообщение для включения в уведомления об этом мониторе. Уведомления по электронной почте могут быть отправлены определённым пользователям, используя обозначение «@имя_пользователя», как и для событий. Переменные шаблона сообщений монитора могут быть обработаны с помощью двойных квадратных скобок, например '[[' и ']]'. | |
| name строка / обязательно | Имя события. | |
| new_host_delay строка добавлено в 2.4 | Положительное целое число, представляющее количество секунд ожидания перед оценкой монитора для новых хостов. Это даёт хосту время для полной инициализации. | |
| no_data_timeframe строка | Значение по умолчанию: "2x интервал для метрики, 2 минуты для сервиса" | Количество минут, в течение которых монитор будет уведомлять при отсутствии данных. Должно быть не менее 2х интервала монитора для метрических оповещений или 2 минут для проверки сервисов. |
| notify_audit логическое значение |
| Указывает, будут ли пользователи с соответствующими тегами получать уведомления об изменениях в этом мониторе. |
| notify_no_data логическое значение |
| Указывает, будет ли этот монитор уведомлять об отсутствии данных. |
| query строка | Запрос монитора для оповещений. Синтаксис варьируется в зависимости от типа создаваемого монитора. | |
| renotify_interval строка | Количество минут после последнего уведомления, прежде чем монитор повторно уведомит о текущем статусе. Повторное уведомление будет только в случае, если проблема не устранена. | |
| require_full_window логическое значение |
| Требуется ли этому монитору полный набор данных для оценки. Сильно рекомендуется установить значение в False для редких метрик, иначе некоторые оценки будут пропущены. |
| silenced - | Значение по умолчанию: "" | Словарь областей для отключения, с временными метками или None. Каждая область будет заглушена до указанной временной метки POSIX или навсегда, если значение равно None. |
| state строка / обязательно |
| Назначенный статус монитора. |
| tags список | Список тегов для ассоциации с вашим монитором при создании или обновлении. Это может помочь в категоризации и фильтрации мониторов. | |
| thresholds - | Значение по умолчанию: {"critical": 1, "ok": 1, "warning": 1} | Словарь пороговых значений по статусу. Доступно только для проверок сервисов и метрических оповещений. Так как каждый из них может иметь несколько порогов, мы не определяем их напрямую в запросе. |
| timeout_h строка | Количество часов, в течение которых монитор не сообщает данные, прежде чем автоматически разрешится из состояния срабатывания. | |
| type строка |
| Тип монитора. |
Примеры
# Create a metric monitor
- datadog_monitor:
type: "metric alert"
name: "Test monitor"
state: "present"
query: "datadog.agent.up.over('host:host1').last(2).count_by_status()"
message: "Host [[host.name]] with IP [[host.ip]] is failing to report to datadog."
api_key: "9775a026f1ca7d1c6c5af9d94d9595a4"
app_key: "87ce4a24b5553d2e482ea8a8500e71b8ad4554ff"
# Deletes a monitor
- datadog_monitor:
name: "Test monitor"
state: "absent"
api_key: "9775a026f1ca7d1c6c5af9d94d9595a4"
app_key: "87ce4a24b5553d2e482ea8a8500e71b8ad4554ff"
# Mutes a monitor
- datadog_monitor:
name: "Test monitor"
state: "mute"
silenced: '{"*":None}'
api_key: "9775a026f1ca7d1c6c5af9d94d9595a4"
app_key: "87ce4a24b5553d2e482ea8a8500e71b8ad4554ff"
# Unmutes a monitor
- datadog_monitor:
name: "Test monitor"
state: "unmute"
api_key: "9775a026f1ca7d1c6c5af9d94d9595a4"
app_key: "87ce4a24b5553d2e482ea8a8500e71b8ad4554ff"
Статус
- Данный модуль не гарантирует обратную совместимость. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Sebastian Kornehl (@skornehl)
Подсказка
Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/datadog_monitor_module.html
