t_systems_mms.icinga_director.icinga_notification – Управление уведомлениями в Icinga2
Примечание
Этот плагин является частью коллекции t_systems_mms.icinga_director (версия 1.13.0).
Для его установки используйте: ansible-galaxy collection install t_systems_mms.icinga_director.
Для использования в книге задач укажите: t_systems_mms.icinga_director.icinga_notification.
Новое в версии 1.0.0: модуля t_systems_mms.icinga_director
Обзор
- Добавление или удаление уведомления в Icinga2 через API директора.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| apply_to строка / обязательно |
| Определяет, к хостам или службам должно относиться это уведомление. |
| assign_filter строка | Фильтр, в котором будет действовать уведомление. | |
| client_cert путь | Файл цепочки сертификатов в формате PEM для аутентификации клиента по протоколу SSL. Этот файл также может содержать ключ, и если ключ включён, client_key не требуется. | |
| client_key путь | Файл в формате PEM, содержащий ваш закрытый ключ для аутентификации клиента по протоколу SSL. Если client_cert содержит и сертификат, и ключ, этот параметр не требуется. | |
| disabled логический добавлен в 1.9.0 t_systems_mms.icinga_director |
| Отключенные объекты не будут развернуты. |
| force логический |
| Если yes не получите кэшированную копию.Псевдоним thirsty устарел и будет удалён в версии 2.13.Псевдонимы: thirsty |
| force_basic_auth логический |
| Указанные с помощью url_username и url_password учетные данные должны передаваться в HTTP-заголовке. |
| http_agent строка | По умолчанию: "ansible-httpget" | Идентификатор пользователя, обычно отображается в журналах веб-сервера. |
| imports список / элементы=строка | Импортируемые шаблоны, можно добавить любое количество. Требуется, когда состояние равно present. Обратите внимание, что порядок имеет значение при импорте свойств из нескольких шаблонов — последний шаблон имеет приоритет. | |
| notification_interval строка | Интервал уведомлений (в секундах). Этот интервал используется для активных уведомлений. По умолчанию 30 минут. Если задано 0, повторные уведомления отключены. | |
| object_name строка / обязательно | Имя уведомления. Псевдонимы: name | |
| state строка |
| Состояние применяемого объекта. |
| states список / элементы=строка добавлен в 1.9.0 t_systems_mms.icinga_director | Состояния хостов или служб, для которых вы хотите получать уведомления. | |
| types список / элементы=строка | Типы переходов состояния, для которых вы хотите получать уведомления. | |
| url строка / обязательно | URL HTTP, HTTPS или FTP в формате (http|https|ftp)://[пользователь[:пароль]]@хост.домен[:порт]/путь | |
| url_password строка | Пароль для использования в аутентификации HTTP по принципу «пользователь/пароль». Если параметр url_username не указан, параметр url_password не будет использован. | |
| url_username строка | Имя пользователя для использования в аутентификации HTTP по принципу «пользователь/пароль». Этот параметр может использоваться без url_password для сайтов, допускающих пустые пароли | |
| use_gssapi логический добавлен в 2.11 ansible.builtin |
| Использовать GSSAPI для выполнения аутентификации, обычно это для аутентификации Kerberos или Kerberos через Negotiate. Требуется установка Python библиотеки gssapi. Учетные данные для GSSAPI можно указать с помощью url_username/url_password или с помощью переменной окружения GSSAPI KRB5CCNAME, которая определяет пользовательский кэш учетных данных Kerberos.Аутентификация NTLM not поддерживается, даже если механизм GSSAPI для NTLM установлен. |
| use_proxy логический |
| Если no, прокси не будет использоваться, даже если она определена в переменной окружения на целевых хостах. |
| users список / элементы=строка | Пользователи, которые должны получать уведомления об этом уведомлении. | |
| validate_certs логический |
| Если no, сертификаты SSL не будут проверены.Это следует использовать только на сайтах, контролируемых вами, использующих самозаверяющие сертификаты. |
| vars словарь добавлен в 1.9.0 t_systems_mms.icinga_director | Пользовательские свойства уведомления. |
Примечания
Примечание
- Этот модуль поддерживает режим проверки.
Примеры
- name: Create notification
t_systems_mms.icinga_director.icinga_notification:
state: present
url: "{{ icinga_url }}"
url_username: "{{ icinga_user }}"
url_password: "{{ icinga_pass }}"
apply_to: host
assign_filter: 'host.name="foohost"'
imports:
- foonotificationtemplate
notification_interval: '0'
object_name: E-Mail_host
states:
- Up
- Down
types:
- Problem
- Recovery
users:
- rb
disabled: false
vars:
foo: bar
Авторы
- Sebastian Gumprich (@rndmh3ro)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/t_systems_mms/icinga_director/icinga_notification_module.html
