Spec-Zone.ru › Ansible 2.10

community.general.nagios – Выполнение общих задач в Nagios, связанных с простоями и уведомлениями.

Примечание

Этот плагин является частью коллекции community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general.

Чтобы использовать его в книге задач, укажите: community.general.nagios.

  • Обзор
  • Параметры
  • Примеры

Обзор

  • Модуль nagios имеет две основные функции: планирование простоя и переключение оповещений для служб или хостов.
  • Все действия требуют явного указания параметра host. В книгах задач вы можете использовать переменную {{inventory_hostname}}, чтобы сослаться на хост, на котором в данный момент выполняется книга задач.
  • Вы можете указать несколько служб, разделяя их запятыми, например, services=httpd,nfs,puppet.
  • При указании службы для обработки существует специальное значение службы host, которое будет обрабатывать оповещения/простои/подтверждения для самого хоста, например, service=host. Этот ключевое слово не может быть использовано вместе с другими службами одновременно. Установка оповещений/простоя/подтверждений для хоста не влияет на оповещения/простои/подтверждения для любой из служб, работающих на нём. Чтобы запланировать простой для всех служб на конкретном хосте, используйте ключевое слово «all», например, service=all.
  • При использовании модуля nagios вам необходимо указать сервер Nagios, используя параметр delegate_to.

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
action
строка / обязательно
    Варианты:
  • downtime
  • delete_downtime
  • enable_alerts
  • disable_alerts
  • silence
  • unsilence
  • silence_nagios
  • unsilence_nagios
  • command
  • servicegroup_service_downtime
  • servicegroup_host_downtime
  • acknowledge
  • forced_check
Действие, которое нужно выполнить.
Варианты servicegroup добавлены в версии 2.0.
Вариант delete_downtime добавлен в версии 2.2.
Действия acknowledge и forced_check были добавлены в community.general 1.2.0.
author
строка
Значение по умолчанию:
"Ansible"
Автор, от чьего имени оставлять комментарии к простою. Используется только с действиями downtime и acknowledge.
cmdfile
строка
Путь к файлу команд Nagios (FIFO-пайп). Требуется только в случае неудачи при автоматическом определении.
command
строка
Необработанная команда для отправки в Nagios, которая не должна включать заголовок времени отправки или символ новой строки. Обязательно при использовании действия command.
comment
строка
Значение по умолчанию:
"Планирование простоя"
Комментарий для действия downtime и acknowledge.
host
строка
Хост для обработки в Nagios.
minutes
целое число
Значение по умолчанию:
30
Минуты, на которые запланировать простой.
Используется только с действием downtime.
servicegroup
строка
Группа служб, для которых мы хотим установить простои/оповещения. Обязательно при использовании действий servicegroup_service_downtime и servicegroup_host_downtime.
services
строка
Для чего управлять простоем/оповещениями. Разделяйте несколько служб запятыми. service – псевдоним для services. Обязательно при использовании действий downtime, acknowledge, forced_check, enable_alerts, и disable_alerts.

псевдонимы: service
start
строка
добавлен в 0.2.0 версии community.general
Время начала простоя в формате time_t (секунды с начала эпохи).

Примеры

- 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/nagios_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API