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

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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 Director.

Параметры

Параметр	Комментарии
api_timeout integer	Время ожидания завершения транзакции по умолчанию, в секундах. По умолчанию: `10`
append boolean добавлено в telekom_mms.icinga_director 1.25.0	Не перезаписывать весь объект, а добавлять заданные свойства. Примечание. Добавлять элементы в существующие vars, imports или любой другой список/словарь невозможно. Необходимо перезаписывать весь список/словарь. Примечание. Также будут применены переменные, заданные по умолчанию, даже если они не указаны. Варианты: `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 / элементы=string	Импортируемые шаблоны; можно добавить любое количество. Обязательно, если state равно `present`. Обратите внимание: при импорте свойств из нескольких шаблонов важен порядок — при конфликте используется значение из последнего шаблона. Обязательно, если state равно `present`.
notification_interval integer	Интервал уведомлений (в секундах). Этот интервал используется для активных уведомлений. По умолчанию — 30 минут. Если задано значение 0, повторные уведомления отключаются.
object_name псевдонимы: name string / обязательный	Имя уведомления.
period псевдонимы: time_period string добавлено в telekom_mms.icinga_director 1.15.0	Имя периода времени, определяющего, когда следует отправлять это уведомление.
state string	Задаёт состояние функции. Варианты: `"present"` ← (по умолчанию) `"absent"`
states list / элементы=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 / элементы=string	Типы переходов состояния, о которых требуется получать уведомления.
url string / обязательный	URL HTTP, HTTPS или FTP в формате (http\|https\|ftp)://[user[:pass]]@host.domain[:port]/path
url_password string	Пароль для базовой HTTP-аутентификации. Если параметр `url_username` не указан, параметр `url_password` использоваться не будет.
url_username string	Имя пользователя для базовой HTTP-аутентификации. Этот параметр можно использовать без `url_password` для сайтов, допускающих пустые пароли.
use_gssapi boolean добавлено в 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 boolean	Если `no`, прокси использоваться не будет, даже если он задан в переменной среды на целевых узлах. Варианты: `false` `true` ← (по умолчанию)
user_groups list / элементы=string добавлено в telekom_mms.icinga_director 1.16.0	Группы пользователей, которые должны получать это уведомление. По умолчанию: `[]`
users list / элементы=string	Пользователи, которые должны получать это уведомление.
validate_certs boolean	Если `no`, SSL-сертификаты проверяться не будут. Этот параметр следует использовать только на сайтах под личным контролем, где применяются самоподписанные сертификаты. Варианты: `false` `true` ← (по умолчанию)
vars dictionary добавлено в 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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/telekom_mms/icinga_director/icinga_notification_module.html