community.general.datadog_monitor – Управляет мониторами Datadog
Примечание
Этот плагин является частью коллекции community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в книге задач укажите: community.general.datadog_monitor.
Обзор
- Управляет мониторами в Datadog.
- Параметры, как описано на https://docs.datadoghq.com/api/.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- datadog
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_host строка добавлен в версии 0.2.0 community.general | URL API Datadog. Значение по умолчанию — https://api.datadoghq.com.Это значение также можно установить с помощью переменной среды DATADOG_HOST. | |
| api_key строка / обязательно | Ваш API ключ Datadog. | |
| app_key строка / обязательно | Ваш приложение ключ Datadog. | |
| escalation_message строка | Сообщение для включения с повторным уведомлением. Поддерживает уведомление «@имя_пользователя», которое мы используем и в других местах. Не применимо, если renotify_interval=None. | |
| evaluation_delay строка | Время задержки оценки (в секундах). Эффективно для разреженных значений. | |
| id строка | Идентификатор оповещения. Если задано, используется вместо имени для поиска оповещения. | |
| include_tags булево добавлен в версии 1.3.0 community.general |
| Указывает, вставляются ли теги, которые сработали при срабатывании монитора, автоматически в заголовок уведомления. |
| locked булево |
| Указывает, должны ли изменения в этом мониторе ограничиваться создателем или администраторами. |
| name строка / обязательно | Имя оповещения. | |
| new_host_delay строка | Положительное целое число, представляющее количество секунд, которое следует подождать перед оценкой монитора для новых хостов. Это дает хосту время для полной инициализации. | |
| no_data_timeframe строка | Количество минут, в течение которых монитор будет уведомлять о том, что данные перестали поступать. Должно быть не менее 2х интервала монитора для метрических оповещений или 2 минут для проверок сервиса. Если не указано, по умолчанию устанавливается 2х интервала для метрик, 2 минуты для сервиса. | |
| notification_message строка | Сообщение, которое нужно включить с уведомлениями для этого монитора. Уведомления по электронной почте могут быть отправлены конкретным пользователям с помощью той же нотации «@имя_пользователя», что и события. Переменные шаблонов сообщений монитора могут быть доступны с помощью двойных квадратных скобок, т.е. «[['» и «]]». message псевдоним устарел в community.general 0.2.0, так как используется внутри Ansible Core Engine.псевдонимы: message | |
| notify_audit булево |
| Указывает, будут ли уведомлены пользователи с метками об изменениях в этом мониторе. |
| notify_no_data булево |
| Указывает, будет ли данный монитор уведомлять о прекращении отслеживания данных. |
| query строка | Запрос монитора для оповещений. Синтаксис варьируется в зависимости от типа создаваемого монитора. | |
| renotify_interval строка | Количество минут после последнего уведомления, прежде чем монитор будет повторно уведомлять о текущем состоянии. Повторное уведомление будет только в том случае, если оно не решено. | |
| require_full_window булево |
| Требуется ли для оценки этого монитора полный набор данных. Мы настоятельно рекомендуем установить это значение в False для разреженных метрик, в противном случае некоторые оценки будут пропущены. |
| silenced словарь | По умолчанию: "" | Словарь диапазонов для отключения, с отметками времени или None. Каждый диапазон будет отключен до указанного временного отметки POSIX или навсегда, если значение равно None. |
| state строка / обязательно |
| Заданное состояние монитора. |
| tags список / элементы=строка | Список тегов для связывания с вашим монитором при создании или обновлении. Это может помочь вам категоризировать и фильтровать мониторы. | |
| thresholds словарь | Словарь порогов по статусу. Доступен только для проверок сервиса и метрических оповещений. Так как каждый из них может иметь несколько порогов, мы не определяем их непосредственно в запросе. Если не указано, по умолчанию: {'ok': 1, 'critical': 1, 'warning': 1}. | |
| timeout_h строка | Количество часов, в течение которых монитор не сообщает данные, прежде чем он будет автоматически разрешен из состояния срабатывания. | |
| type строка |
| Тип монитора. |
Примеры
- name: Create a metric monitor
community.general.datadog_monitor:
type: "metric alert"
name: "Test monitor"
state: "present"
query: "datadog.agent.up.over('host:host1').last(2).count_by_status()"
notification_message: "Host [[host.name]] with IP [[host.ip]] is failing to report to datadog."
api_key: "9775a026f1ca7d1c6c5af9d94d9595a4"
app_key: "87ce4a24b5553d2e482ea8a8500e71b8ad4554ff"
- name: Deletes a monitor
community.general.datadog_monitor:
name: "Test monitor"
state: "absent"
api_key: "9775a026f1ca7d1c6c5af9d94d9595a4"
app_key: "87ce4a24b5553d2e482ea8a8500e71b8ad4554ff"
- name: Mutes a monitor
community.general.datadog_monitor:
name: "Test monitor"
state: "mute"
silenced: '{"*":None}'
api_key: "9775a026f1ca7d1c6c5af9d94d9595a4"
app_key: "87ce4a24b5553d2e482ea8a8500e71b8ad4554ff"
- name: Unmutes a monitor
community.general.datadog_monitor:
name: "Test monitor"
state: "unmute"
api_key: "9775a026f1ca7d1c6c5af9d94d9595a4"
app_key: "87ce4a24b5553d2e482ea8a8500e71b8ad4554ff"
- name: Use datadoghq.eu platform instead of datadoghq.com
community.general.datadog_monitor:
name: "Test monitor"
state: "absent"
api_host: https://api.datadoghq.eu
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.10/collections/community/general/datadog_monitor_module.html
