sensu_check - Управление проверками Sensu
Новая версия с 2.0.
Краткое описание
- Управление проверками, которые должны выполняться на машине Sensu.
- Большинство параметров не имеют значения по умолчанию и не будут добавлены в определение проверки, если не указаны.
- Все значения по умолчанию, кроме path, state, backup и metric, не управляются этим модулем,
- они просто указаны для удобства.
Параметры
| параметр | обязательный | значение по умолчанию | возможные значения | комментарии |
|---|---|---|---|---|
| aggregate | нет |
| Классифицирует проверку как агрегированную проверку, делая ее доступной через агрегированный API | |
| backup | нет |
| Создать резервную копию файла (если да), включая информацию о времени создания, чтобы вы могли получить исходный файл обратно, если вы случайно его повредили. | |
| command | да | Путь к выполняемой проверке sensu (не требуется, когда state=absent) | ||
| custom (добавлено в 2.1)
| нет | Хеш/словарь пользовательских параметров для добавления в конфигурацию. Вы не можете перезаписать параметры других модулей с помощью этого параметра | ||
| dependencies | нет | Другие проверки, от которых зависит эта проверка, если зависимости завершатся ошибкой, обработка этой проверки будет отключена | ||
| handle | нет | True |
| Выполнять ли обработку проверки |
| handlers | нет | Список обработчиков, которые должны быть уведомлены при сбое проверки | ||
| high_flap_threshold | нет | Высокий порог для обнаружения флипа | ||
| interval | нет | Интервал проверки в секундах | ||
| low_flap_threshold | нет | Низкий порог для обнаружения флипа | ||
| metric | нет |
| Является ли проверка метрикой | |
| name | да | Название проверки Это ключ, используемый для определения наличия проверки | ||
| occurrences | нет | 1 | Количество событий до того, как обработчик предпримет действие | |
| path | нет | /etc/sensu/conf.d/checks.json | Путь к json-файлу проверки, который необходимо добавить/удалить. Будет создан, если не существует (если state=absent). Родительские папки должны существовать, когда state=present, иначе произойдет ошибка | |
| publish | нет | True |
| Выполнять ли проверку вообще. Вы по-прежнему можете выполнить ее через API sensu |
| refresh | нет | Количество секунд, которые обработчики должны ждать перед повторным действием | ||
| source (добавлено в 2.1)
| нет | Источник проверки, используемый для создания JIT-клиента Sensu для внешнего ресурса (например, сетевого коммутатора). | ||
| standalone | нет |
| Выполнять ли проверку с помощью клиента sensu или сервера Этот параметр исключает необходимость указания параметра subscribers | |
| state | нет | present |
| Должна ли проверка существовать или нет |
| subdue_begin | нет | Когда следует отключить обработку ошибок проверки | ||
| subdue_end | нет | Когда следует включить обработку ошибок проверки | ||
| subscribers | нет | Список подписчиков/каналов, для которых должна выполняться эта проверка См. sensu_subscribers, чтобы подписать машину на канал | ||
| timeout | нет | 10 | Таймаут для проверки | |
| ttl (добавлено в 2.4)
| нет | Время жизни в секундах, после которого проверка считается устаревшей |
Примеры
# Fetch metrics about the CPU load every 60 seconds,
# the sensu server has a handler called 'relay' which forwards stats to graphite
- name: get cpu metrics
sensu_check:
name: cpu_load
command: /etc/sensu/plugins/system/cpu-mpstat-metrics.rb
metric: yes
handlers: relay
subscribers: common
interval: 60
# Check whether nginx is running
- name: check nginx process
sensu_check:
name: nginx_running
command: /etc/sensu/plugins/processes/check-procs.rb -f /var/run/nginx.pid
handlers: default
subscribers: nginx
interval: 60
# Stop monitoring the disk capacity.
# Note that the check will still show up in the sensu dashboard,
# to remove it completely you need to issue a DELETE request to the sensu api.
- name: check disk
sensu_check:
name: check_disk_capacity
state: absent
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость.
Для получения помощи в разработке модулей, если вам это нужно, прочитайте Справочную информацию по сообществу и сотрудничеству, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/sensu_check_module.html