nagios – Выполнение общих задач в Nagios, связанных с простоями и уведомлениями
Обзор
- Модуль
nagiosимеет две основные функции: планирование простоев и переключение оповещений для сервисов или хостов. - Все действия требуют явного указания параметра host. В playbooks вы можете использовать переменную
{{inventory_hostname}}для ссылки на хост, на котором в данный момент выполняется playbook. - Вы можете указать несколько служб одновременно, разделяя их запятыми, например,
services=httpd,nfs,puppet. - При указании службы, за которой необходимо следить, есть специальное значение host, которое обрабатывает оповещения/простои для самого хоста, например,
service=host. Это ключевое слово не может использоваться одновременно с другими службами. Настройка оповещений/простоев для хоста не влияет на оповещения/простои для любых служб, работающих на нем. Чтобы запланировать простой для всех служб на конкретном хосте, используйте ключевое слово «all», например,service=all. - При использовании модуля
nagiosвам необходимо указать свой сервер Nagios с помощью параметраdelegate_to.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| action - / обязательно |
| Действие, которое необходимо выполнить. Параметры servicegroup добавлены в версии 2.0. Параметры delete_downtime добавлены в версии 2.2. |
| author - | Значение по умолчанию: "Ansible" | Автор, чьи комментарии к простою будут сохранены. Используется только с действием downtime. |
| cmdfile - | Значение по умолчанию: "auto-detected" | Путь к файлу команд Nagios (FIFO-пайп). Требуется только в случае, если автоматическое определение не выполнено. |
| command - / обязательно | Необработанная команда для отправки в Nagios, которая не должна включать заголовок времени отправки или символ новой строки. Обязательный параметр при использовании действия command. | |
| comment - добавлено в 2.0 | Значение по умолчанию: "Планирование простоев" | Комментарий для действия downtime. |
| host - | Хост в Nagios, на котором необходимо выполнить операцию. | |
| minutes целое число | Значение по умолчанию: 30 | Минут для планирования простоев. Используется только с действием downtime. |
| servicegroup - добавлено в 2.0 | Группа сервисов, для которых необходимо настроить простои/оповещения. Обязательный параметр при использовании действий servicegroup_service_downtime и servicegroup_host_downtime. | |
| services - / обязательно | Для чего нужно управлять простоем/оповещениями. Несколько сервисов разделяются запятыми. service — псевдоним для services. Обязательный параметр при использовании действий downtime, enable_alerts, и disable_alerts.псевдонимы: service |
Примеры
# set 30 minutes of apache downtime
- nagios:
action: downtime
minutes: 30
service: httpd
host: '{{ inventory_hostname }}'
# schedule an hour of HOST downtime
- nagios:
action: downtime
minutes: 60
service: host
host: '{{ inventory_hostname }}'
# schedule an hour of HOST downtime, with a comment describing the reason
- nagios:
action: downtime
minutes: 60
service: host
host: '{{ inventory_hostname }}'
comment: Rebuilding machine
# schedule downtime for ALL services on HOST
- nagios:
action: downtime
minutes: 45
service: all
host: '{{ inventory_hostname }}'
# schedule downtime for a few services
- nagios:
action: downtime
services: frob,foobar,qeuz
host: '{{ inventory_hostname }}'
# set 30 minutes downtime for all services in servicegroup foo
- nagios:
action: servicegroup_service_downtime
minutes: 30
servicegroup: foo
host: '{{ inventory_hostname }}'
# set 30 minutes downtime for all host in servicegroup foo
- nagios:
action: servicegroup_host_downtime
minutes: 30
servicegroup: foo
host: '{{ inventory_hostname }}'
# delete all downtime for a given host
- nagios:
action: delete_downtime
host: '{{ inventory_hostname }}'
service: all
# delete all downtime for HOST with a particular comment
- nagios:
action: delete_downtime
host: '{{ inventory_hostname }}'
service: host
comment: Planned maintenance
# enable SMART disk alerts
- nagios:
action: enable_alerts
service: smart
host: '{{ inventory_hostname }}'
# "two services at once: disable httpd and nfs alerts"
- nagios:
action: disable_alerts
service: httpd,nfs
host: '{{ inventory_hostname }}'
# disable HOST alerts
- nagios:
action: disable_alerts
service: host
host: '{{ inventory_hostname }}'
# silence ALL alerts
- nagios:
action: silence
host: '{{ inventory_hostname }}'
# unsilence all alerts
- nagios:
action: unsilence
host: '{{ inventory_hostname }}'
# SHUT UP NAGIOS
- nagios:
action: silence_nagios
# ANNOY ME NAGIOS
- nagios:
action: unsilence_nagios
# command something
- nagios:
action: command
command: DISABLE_FAILURE_PREDICTION
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Tim Bielawa (@tbielawa)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/nagios_module.html