Модуль community.general.nagios – Выполнение общих задач в Nagios, связанных с простоями и уведомлениями
Примечание
Этот модуль является частью коллекции community.general (версия 9.5.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install community.general.
Для использования в playbook, укажите: community.general.nagios.
Краткое описание
- Модуль
nagiosимеет две основные функции: планирование простоя и переключение оповещений для сервисов или хостов. - Модуль
nagiosне является идемпотентным. - Для всех действий необходимо явно указать параметр
host. В playbook вы можете использовать переменную{{inventory_hostname}}для ссылки на хост, на котором в данный момент выполняется playbook. - Вы можете указать несколько сервисов одновременно, разделяя их запятыми, например
services=httpd,nfs,puppet. - При указании сервиса, который нужно обрабатывать, существует специальное значение сервиса,
host, которое будет обрабатывать оповещения/простой/подтверждение для самого хоста, напримерservices=host. Этот ключевое слово не может быть указано вместе с другими сервисами. Настройка оповещений/простоя/подтверждения для хоста не влияет на оповещения/простой/подтверждение для любого из сервисов, работающих на нем. Чтобы запланировать простой для всех сервисов на конкретном хосте, используйте ключевое слово «all», напримерservices=all.
Параметры
Параметр | Комментарии |
|---|---|
action string / required | Действие, которое нужно выполнить. Действия Варианты:
|
author string | Автор, который оставит комментарии к простою. Используется только тогда, когда Значение по умолчанию: |
cmdfile string | Путь к файлу команд Nagios (FIFO pipe). Требуется только в случае сбоя автообнаружения. |
command string | Необработанная команда для отправки в Nagios, которая не должна включать заголовок отправленного времени или перевод строки. Обязательный параметр при использовании |
comment string | Комментарий, когда Значение по умолчанию: |
host string | Хост, с которым нужно работать в Nagios. |
minutes integer | |
servicegroup string | Группа сервисов, для которой мы хотим установить простои/оповещения. Обязательный параметр при использовании |
services aliases: service string | Что управлять простоем/оповещениями. Разделите несколько сервисов запятыми. Обязательный параметр, когда |
start string добавлено в community.general 0.2.0 | Когда должен начаться простой, в формате |
Атрибуты
Атрибут | Поддержка | Описание |
|---|---|---|
check_mode | Поддержка: отсутствует | Может работать в режиме |
diff_mode | Поддержка: отсутствует | Будет возвращать подробную информацию о том, что изменилось (или, возможно, нужно изменить в |
Примеры
- name: Set 30 minutes of apache downtime
community.general.nagios:
action: downtime
minutes: 30
service: httpd
host: '{{ inventory_hostname }}'
- name: Schedule an hour of HOST downtime
community.general.nagios:
action: downtime
minutes: 60
service: host
host: '{{ inventory_hostname }}'
- name: Schedule an hour of HOST downtime starting at 2019-04-23T02:00:00+00:00
community.general.nagios:
action: downtime
start: 1555984800
minutes: 60
service: host
host: '{{ inventory_hostname }}'
- name: Schedule an hour of HOST downtime, with a comment describing the reason
community.general.nagios:
action: downtime
minutes: 60
service: host
host: '{{ inventory_hostname }}'
comment: Rebuilding machine
- name: Schedule downtime for ALL services on HOST
community.general.nagios:
action: downtime
minutes: 45
service: all
host: '{{ inventory_hostname }}'
- name: Schedule downtime for a few services
community.general.nagios:
action: downtime
services: frob,foobar,qeuz
host: '{{ inventory_hostname }}'
- name: Set 30 minutes downtime for all services in servicegroup foo
community.general.nagios:
action: servicegroup_service_downtime
minutes: 30
servicegroup: foo
host: '{{ inventory_hostname }}'
- name: Set 30 minutes downtime for all host in servicegroup foo
community.general.nagios:
action: servicegroup_host_downtime
minutes: 30
servicegroup: foo
host: '{{ inventory_hostname }}'
- name: Delete all downtime for a given host
community.general.nagios:
action: delete_downtime
host: '{{ inventory_hostname }}'
service: all
- name: Delete all downtime for HOST with a particular comment
community.general.nagios:
action: delete_downtime
host: '{{ inventory_hostname }}'
service: host
comment: Planned maintenance
- name: Acknowledge an HOST with a particular comment
community.general.nagios:
action: acknowledge
service: host
host: '{{ inventory_hostname }}'
comment: 'power outage - see casenr 12345'
- name: Acknowledge an active service problem for the httpd service with a particular comment
community.general.nagios:
action: acknowledge
service: httpd
host: '{{ inventory_hostname }}'
comment: 'service crashed - see casenr 12345'
- name: Reset a passive service check for snmp trap
community.general.nagios:
action: forced_check
service: snmp
host: '{{ inventory_hostname }}'
- name: Force an active service check for the httpd service
community.general.nagios:
action: forced_check
service: httpd
host: '{{ inventory_hostname }}'
- name: Force an active service check for all services of a particular host
community.general.nagios:
action: forced_check
service: all
host: '{{ inventory_hostname }}'
- name: Force an active service check for a particular host
community.general.nagios:
action: forced_check
service: host
host: '{{ inventory_hostname }}'
- name: Enable SMART disk alerts
community.general.nagios:
action: enable_alerts
service: smart
host: '{{ inventory_hostname }}'
- name: Disable httpd and nfs alerts
community.general.nagios:
action: disable_alerts
service: httpd,nfs
host: '{{ inventory_hostname }}'
- name: Disable HOST alerts
community.general.nagios:
action: disable_alerts
service: host
host: '{{ inventory_hostname }}'
- name: Silence ALL alerts
community.general.nagios:
action: silence
host: '{{ inventory_hostname }}'
- name: Unsilence all alerts
community.general.nagios:
action: unsilence
host: '{{ inventory_hostname }}'
- name: Shut up nagios
community.general.nagios:
action: silence_nagios
- name: Annoy me negios
community.general.nagios:
action: unsilence_nagios
- name: Command something
community.general.nagios:
action: command
command: DISABLE_FAILURE_PREDICTION
Авторы
- Tim Bielawa (@tbielawa)
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/nagios_module.html