datadog_monitor – Управление мониторами Datadog
Новая версия с 2.0.
Обзор
- Управление мониторами в Datadog.
- Параметры, как описано на https://docs.datadoghq.com/api/.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- datadog
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_key строка / обязательно | Ваш ключ API Datadog. | |
| app_key строка / обязательно | Ваш ключ приложения Datadog. | |
| escalation_message строка | Сообщение для включения с повторным уведомлением. Поддерживает уведомления по типу '@имя_пользователя', как и в других местах. Неприменимо, если renotify_interval=None. | |
| evaluation_delay строка добавлено в 2.7 | Время задержки оценки (в секундах). Эффективно для разреженных значений. | |
| id строка добавлено в 2.3 | Идентификатор события. Если установлено, будет использоваться вместо имени для поиска события. | |
| locked логическое добавлено в 2.2 |
| Ограничить изменения этого монитора только для создателя или администраторов. |
| 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 логическое добавлено в 2.3 |
| Требуется ли полное окно данных для оценки монитора. Сильно рекомендуется установить в «False» для разреженных метрик, в противном случае некоторые оценки будут пропущены. |
| silenced - | Значение по умолчанию: "" | Словарь областей для отключения, с временными метками или None. Каждая область будет выключена до указанной временной метки POSIX или навсегда, если значение None. |
| state строка / обязательно |
| Установленное состояние монитора. |
| tags список добавлено в 2.2 | Список тегов для ассоциации с вашим монитором при создании или обновлении. Это может помочь в категоризации и фильтрации мониторов. | |
| 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. [сообщество]
Авторы
- 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.8/modules/datadog_monitor_module.html
