sensu_check - Управление проверками Sensu
Новая версия 2.0.
Обзор
- Управление проверками, которые должны выполняться на машине Sensu.
- Большинство параметров не имеют значения по умолчанию и не будут добавлены в определение проверки, если не указаны.
- Все значения по умолчанию, кроме path, state, backup и metric, не управляются этим модулем,
- они просто указаны для вашего удобства.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| aggregate bool |
| Классифицирует проверку как агрегированную проверку, делая её доступной через API агрегации |
| backup bool |
| Создаёт резервную копию файла (если да), включая информацию о времени создания, чтобы вы могли получить исходный файл, если вы неправильно его изменили. |
| command обязательно | Путь к проверке sensu для выполнения (не требуется, когда state=absent) | |
| custom (добавлено в 2.1) | Значение по умолчанию: {} | Хэш/словарь пользовательских параметров для смешивания в конфигурацию. Вы не можете перезаписать параметры других модулей с помощью этого |
| dependencies | Значение по умолчанию: [] | Другие проверки, от которых зависит эта проверка, если проверки зависимостей завершаются неудачно, обработка этой проверки будет отключена |
| handle bool |
| Нужно ли обрабатывать проверку |
| handlers | Значение по умолчанию: [] | Список обработчиков, которым нужно сообщить об ошибке проверки |
| high_flap_threshold | Максимальное значение для определения флипа | |
| interval | Интервал проверки в секундах | |
| low_flap_threshold | Минимальное значение для определения флипа | |
| metric bool |
| Является ли проверка метрикой |
| name обязательно | Имя проверки Это ключ, используемый для определения существования проверки | |
| occurrences | Значение по умолчанию: 1 | Количество событий до того, как обработчик предпримет действие |
| path | Значение по умолчанию: "/etc/sensu/conf.d/checks.json" | Путь к json-файлу проверки для добавления/удаления. Будет создан, если он не существует (если state=absent). Родительские папки должны существовать, когда state=present, в противном случае будет выброшено сообщение об ошибке |
| publish bool |
| Нужно ли планировать проверку вообще. Вы всё ещё можете выполнить её через sensu api |
| refresh | Количество секунд, которые обработчики должны ждать, прежде чем предпринять второе действие | |
| source (добавлено в 2.1) | Источник проверки, используемый для создания JIT-клиента Sensu для внешнего ресурса (например, сетевого коммутатора). | |
| standalone bool |
| Нужно ли планировать проверку клиентом или сервером 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. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.
Список других модулей, которые также поддерживаются сообществом 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.6/modules/sensu_check_module.html