sensu_check - Управление проверками Sensu
Новая версия с 2.0.
Описание
- Управление проверками, которые должны выполняться на машине с помощью Sensu.
- Большинство параметров не имеют значений по умолчанию и не будут добавлены в определение проверки, если не указаны.
- Все значения по умолчанию, кроме path, state, backup и metric, не управляются этим модулем.
- Они просто указываются для вашего удобства.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| aggregate |
| Классифицирует проверку как агрегированную проверку, делая её доступной через API агрегирования |
| backup |
| Создаёт резервную копию файла (если да), включая отметку времени, чтобы вы могли восстановить исходный файл, если вы каким-то образом его повредили. |
| command обязательно | Путь к проверке sensu для выполнения (не требуется, когда state=absent) | |
| custom (добавлено в 2.1) | Значение по умолчанию: {} | Хэш/словарь пользовательских параметров для добавления в конфигурацию. Вы не можете перезаписывать параметры других модулей с помощью этого |
| dependencies | Значение по умолчанию: [] | Другие проверки, от которых зависит эта проверка; если зависимости завершатся неудачно, обработка этой проверки будет отключена |
| handle |
| Нужно ли обрабатывать проверку? |
| handlers | Значение по умолчанию: [] | Список обработчиков, которым нужно сообщить, если проверка завершается неудачно |
| high_flap_threshold | Значение по умолчанию: None | Верхний порог для обнаружения внезапных изменений |
| interval | Значение по умолчанию: None | Интервал проверки в секундах |
| low_flap_threshold | Значение по умолчанию: None | Нижний порог для обнаружения внезапных изменений |
| metric |
| Является ли проверка метрикой |
| name обязательно | Имя проверки Это ключ, используемый для определения существования проверки | |
| occurrences | Значение по умолчанию: 1 | Количество событий до того, как обработчик предпримет действия |
| path | Значение по умолчанию: /etc/sensu/conf.d/checks.json | Путь к JSON-файлу проверки для добавления/удаления. Будет создан, если он не существует (если state=absent). Родительские папки должны существовать, когда state=present, иначе будет выброшено сообщение об ошибке |
| publish |
| Нужно ли планировать проверку вообще. Вы всё ещё можете вызвать её через API sensu |
| refresh | Значение по умолчанию: None | Количество секунд, которые обработчики должны ждать перед выполнением второго действия |
| source (добавлено в 2.1) | Значение по умолчанию: None | Источник проверки, используемый для создания JIT-клиента Sensu для внешнего ресурса (например, сетевого коммутатора). |
| standalone |
| Нужно ли планировать проверку клиентом sensu или сервером Этот параметр исключает необходимость указания параметра subscribers |
| state |
| Проверка должна быть присутствующей или отсутствовать |
| subdue_begin | Значение по умолчанию: None | Когда следует отключить обработку ошибок проверки |
| subdue_end | Значение по умолчанию: None | Когда следует включить обработку ошибок проверки |
| subscribers | Значение по умолчанию: [] | Список подписчиков/каналов, для которых должна выполняться эта проверка См. sensu_subscribers для подписки машины на канал |
| timeout | Значение по умолчанию: 10 | Таймаут для проверки |
| ttl (добавлено в 2.4) | Значение по умолчанию: None | Время жизни в секундах до того, как проверка считается устаревшей |
Примеры
# 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
Статус
Этот модуль помечен как предварительный просмотр, что означает, что он не гарантирует обратную совместимость.
Автор
- Anders Ingemann (@andsens)
Подсказка
Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/sensu_check_module.html