datadog_monitor - Управляет мониторами Datadog
Новая версия 2.0.
Обзор
- Управляет мониторами в Datadog
- Варианты, как описано на http://docs.datadoghq.com/api/
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- datadog
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_key обязательно | Ваш ключ API DataDog. | |
| app_key обязательно | Ваш ключ приложения DataDog. | |
| escalation_message | Значение по умолчанию: None | Сообщение для включения при повторном уведомлении. Поддерживает уведомление '@username', которое мы разрешаем в других местах. Не применимо, если renotify_interval равно None. |
| id (добавлено в 2.3) | Значение по умолчанию: None | Идентификатор оповещения. Если задано, будет использоваться вместо имени для поиска оповещения. |
| locked (добавлено в 2.2) | Значение по умолчанию: no | Логическое значение, указывающее, должны ли изменения в этом мониторе быть ограничены создателем или администраторами. |
| message | Значение по умолчанию: None | Сообщение, которое необходимо включить в уведомления для этого монитора. Уведомления по электронной почте могут быть отправлены определённым пользователям, используя тот же символ '@имя_пользователя', что и в событиях. Переменные шаблонов сообщений монитора можно получить, используя двойные квадратные скобки, например '[[' и ']]'. |
| name обязательно | Название оповещения. | |
| new_host_delay (добавлено в 2.4) | Значение по умолчанию: None | Положительное целое число, представляющее количество секунд ожидания, прежде чем оценивать монитор для новых хостов. Это даёт хосту время для полной инициализации. |
| no_data_timeframe | Значение по умолчанию: 2x интервал для метрики, 2 минуты для сервиса | Количество минут, в течение которых монитор будет отправлять уведомления, когда отслеживание данных прекращается. Должно быть как минимум в 2 раза больше интервала монитора для метрических оповещений или 2 минут для проверок сервиса. |
| notify_audit | Значение по умолчанию: no | Логическое значение, указывающее, будут ли помеченные пользователи получать уведомления об изменениях в этом мониторе. |
| notify_no_data | Значение по умолчанию: no | Логическое значение, указывающее, будет ли этот монитор отправлять уведомления, когда отслеживание данных прекращается. |
| query | Значение по умолчанию: None | Запрос монитора для отправки уведомлений с синтаксисом, который зависит от типа создаваемого монитора. |
| renotify_interval | Значение по умолчанию: None | Количество минут после последнего уведомления, прежде чем монитор отправит повторное уведомление о текущем статусе. Он будет повторно уведомлять только в том случае, если он не разрешен. |
| require_full_window (добавлено в 2.3) | Значение по умолчанию: None | Логическое значение, указывающее, требует ли этот монитор полного набора данных для оценки. Мы настоятельно рекомендуем установить это значение в False для разреженных метрик, иначе некоторые оценки будут пропущены. |
| silenced | Значение по умолчанию: | Словарь областей до временных меток или None. Каждая область будет заглушена до указанной временной метки POSIX или навсегда, если значение равно None. |
| state обязательно |
| Указанный статус монитора. |
| tags (добавлено в 2.2) | Значение по умолчанию: None | Список тегов для присвоения вашему монитору при создании или обновлении. Это может помочь вам классифицировать и фильтровать мониторы. |
| thresholds | Значение по умолчанию: {u'warning': 1, u'ok': 1, u'critical': 1} | Словарь пороговых значений по статусу. Этот параметр доступен только для проверок сервисов и метрических оповещений. Так как каждый из них может иметь несколько пороговых значений, мы не определяем их напрямую в запросе. |
| timeout_h | Значение по умолчанию: None | Количество часов, в течение которых монитор не отправляет данные, прежде чем он автоматически разрешится из триггерного состояния. |
| type |
None | Тип монитора. «Оповещение об событии» доступно начиная с Ansible 2.1 |
Примеры
# 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"
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратная совместимость.
Автор
- 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.5/modules/datadog_monitor_module.html