telekom_mms.icinga_director.icinga_host модуль — Управление хостами в 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_host.

Новая функция в telekom_mms.icinga_director 1.0.0

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

Обзор

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

Параметры

Параметр	Комментарии
accept_config boolean добавлено в telekom_mms.icinga_director 1.9.0	Настроен ли агент на прием конфигурации. Варианты: `false` `true`
address string	Адрес хоста. Обычно это IPv4-адрес, но это может быть любой тип адреса, с которым может работать ваш плагин проверки.
address6 string добавлено в telekom_mms.icinga_director 1.4.0	IPv6-адрес хоста. Обычно это IPv6-адрес, но это может быть любой тип адреса, с которым может работать ваш плагин проверки.
append boolean добавлено в telekom_mms.icinga_director 1.25.0	Не перезаписывать весь объект, а добавлять определенные свойства. Примечание. Добавление к существующим переменным, импортам или любому другому списку/словарю невозможно. Вам нужно перезаписать весь список/словарь. Примечание. Переменные, установленные по умолчанию, также будут применены, даже если они не установлены. Варианты: `false` `true`
check_command string	Имя команды проверки. Хотя это не обязательно определять в директоре, вы все равно должны указать check_command в хосте или шаблоне хоста.
check_interval string	Ваш обычный интервал проверки.
check_period string	Имя временного периода, который определяет, когда этот объект должен контролироваться. Не ограничен по умолчанию.
check_timeout string	Тайм-аут команды проверки в секундах. Переопределяет атрибут тайм-аута CheckCommand.
client_cert path	Файл цепочки сертификатов в формате PEM, который будет использоваться для проверки подлинности клиента SSL. Этот файл также может включать ключ, и если ключ включен, `client_key` не требуется.
client_key path	Файл в формате PEM, содержащий ваш закрытый ключ, который будет использоваться для проверки подлинности клиента SSL. Если `client_cert` содержит и сертификат, и ключ, этот параметр не требуется.
command_endpoint string	Конечная точка, на которой выполняются команды.
disabled boolean	Отключенные объекты не будут развернуты. Варианты: `false` ← (по умолчанию) `true`
display_name string	Альтернативное имя для этого хоста. Это может быть псевдоним хоста или строка, помогающая вашим пользователям идентифицировать этот хост.
enable_active_checks boolean	Следует ли активно проверять этот объект. Варианты: `false` `true`
enable_event_handler boolean	Следует ли включать обработчики событий для этого объекта. Варианты: `false` `true`
enable_flapping boolean	Включено ли обнаружение флаттеринга для этого объекта. Варианты: `false` `true`
enable_notifications boolean	Следует ли отправлять уведомления для этого объекта. Варианты: `false` `true`
enable_passive_checks boolean	Следует ли принимать результаты пассивной проверки для этого объекта. Варианты: `false` `true`
enable_perfdata boolean	Следует ли обрабатывать данные производительности, предоставленные этим объектом. Варианты: `false` `true`
event_command string	Команда события для хоста, которая вызывается при каждом выполнении проверки, если одно из этих условий выполняется Хост находится в мягком состоянии Состояние хоста изменяется на жесткое состояние Состояние хоста восстанавливается из мягкого или жесткого состояния в OK/Up

flapping_threshold_high string	Верхняя граница флаттеринга в процентах для сервиса, который считается флаттерирующим
flapping_threshold_low string	Нижняя граница флаттеринга в процентах для сервиса, который считается не флаттерирующим
force boolean	Если `yes`, не получать кэшированную копию. Варианты: `false` ← (по умолчанию) `true`
force_basic_auth boolean	Учётные данные, указанные с помощью `url_username` и `url_password`, должны передаваться в HTTP-заголовке. Варианты: `false` ← (по умолчанию) `true`
groups list / elements=string	Группы хостов, которые должны быть непосредственно назначены этому узлу. Группы хостов могут быть полезны по разным причинам. Вы можете назначать проверки сервисов на основе назначенной группы хостов. Они также часто используются в качестве инструмента для обеспечения ограниченных представлений в Icinga Web 2. Группы хостов могут быть непосредственно назначены отдельным хостам или шаблонам хостов. Вы также можете рассмотреть возможность назначения групп хостов с помощью правил применения. Значение по умолчанию: `[]`
has_agent boolean добавлено в telekom_mms.icinga_director 1.9.0	Есть ли на этом хосте установленный агент Icinga 2. Варианты: `false` `true`
http_agent string	Заголовок для идентификации, обычно отображается в логах веб-сервера. Значение по умолчанию: `"ansible-httpget"`
icon_image string	URL, указывающий на значок для этого объекта. Попробуйте «tux.png» для значков относительно public/img/icons или «cloud» (без расширения) для элементов из шрифта значков Icinga
icon_image_alt string	Альтернативный текст, который будет показан, если указанный выше значок отсутствует
imports list / elements=string	Выберите шаблон хоста. Обязательно, если состояние `present`. Обязательно, если state `present`.
master_should_connect boolean добавлено в telekom_mms.icinga_director 1.9.0	Должен ли родительский (главный) узел активно пытаться подключиться к этому агенту. Варианты: `false` `true`
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» выглядит некрасиво, а «Standard Linux Server» проще понять.
retry_interval string	Интервал повтора, будет применяться после изменения состояния, если не достигнуто следующее жёсткое состояние.
state string	Применить состояние функции. Варианты: `"present"` ← (по умолчанию) `"absent"`
url string / обязательно	HTTP, HTTPS или FTP URL в формате (http\|https\|ftp)://[user[:pass]]@host.domain[:port]/path
url_password string	Пароль для использования в HTTP-авторизации. Если параметр `url_username` не указан, параметр `url_password` использоваться не будет.

url_username string	Имя пользователя для использования в аутентификации HTTP basic. Этот параметр может быть использован без `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` ← (по умолчанию)
validate_certs boolean	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых вами сайтах, использующих самозаверенные сертификаты. Варианты: `false` `true` ← (по умолчанию)
vars dictionary	Настраиваемые свойства хоста.
volatile boolean	Является ли этот чек изменчивым. Варианты: `false` `true`
zone string	Установить зону.

Примечания

Примечание

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

Примеры

- name: Create a host in icinga
  telekom_mms.icinga_director.icinga_host:
    state: present
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    accept_config: true
    address: "127.0.0.1"
    address6: "::1"
    check_command: hostalive
    check_interval: 90s
    check_timeout: 60
    command_endpoint: fooendpoint
    disabled: false
    display_name: "foohost"
    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: "foohost"
    retry_interval: "1m"
    volatile: false
    groups:
      - "foohostgroup"
    imports:
      - "foohosttemplate"
    vars:
      dnscheck: "no"

- name: update a host in icinga
  telekom_mms.icinga_director.icinga_host:
    state: present
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    object_name: "foohost"
    notes: "example note"
    notes_url: "'http://url1' 'http://url2'"
    append: true

Авторы

Sebastian Gumprich (@rndmh3ro)

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

© 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_host_module.html