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 - | Верхний порог для обнаружения флипов | |
| interval - | Интервал проверки в секундах | |
| low_flap_threshold - | Нижний порог для обнаружения флипов | |
| metric логическое значение |
| Является ли проверка метрикой |
| name - / обязательно | Имя проверки Это ключ, используемый для определения существования проверки | |
| occurrences - | Значение по умолчанию: 1 | Количество событий до того, как обработчик должен предпринять действие |
| path - | Значение по умолчанию: "/etc/sensu/conf.d/checks.json" | Путь к json файлу проверки для добавления/удаления. Будет создан, если не существует (кроме случаев state=absent). Родительские папки должны существовать при state=present, в противном случае будет выброшено сообщение об ошибке |
| publish логическое значение |
| Должна ли проверка планироваться вообще. Вы все равно можете выполнить ее через API sensu |
| refresh - | Количество секунд, которое обработчики должны ждать перед повторным действием | |
| source - добавлен в 2.1 | Источник проверки, используемый для создания временного клиента Sensu для внешнего ресурса (например, сетевого коммутатора). | |
| standalone логическое значение |
| Должна ли проверка планироваться клиентом или сервером sensu Этот параметр исключает необходимость указания параметра subscribers |
| state - |
| Должна ли проверка присутствовать или нет |
| 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. [сообщество]
Авторы
- 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.7/modules/sensu_check_module.html