Spec-Zone.ru › Ansible 2.8

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

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

Обзор

  • Модуль nagios имеет две основные функции: планирование простоев и переключение оповещений для сервисов или хостов.
  • Все действия требуют явного указания параметра host. В playbooks вы можете использовать переменную {{inventory_hostname}} для ссылки на хост, на котором в данный момент выполняется playbook.
  • Вы можете указать несколько служб одновременно, разделяя их запятыми, например, 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
Действие, которое необходимо выполнить.
Параметры 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

Spec-Zone.ru

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