telekom_mms.icinga_director.icinga_notification модуль – Управление уведомлениями в Icinga2

Примечание

Этот модуль входит в состав коллекции telekom_mms.icinga_director (версия 2.1.2).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

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

Чтобы использовать его в плейбуке, укажите: telekom_mms.icinga_director.icinga_notification.

Новое в telekom_mms.icinga_director 1.0.0

Обзор
Параметры
Примечания
Примеры

Обзор

Добавление или удаление уведомления в Icinga2 через API директора.

Параметры

Параметр	Комментарии
append boolean добавлен в telekom_mms.icinga_director 1.25.0	Не перезаписывать весь объект, а вместо этого добавлять определённые свойства. Примечание - Добавление в существующие переменные, импорты или любые другие списки/словари невозможно. Вам необходимо перезаписать весь список/словарь. Примечание - Переменные, которые устанавливаются по умолчанию, также будут применяться, даже если они не установлены. Варианты: `false` `true`
apply_to string	Определяет, должны ли уведомления влиять на хосты или службы. Требуется, если state равен `present`. Варианты: `"host"` `"service"`
assign_filter string	Фильтр, в котором уведомление будет действовать.
client_cert path	Файл цепочки сертификатов в формате PEM, используемый для аутентификации SSL клиента. Этот файл также может включать ключ, и если ключ включён, `client_key` не требуется.
client_key path	Файл в формате PEM, содержащий ваш закрытый ключ, используемый для аутентификации SSL клиента. Если `client_cert` содержит и сертификат, и ключ, этот параметр не требуется.
disabled boolean добавлен в telekom_mms.icinga_director 1.9.0	Отключенные объекты не будут развернуты. Варианты: `false` ← (по умолчанию) `true`
force boolean	Если `yes`, не получать кэшированную копию. Варианты: `false` ← (по умолчанию) `true`
force_basic_auth boolean	Указанные с помощью `url_username` и `url_password` учетные данные должны передаваться в заголовке HTTP. Варианты: `false` ← (по умолчанию) `true`
http_agent string	Заголовок, используемый для идентификации, обычно отображается в журналах веб-сервера. Значение по умолчанию: `"ansible-httpget"`
imports list / elements=string	Импортируемые шаблоны, можно добавить любое количество. Требуется, когда состояние равно `present`. Обратите внимание, что порядок имеет значение при импорте свойств из нескольких шаблонов - последний шаблон имеет приоритет. Требуется, если state равен `present`.
notification_interval integer	Интервал уведомлений (в секундах). Этот интервал используется для активных уведомлений. По умолчанию 30 минут. Если установлено значение 0, повторные уведомления отключены.
object_name aliases: name string / обязательно	Имя уведомления.
period aliases: time_period string добавлен в telekom_mms.icinga_director 1.15.0	Название временного интервала, определяющего, когда должно быть сгенерировано это уведомление.
state string	Состояние функциональности. Варианты: `"present"` ← (по умолчанию) `"absent"`
states list / elements=string добавлен в telekom_mms.icinga_director 1.9.0	Состояния хоста или службы, для которых вы хотите получать уведомления.
times_begin integer добавлен в telekom_mms.icinga_director 1.15.0	Задержка первого уведомления. Задержка, если первое уведомление должно быть отправлено.
times_end integer добавлен в telekom_mms.icinga_director 1.15.0	Последнее уведомление. Когда должно быть отправлено последнее уведомление.
types list / elements=string	Типы переходов состояния, для которых вы хотите получать уведомления.

url строка / обязательно	URL HTTP, HTTPS или FTP в формате (http\|https\|ftp)://[пользователь[:пароль]]@хост.домен[:порт]/путь
url_password строка	Пароль для использования в аутентификации HTTP Basic. Если параметр `url_username` не указан, параметр `url_password` не будет использован.
url_username строка	Имя пользователя для использования в аутентификации HTTP Basic. Этот параметр может быть использован без `url_password` для сайтов, допускающих пустые пароли
use_gssapi логическое добавлен в ansible-core 2.11	Использовать GSSAPI для выполнения аутентификации, обычно для аутентификации Kerberos или Kerberos через Negotiate. Требуется установка библиотеки Python gssapi. Данные для GSSAPI можно указать с `url_username`/`url_password` или с переменной окружения GSSAPI `KRB5CCNAME`, которая определяет пользовательский кэш аутентификации Kerberos. Аутентификация NTLM не поддерживается, даже если механизм GSSAPI для NTLM был установлен. Варианты: `false` ← (по умолчанию) `true`
use_proxy логическое	Если `no`, прокси не будет использован, даже если он определён в переменной окружения на целевых хостах. Варианты: `false` `true` ← (по умолчанию)
user_groups список / элементы=строка добавлен в telekom_mms.icinga_director 1.16.0	Группы пользователей, которые должны быть уведомлены этим уведомлением. По умолчанию: `[]`
users список / элементы=строка	Пользователи, которые должны быть уведомлены этим уведомлением.
validate_certs логическое	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на сайтах с самостоятельным контролем, использующих самозаверяемые сертификаты. Варианты: `false` `true` ← (по умолчанию)
vars словарь добавлен в telekom_mms.icinga_director 1.9.0	Настраиваемые свойства уведомления. По умолчанию: `{}`

Примечания

Примечание

Этот модуль поддерживает режим проверки.

Примеры

- name: Create notification
  telekom_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
    user_groups:
      - OnCall
    disabled: false
    time_period: "24/7"
    times_begin: 20
    times_end: 120

- name: Create another notification
  telekom_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
    time_period: "24/7"

- name: Update notification
  telekom_mms.icinga_director.icinga_notification:
    state: present
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    object_name: E-Mail_host
    vars:
      foo: bar
    append: true

Авторы

Sebastian Gumprich (@rndmh3ro) / Sebastian Gruber (sgruber94)

Ссылки на сборку

© 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/telekom_mms/icinga_director/icinga_notification_module.html