Spec-Zone.ru › Ansible

Модуль 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

Действие, которое нужно выполнить.

Действия acknowledge и forced_check были добавлены в community.general 1.2.0.

Варианты:

  • "downtime"
  • "delete_downtime"
  • "enable_alerts"
  • "disable_alerts"
  • "silence"
  • "unsilence"
  • "silence_nagios"
  • "unsilence_nagios"
  • "command"
  • "servicegroup_service_downtime"
  • "servicegroup_host_downtime"
  • "acknowledge"
  • "forced_check"

author

string

Автор, который оставит комментарии к простою. Используется только тогда, когда action равно downtime или acknowledge.

Значение по умолчанию: "Ansible"

cmdfile

string

Путь к файлу команд Nagios (FIFO pipe). Требуется только в случае сбоя автообнаружения.

command

string

Необработанная команда для отправки в Nagios, которая не должна включать заголовок отправленного времени или перевод строки.

Обязательный параметр при использовании command action.

comment

string

Комментарий, когда action равно downtime или acknowledge.

Значение по умолчанию: "Scheduling downtime"

host

string

Хост, с которым нужно работать в Nagios.

minutes

integer

Минуты для планирования простоя.

Используется только с action=downtime.

Значение по умолчанию: 30

servicegroup

string

Группа сервисов, для которой мы хотим установить простои/оповещения.

Обязательный параметр при использовании servicegroup_service_downtime и servicegroup_host_downtime action.

services

aliases: service

string

Что управлять простоем/оповещениями. Разделите несколько сервисов запятыми.

Обязательный параметр, когда action является одним из: downtime, acknowledge, forced_check, enable_alerts, disable_alerts.

start

string

добавлено в community.general 0.2.0

Когда должен начаться простой, в формате time_t (эпохальные секунды).

Атрибуты

Атрибут

Поддержка

Описание

check_mode

Поддержка: отсутствует

Может работать в режиме check_mode и возвращать прогноз состояния «изменено» без изменения целевого объекта.

diff_mode

Поддержка: отсутствует

Будет возвращать подробную информацию о том, что изменилось (или, возможно, нужно изменить в check_mode), в режиме diff.

Примеры

- 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

Spec-Zone.ru

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