nagios - Выполнение общих задач в Nagios, связанных с простоями и уведомлениями.
Описание
- Модуль
nagiosимеет две основные функции: планирование простоя и переключение уведомлений для служб или хостов. - Все действия требуют явного указания параметра host. В плейбуках можно использовать переменную
{{inventory_hostname}}, чтобы сослаться на хост, на котором в данный момент выполняется плейбук. - Можно указать несколько служб, разделив их запятыми, например,
services=httpd,nfs,puppet. - При указании службы для обработки существует специальное значение службы host, которое будет обрабатывать уведомления/простой для самого хоста, например,
service=host. Это ключевое слово не может использоваться одновременно с другими службами. Настройка уведомлений/простоя для хоста не влияет на уведомления/простой для каких-либо служб, работающих на нём. Чтобы запланировать простой для всех служб на определённом хосте, используйте ключевое слово «all», например,service=all. - При использовании модуля
nagiosвам потребуется указать свой сервер Nagios с помощью параметраdelegate_to.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| действие обязательно |
| Действие, которое нужно выполнить. Параметры servicegroup добавлены в версии 2.0. Параметры delete_downtime добавлены в версии 2.2. |
| автор | По умолчанию: "Ansible" | Автор, который оставит комментарии к простою. Используется только с действием downtime. |
| cmdfile | По умолчанию: "автоопределяется" | Путь к файлу команд Nagios (FIFO-пайп). Требуется только в случае, если автоматическое определение не удаётся. |
| команда обязательно | Необработанная команда для отправки в Nagios, которая не должна включать заголовок времени отправки или символ новой строки. Обязательно при использовании действия command. | |
| комментарий (добавлено в 2.0) | По умолчанию: "Планирование простоя" | Комментарий для действия downtime. |
| хост | Хост, с которым нужно взаимодействовать в Nagios. | |
| минуты | По умолчанию: 30 | Минут для планирования простоя. Используется только с действием downtime. |
| servicegroup (добавлено в 2.0) | Группа служб, для которой мы хотим установить простой/уведомления. Обязательно при использовании действий servicegroup_service_downtime и servicegroup_host_downtime. | |
| службы обязательно | Для чего устанавливать простой/уведомления. Разделяйте несколько служб запятыми. 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. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.
Список других модулей, также поддерживаемых сообществом 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.6/modules/nagios_module.html