модуль telekom_mms.icinga_director.icinga_host_template — управление шаблонами узлов в 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_host_template.
Добавлено в telekom_mms.icinga_director 1.2.0
Краткое описание
- Добавление или удаление шаблона узла в Icinga2 с помощью API Director.
Параметры
Параметр | Комментарии |
|---|---|
accept_config boolean добавлено в telekom_mms.icinga_director 1.9.0 | Настроен ли агент на прием конфигурации. Варианты:
|
address string | Адрес узла. Обычно это адрес IPv4, но может быть адресом любого типа, с которым способен работать ваш плагин проверки. |
address6 string | IPv6-адрес узла. Обычно это адрес IPv6, но может быть адресом любого типа, с которым способен работать ваш плагин проверки. |
api_timeout integer | Тайм-аут по умолчанию в секундах для ожидания завершения транзакции. По умолчанию: |
append boolean добавлено в telekom_mms.icinga_director 1.25.0 | Не перезаписывать весь объект, а добавлять указанные свойства. Примечание. Невозможно добавить значения к существующим vars, imports и другим спискам или словарям. Необходимо перезаписать список или словарь целиком. Примечание. Также будут применены переменные, заданные по умолчанию, даже если они не указаны. Варианты:
|
check_command string | Имя команды проверки. Хотя ее не обязательно определять в Director, параметр check_command все равно необходимо указать для узла или шаблона узла. |
check_interval string | Интервал регулярных проверок. |
check_period string | Имя периода времени, определяющего, когда следует отслеживать этот объект. По умолчанию ограничений нет. |
check_timeout string | Тайм-аут команды проверки в секундах. Переопределяет атрибут timeout команды CheckCommand. |
client_cert path | Файл цепочки сертификатов в формате PEM для аутентификации клиента SSL. Этот файл также может содержать ключ. Если ключ включен, параметр |
client_key path | Файл в формате PEM с закрытым ключом для аутентификации клиента SSL. Если |
command_endpoint string | Конечная точка, на которой выполняются команды. |
disabled boolean | Отключенные объекты не будут развернуты. Варианты:
|
display_name string | Альтернативное имя узла. Это может быть псевдоним узла или любая строка, помогающая пользователям распознать этот узел. |
enable_active_checks boolean | Следует ли активно проверять этот объект. Варианты:
|
enable_event_handler boolean | Следует ли включить обработчики событий для этого объекта. Варианты:
|
enable_flapping boolean | Включено ли обнаружение нестабильного состояния для этого объекта. Варианты:
|
enable_notifications boolean | Следует ли отправлять уведомления для этого объекта. Варианты:
|
enable_passive_checks boolean | Следует ли принимать результаты пассивных проверок для этого объекта. Варианты:
|
enable_perfdata boolean | Следует ли обрабатывать данные о производительности, предоставляемые этим объектом. Варианты:
|
event_command string | Команда события для узла, которая выполняется при каждой проверке, если выполняется одно из следующих условий: узел находится в мягком состоянии; состояние узла меняется на жесткое; состояние узла восстанавливается из мягкого или жесткого в OK/Up. |
flapping_threshold_high string | Верхний порог нестабильности в процентах, при превышении которого служба считается нестабильной. |
flapping_threshold_low string | Нижний порог нестабильности в процентах, ниже которого служба считается стабильной. |
force boolean | Если Варианты:
|
force_basic_auth boolean | Учетные данные, указанные с помощью Варианты:
|
groups list / элементы=string | Группы узлов, которые следует непосредственно назначить этому узлу. Группы узлов могут быть полезны по разным причинам. Можно назначать проверки служб на основе назначенной группы узлов. Их также часто используют для настройки ограниченного доступа к представлениям в Icinga Web 2. Группы узлов можно назначать непосредственно отдельным узлам или шаблонам узлов. Также можно назначать группы узлов с помощью правил apply. По умолчанию: |
has_agent boolean добавлено в telekom_mms.icinga_director 1.9.0 | Установлен ли на этом узле агент Icinga 2. Варианты:
|
http_agent string | Значение заголовка для идентификации; обычно отображается в журналах веб-сервера. По умолчанию: |
icon_image string | URL-адрес значка для этого объекта. Для значков из каталога public/img/icons попробуйте указать «tux.png», а для значков из шрифта значков Icinga — «cloud» (без расширения). |
icon_image_alt string | Альтернативный текст, отображаемый, если указанный выше значок отсутствует. |
imports list / элементы=string | Выберите шаблон узла. |
master_should_connect boolean добавлено в telekom_mms.icinga_director 1.9.0 | Должен ли родительский узел (master) активно пытаться подключиться к этому агенту. Варианты:
|
max_check_attempts string | Определяет, после какого количества попыток проверки устанавливается новое жесткое состояние. |
notes string добавлено в telekom_mms.icinga_director 1.8.0 | Дополнительные примечания к этому объекту. |
notes_url string добавлено в telekom_mms.icinga_director 1.8.0 | URL-адрес дополнительных примечаний к этому объекту. Несколько URL-адресов указываются так: «’http://url1’ ‘http://url2’». Максимальная длина — 255 символов. |
object_name псевдонимы: name string / обязательный | Имя объекта Icinga для этого шаблона узла. Обычно это полное доменное имя узла, но в принципе это может быть строка любого вида. Чтобы упростить работу пользователям, настоятельно рекомендуем использовать содержательные имена шаблонов. Например, «generic-host» — неудачное имя, а «Стандартный сервер Linux» понятнее. |
retry_interval string | Интервал повторной проверки, применяемый после изменения состояния, если следующее жесткое состояние еще не достигнуто. |
state string | Применить состояние функции. Варианты:
|
url string / обязательный | URL-адрес HTTP, HTTPS или FTP в формате (http|https|ftp)://[user[:pass]]@host.domain[:port]/path |
url_password string | Пароль для базовой HTTP-аутентификации. Если параметр |
url_username string | Имя пользователя для базовой HTTP-аутентификации. Этот параметр можно использовать без |
use_gssapi boolean добавлено в ansible-core 2.11 | Использовать GSSAPI для аутентификации; обычно этот параметр применяется для Kerberos или аутентификации Kerberos через Negotiate. Для этого необходимо установить библиотеку Python gssapi. Учетные данные GSSAPI можно указать с помощью Аутентификация NTLM не поддерживается, даже если установлен механизм GSSAPI для NTLM. Варианты:
|
use_proxy boolean | Если Варианты:
|
validate_certs boolean | Если Этот параметр следует использовать только на подконтрольных вам сайтах с самоподписанными сертификатами. Варианты:
|
vars dictionary | Пользовательские свойства узла. |
volatile boolean | Является ли эта проверка нестабильной. Варианты:
|
zone string | Задать зону. |
Примечания
Примечание
- Этот модуль поддерживает режим проверки.
Примеры
- name: Create host template
telekom_mms.icinga_director.icinga_host_template:
state: present
url: "{{ icinga_url }}"
url_username: "{{ icinga_user }}"
url_password: "{{ icinga_pass }}"
accept_config: true
check_command: hostalive
check_interval: 90s
check_timeout: 60
command_endpoint: fooendpoint
disabled: false
display_name: foohosttemplate
enable_active_checks: true
enable_event_handler: false
enable_flapping: false
enable_notifications: true
enable_passive_checks: false
enable_perfdata: false
flapping_threshold_high: "30.0"
flapping_threshold_low: "25.0"
has_agent: true
icon_image_alt: "alt text"
icon_image: "http://url1"
master_should_connect: true
max_check_attempts: 3
object_name: foohosttemplate
retry_interval: "1m"
volatile: false
groups:
- "foohostgroup"
imports:
- ''
vars:
dnscheck: "no"
- name: Update host template
telekom_mms.icinga_director.icinga_host_template:
state: present
url: "{{ icinga_url }}"
url_username: "{{ icinga_user }}"
url_password: "{{ icinga_pass }}"
object_name: foohosttemplate
notes: "example note"
notes_url: "'http://url1' 'http://url2'"
append: true
Ссылки на коллекцию
© 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_host_template_module.html