Spec-Zone.ru › Ansible

модуль 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

Настроен ли агент на прием конфигурации.

Варианты:

  • false
  • true

address

string

Адрес узла. Обычно это адрес IPv4, но может быть адресом любого типа, с которым способен работать ваш плагин проверки.

address6

string

IPv6-адрес узла. Обычно это адрес IPv6, но может быть адресом любого типа, с которым способен работать ваш плагин проверки.

api_timeout

integer

Тайм-аут по умолчанию в секундах для ожидания завершения транзакции.

По умолчанию: 10

append

boolean

добавлено в telekom_mms.icinga_director 1.25.0

Не перезаписывать весь объект, а добавлять указанные свойства.

Примечание. Невозможно добавить значения к существующим vars, imports и другим спискам или словарям. Необходимо перезаписать список или словарь целиком.

Примечание. Также будут применены переменные, заданные по умолчанию, даже если они не указаны.

Варианты:

  • false
  • true

check_command

string

Имя команды проверки.

Хотя ее не обязательно определять в Director, параметр check_command все равно необходимо указать для узла или шаблона узла.

check_interval

string

Интервал регулярных проверок.

check_period

string

Имя периода времени, определяющего, когда следует отслеживать этот объект. По умолчанию ограничений нет.

check_timeout

string

Тайм-аут команды проверки в секундах. Переопределяет атрибут timeout команды 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 / элементы=string

Группы узлов, которые следует непосредственно назначить этому узлу. Группы узлов могут быть полезны по разным причинам.

Можно назначать проверки служб на основе назначенной группы узлов. Их также часто используют для настройки ограниченного доступа к представлениям в Icinga Web 2.

Группы узлов можно назначать непосредственно отдельным узлам или шаблонам узлов.

Также можно назначать группы узлов с помощью правил apply.

По умолчанию: []

has_agent

boolean

добавлено в telekom_mms.icinga_director 1.9.0

Установлен ли на этом узле агент Icinga 2.

Варианты:

  • false
  • true

http_agent

string

Значение заголовка для идентификации; обычно отображается в журналах веб-сервера.

По умолчанию: "ansible-httpget"

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) активно пытаться подключиться к этому агенту.

Варианты:

  • 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» — неудачное имя, а «Стандартный сервер Linux» понятнее.

retry_interval

string

Интервал повторной проверки, применяемый после изменения состояния, если следующее жесткое состояние еще не достигнуто.

state

string

Применить состояние функции.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

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 ← (по умолчанию)

validate_certs

boolean

Если no, SSL-сертификаты проверяться не будут.

Этот параметр следует использовать только на подконтрольных вам сайтах с самоподписанными сертификатами.

Варианты:

  • false
  • true ← (по умолчанию)

vars

dictionary

Пользовательские свойства узла.

volatile

boolean

Является ли эта проверка нестабильной.

Варианты:

  • false
  • true

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

Авторы

  • Michaela Mattes (@michaelamattes)

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API