Spec-Zone.ru › Ansible 2.6

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

  • Описание
  • Параметры
  • Примеры
  • Статус
  • Техническое обслуживание
    • Автор

Описание

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

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
действие
обязательно
    Варианты:
  • простой
  • удалить_простой
  • включить_уведомления
  • отключить_уведомления
  • беззвучно
  • снова_с_звуком
  • беззвучно_nagios
  • снова_с_звуком_nagios
  • команда
  • servicegroup_service_простой
  • servicegroup_host_простой
Действие, которое нужно выполнить.
Параметры 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

Spec-Zone.ru

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