роль telekom_mms.icinga_director.ansible_icinga – Настройка экземпляра Icinga с помощью Icinga Director

icinga_client_cert

path

Файл цепочки сертификатов в формате PEM для аутентификации SSL-клиента. Этот файл также может содержать ключ; если ключ включён, параметр `client_key’ указывать не требуется.

icinga_client_key

path

Файл в формате PEM, содержащий закрытый ключ для аутентификации SSL-клиента. Если `client_cert’ содержит и сертификат, и ключ, этот параметр указывать не требуется.

icinga_url

string

URL HTTP, HTTPS или FTP в формате (http|https|ftp)://[user[:pass]]@host.domain[:port]/path

icinga_url_password

string

Пароль для базовой аутентификации HTTP. Если параметр `url_username’ не указан, параметр `url_password’ использоваться не будет.

icinga_url_username

string

Имя пользователя для базовой аутентификации HTTP. Этот параметр можно использовать без `url_password’ на сайтах, допускающих пустые пароли.

icinga_use_gssapi

boolean

Использовать GSSAPI для аутентификации; обычно это Kerberos или Kerberos с аутентификацией Negotiate. Для этого требуется установленная библиотека Python gssapi <https://github.com/pythongssapi/python- gssapi>. Учётные данные для GSSAPI можно указать с помощью `url_username’/`url_password’ или переменной среды GSSAPI `KRB5CCNAME’, задающей пользовательский кэш учётных данных Kerberos. Аутентификация NTLM «не» поддерживается, даже если установлен механизм GSSAPI для NTLM.

Варианты:

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

icinga_use_proxy

boolean

Если задано значение `no’, прокси использоваться не будет, даже если он указан в переменной среды на целевых узлах.

Варианты:

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

icinga_validate_certs

boolean

Если задано значение `no’, SSL-сертификаты проверяться не будут. icinga_Этот параметр следует использовать только на сайтах под личным контролем, где применяются самоподписанные сертификаты.

Варианты:

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

icinga_command_templates

list / elements=string

Список шаблонов команд Icinga, которые необходимо настроить

arguments

dictionary

Аргументы шаблона команды.

command

string

Команда, которую должна выполнить Icinga.

Абсолютные пути принимаются без изменений, к относительным путям добавляется префикс «PluginDir + », также допускаются аналогичные префиксы Constant.

Пробелы разделяют путь к команде и отдельные аргументы.

Обратите внимание: в настоящее время пробелы в именах и путях плагинов не поддерживаются.

command_type

string

Команды проверки плагинов нужны для выполнения проверок вашей инфраструктуры.

Команды уведомлений используются для отправки уведомлений пользователям.

Команды событий позволяют запускать определённые действия при возникновении проблем.

Некоторые используют их для механизмов автоматического восстановления, например для перезапуска служб или перезагрузки систем при достижении определённых пороговых значений.

Варианты:

• "PluginCheck" ← (по умолчанию)
• "PluginNotification"
• "PluginEvent"

disabled

boolean

Отключённые объекты не будут развернуты.

Варианты:

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

imports

list / elements=string

Импортируемые шаблоны: добавьте столько, сколько нужно. Обратите внимание: при импорте свойств из нескольких шаблонов важен порядок — значение из последнего шаблона имеет приоритет.

name

string / обязательный

Имя шаблона команды.

state

string

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

Варианты:

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

timeout

string

Необязательный тайм-аут команды. Допустимые значения — секунды или длительность с указанием единицы измерения (например, 1m или 3m 30s).

vars

dictionary

Пользовательские свойства шаблона команды.

zone

string

Зона кластера Icinga. Позволяет вручную переопределить решения Director о том, куда развернуть вашу конфигурацию.

Не рекомендуется это делать, если вы не разобрались досконально в работе кластера Icinga.

icinga_commands

list / elements=string

Список команд Icinga, которые необходимо настроить

arguments

dictionary

Аргументы команды.

command

string

Команда, которую должна выполнить Icinga. Обязательна, если state имеет значение present.

Абсолютные пути принимаются без изменений, к относительным путям добавляется префикс «PluginDir + », также допускаются аналогичные префиксы Constant.

Пробелы разделяют путь к команде и отдельные аргументы.

Обратите внимание: в настоящее время пробелы в именах и путях плагинов не поддерживаются.

command_type

string

Команды проверки плагинов нужны для выполнения проверок вашей инфраструктуры.

Команды уведомлений используются для отправки уведомлений пользователям.

Команды событий позволяют запускать определённые действия при возникновении проблем.

Некоторые используют их для механизмов автоматического восстановления, например для перезапуска служб или перезагрузки систем при достижении определённых пороговых значений.

Варианты:

• "PluginCheck" ← (по умолчанию)
• "PluginNotification"
• "PluginEvent"

disabled

boolean

Отключённые объекты не будут развернуты.

Варианты:

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

imports

list / elements=string

Импортируемые шаблоны: добавьте столько, сколько нужно. Обратите внимание: при импорте свойств из нескольких шаблонов важен порядок — значение из последнего шаблона имеет приоритет.

name

string / обязательный

Имя команды.

state

string

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

Варианты:

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

timeout

string

Необязательный тайм-аут команды. Допустимые значения — секунды или длительность с указанием единицы измерения (например, 1m или 3m 30s).

vars

dictionary

Пользовательские свойства команды.

zone

string

Зона кластера Icinga. Позволяет вручную переопределить решения Director о том, куда развернуть вашу конфигурацию.

Не рекомендуется это делать, если вы не разобрались досконально в работе кластера Icinga.

icinga_endpoints

list / elements=string

Список конечных точек Icinga, которые необходимо настроить

host

string

Имя хоста/IP-адрес удалённого экземпляра Icinga 2.

log_duration

string

Период хранения журналов повторного воспроизведения при потере соединения. По умолчанию — 1d (86400 секунд). Атрибут задаётся в секундах. Если log_duration равен 0, повторное воспроизведение журналов отключено. Также можно указать значение в удобочитаемом формате, например 10m (10 минут) или 1h (1 час).

name

string / обязательный

Имя объекта Icinga для этой конечной точки.

Обычно это полное доменное имя хоста, но в принципе это может быть строка любого вида.

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

Например, «generic-endpoint» — неудачное имя, а «Standard Linux Server» проще для понимания.

port

integer

Имя службы/порт удалённого экземпляра Icinga 2. По умолчанию — 5665.

state

string

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

Варианты:

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

zone

string

Имя зоны, к которой относится эта конечная точка.

icinga_host_templates

list / elements=string

Список шаблонов хостов Icinga, которые необходимо настроить

accept_config

boolean

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

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

Варианты:

• false
• true

address

string

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

address6

string

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

check_command

string

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

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

check_interval

string

Обычный интервал проверок.

disabled

boolean

Отключённые объекты не будут развернуты.

Варианты:

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

display_name

string

Альтернативное имя этого хоста.

Это может быть псевдоним хоста или любая строка, помогающая пользователям идентифицировать этот хост.

event_command

string

Команда события для хоста, вызываемая при каждом выполнении проверки, если выполняется одно из следующих условий:

Хост находится в мягком состоянии

Состояние хоста переходит в жёсткое состояние

Состояние хоста восстанавливается из мягкого или жёсткого состояния до OK/Up

groups

list / elements=string

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

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

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

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

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

has_agent

boolean

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

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

Варианты:

• false
• true

imports

list / elements=string

Выберите шаблон хоста.

master_should_connect

boolean

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

Должен ли родительский узел (master) активно пытаться подключиться к этому агенту.

Варианты:

• false
• true

name

string / обязательный

Имя объекта Icinga для этого шаблона хоста.

Обычно это полное доменное имя хоста, но в принципе это может быть строка любого вида.

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

Например, «generic-host» — неудачное имя, а «Standard Linux Server» проще для понимания.

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 символов.

state

string

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

Варианты:

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

vars

dictionary

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

zone

string

Задайте зону.

icinga_hostgroups

list / elements=string

Список групп хостов Icinga, которые необходимо настроить

assign_filter

string

Позволяет настроить фильтр назначения.

Можно использовать любое количество вложенных операторов.

display_name

string

Альтернативное отображаемое имя этой группы.

Если вы не знаете, чем это может быть полезно, оставьте поле пустым.

name

string / обязательный

Имя объекта Icinga для этой группы хостов.

state

string

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

Варианты:

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

icinga_hosts

list / elements=string

Список узлов Icinga для настройки

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-адрес, но может быть адресом любого типа, с которым может работать ваш плагин проверки.

check_command

string

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

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

disabled

boolean

Отключённые объекты не развёртываются.

Варианты:

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

display_name

string

Альтернативное имя этого узла. Это может быть псевдоним узла или любая строка, помогающая пользователям идентифицировать этот узел.

groups

list / elements=string

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

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

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

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

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

has_agent

boolean

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

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

Варианты:

• false
• true

imports

list / elements=string / обязательный

Выберите шаблон узла. Обязательно, если state имеет значение present.

master_should_connect

boolean

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

Должен ли родительский (master) узел активно пытаться подключиться к этому агенту.

Варианты:

• false
• true

name

string / обязательный

Имя объекта Icinga для этого узла.

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

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

Например, «generic-host» — неудачное имя, а «Стандартный сервер Linux» понятнее.

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 символов.

state

string

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

Варианты:

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

vars

dictionary

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

zone

string

Задать зону.

icinga_notifications

list / elements=string

Список уведомлений Icinga для настройки

apply_to

string / обязательный

На узлы или службы должно распространяться это уведомление.

Варианты:

• "host"
• "service"

assign_filter

string

Фильтр, определяющий, на какие объекты будет распространяться уведомление.

disabled

boolean

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

Отключённые объекты не развёртываются.

Варианты:

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

imports

list / elements=string

Шаблоны для импорта; можно добавить любое их количество. Обязательно, если state имеет значение present.

Обратите внимание: при импорте свойств из нескольких шаблонов важен порядок — значение из последнего шаблона имеет приоритет.

name

string / обязательный

Имя уведомления.

notification_interval

string

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

По умолчанию — 30 минут. Если указать 0, повторные уведомления будут отключены.

state

string

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

Варианты:

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

states

list / elements=string

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

Состояния узла или службы, о которых нужно получать уведомления.

time_period

string

добавлено в telekom_mms.icinga_director 1.15.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

Типы переходов между состояниями, о которых нужно получать уведомления.

user_groups

list / elements=string

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

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

users

list / elements=string

Пользователи, которым следует отправлять это уведомление.

vars

dictionary

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

Пользовательские свойства уведомления.

icinga_service_applies

list / elements=string

Список правил apply для служб Icinga, которые нужно настроить

apply_for

string

Применяет правило apply ко всем объектам с указанным пользовательским атрибутом.

Например, выбор «host.vars.custom_attr» сформирует «for (config in host.vars.array_var)», где к «config» можно будет обратиться через «$config$».

Примечание: допускаются только пользовательские переменные типа «Array».

assign_filter

string

Фильтр, определяющий, к каким объектам будет применяться правило службы.

check_command

string

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

Определение команды проверки.

check_interval

string

Обычный интервал проверки.

check_period

string

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

check_timeout

string

Тайм-аут команды проверки в секундах. Переопределяет атрибут timeout команды CheckCommand.

command_endpoint

string

Узел, на котором должна выполняться служба.

display_name

string

Альтернативное отображаемое имя правила apply для службы.

enable_active_checks

boolean

Следует ли активно проверять этот объект.

Варианты:

• false
• true

enable_event_handler

boolean

Следует ли включить обработчики событий для этого объекта.

Варианты:

• false
• true

enable_notifications

boolean

Следует ли отправлять уведомления для этого объекта.

Варианты:

• false
• true

enable_passive_checks

boolean

Принимать ли результаты пассивных проверок для этого объекта.

Варианты:

• false
• true

enable_perfdata

boolean

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

Варианты:

• false
• true

groups

list / elements=string

Группы служб, которые нужно напрямую назначить этой службе.

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

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

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

imports

list / elements=string

Шаблоны для импорта; можно добавить любое их количество.

Обратите внимание: при импорте свойств из нескольких шаблонов важен порядок — значение из последнего шаблона имеет приоритет.

max_check_attempts

string

Определяет, после какого количества попыток проверки устанавливается новое жёсткое состояние.

name

string / обязательный

Имя правила apply для службы Icinga.

notes

string

Дополнительные примечания к этому объекту.

notes_url

string

URL-адрес со ссылкой на дополнительные примечания к этому объекту.

Несколько URL-адресов указываются так: «http://url1 http://url2»

Максимальная длина — 255 символов.

retry_interval

string

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

state

string

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

Возможные значения:

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

vars

dictionary

Пользовательские свойства правила применения службы.

icinga_service_templates

list / elements=string

Список шаблонов служб Icinga для настройки

check_command

string

Определение команды проверки.

check_interval

string

Ваш обычный интервал проверки.

check_period

string

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

check_timeout

string

Тайм-аут команды проверки в секундах. Переопределяет атрибут тайм-аута CheckCommand.

disabled

boolean

Отключённые объекты не будут развёрнуты.

Возможные значения:

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

enable_active_checks

boolean

Следует ли активно проверять этот объект.

Возможные значения:

• false
• true

enable_event_handler

boolean

Следует ли включить обработчики событий для этого объекта.

Возможные значения:

• false
• true

enable_notifications

boolean

Следует ли отправлять уведомления для этого объекта.

Возможные значения:

• false
• true

enable_passive_checks

boolean

Принимать ли результаты пассивных проверок для этого объекта.

Возможные значения:

• false
• true

enable_perfdata

boolean

Обрабатывать ли данные о производительности, предоставленные этим объектом.

Возможные значения:

• false
• true

event_command

string

Команда обработки событий службы, вызываемая при каждом выполнении проверки, если выполняется одно из следующих условий

Служба находится в мягком состоянии

Состояние службы переходит в жёсткое состояние

Состояние службы восстанавливается из мягкого или жёсткого состояния до OK/Up

groups

list / elements=string

Группы служб, которые следует напрямую назначить этой службе.

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

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

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

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

imports

list / elements=string

Импортируемые шаблоны; можно добавить сколько угодно.

Обратите внимание: при импорте свойств из нескольких шаблонов порядок имеет значение — последнее значение имеет приоритет.

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

max_check_attempts

string

Определяет, после какого количества попыток проверки будет достигнуто новое жёсткое состояние.

name

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 символов.

retry_interval

string

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

state

string

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

Возможные значения:

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

use_agent

boolean

Следует ли выполнять команду проверки этой службы на агенте Icinga.

Возможные значения:

• false
• true

vars

dictionary

Пользовательские свойства шаблона службы.

По умолчанию: {}

volatile

boolean

Является ли эта проверка изменчивой.

Возможные значения:

• false
• true

icinga_servicegroups

list / elements=string

Список групп служб Icinga для настройки

assign_filter

string

Позволяет настроить фильтр назначения.

Можно комбинировать любое количество вложенных операторов.

display_name

string

Альтернативное отображаемое название этой группы.

Если вы не знаете, чем это может быть полезно, оставьте поле пустым.

name

string / обязательный

Название группы служб Icinga.

state

string

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

Возможные значения:

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

icinga_services

list / elements=string

Список служб Icinga для настройки

check_command

string

Определение команды проверки.

check_interval

string

Ваш обычный интервал проверки.

check_period

string

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

check_timeout

string

Тайм-аут команды проверки в секундах. Переопределяет атрибут тайм-аута CheckCommand.

disabled

boolean

Отключённые объекты не будут развёрнуты.

Возможные значения:

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

enable_active_checks

boolean

Следует ли активно проверять этот объект.

Возможные значения:

• false
• true

enable_event_handler

boolean

Следует ли включить обработчики событий для этого объекта.

Возможные значения:

• false
• true

enable_notifications

boolean

Следует ли отправлять уведомления для этого объекта.

Возможные значения:

• false
• true

enable_passive_checks

boolean

Принимать ли результаты пассивных проверок для этого объекта.

Возможные значения:

• false
• true

enable_perfdata

boolean

Обрабатывать ли данные о производительности, предоставленные этим объектом.

Возможные значения:

• false
• true

groups

list / elements=string

Группы служб, которые следует напрямую назначить этой службе.

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

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

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

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

host

string / обязательный

Выберите узел, которому следует назначить эту отдельную службу.

imports

list / elements=string

Импортируемые шаблоны; можно добавить сколько угодно.

Обратите внимание: при импорте свойств из нескольких шаблонов порядок имеет значение — последнее значение имеет приоритет.

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

max_check_attempts

string

Определяет, после какого количества попыток проверки будет достигнуто новое жёсткое состояние.

name

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 символов.

retry_interval

string

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

state

string

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

Возможные значения:

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

use_agent

boolean

Следует ли выполнять команду проверки этой службы на агенте Icinga.

Возможные значения:

• false
• true

vars

dictionary

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

По умолчанию: {}

volatile

boolean

Является ли эта проверка изменчивой.

Возможные значения:

• false
• true

icinga_timeperiods

list / elements=string

Список периодов времени Icinga для настройки

display_name

string

Альтернативное имя этого периода времени.

imports

list / elements=string

Импортируемые шаблоны — добавьте столько, сколько нужно.

Обратите внимание, что при импорте свойств из нескольких шаблонов важен их порядок: последнее значение имеет приоритет.

name

string

Название периода времени.

ranges

dictionary

Словарь дней и периодов времени.

state

string

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

Варианты:

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

icinga_user_templates

list / elements=string

Список шаблонов пользователей Icinga для настройки

enable_notifications

boolean

Следует ли отправлять уведомления этому пользователю.

Варианты:

• false
• true

imports

list / elements=string

Импортируемые шаблоны — добавьте столько, сколько нужно.

Обратите внимание, что при импорте свойств из нескольких шаблонов важен их порядок: последнее значение имеет приоритет.

name

string / обязательный

Название шаблона пользователя.

period

string

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

state

string

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

Варианты:

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

vars

dictionary

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

По умолчанию: {}

icinga_users

list / elements=string

Список пользователей Icinga для настройки

disabled

boolean

Отключённые объекты не будут развёрнуты.

Варианты:

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

display_name

string

Альтернативное имя этого пользователя.

Если имя объекта совпадает с именем пользователя, здесь можно указать полное имя соответствующего человека.

email

string

groups

list / elements=string

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

Группы могут быть полезны по разным причинам. Возможно, вы предпочтёте отправлять уведомления группам, а не отдельным пользователям.

imports

list / elements=string

Импортируемые шаблоны — добавьте столько, сколько нужно.

Обратите внимание, что при импорте свойств из нескольких шаблонов важен их порядок: последнее значение имеет приоритет.

name

string / обязательный

Имя пользователя.

pager

string

Адрес пейджера пользователя.

period

string

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

state

string

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

Варианты:

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

vars

dictionary

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

По умолчанию: {}

icinga_zones

list / elements=string

Список зон Icinga для настройки

is_global

boolean

Следует ли синхронизировать файлы конфигурации этой зоны со всеми конечными узлами.

Варианты:

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

name

string / обязательный

Имя объекта Icinga для этой зоны.

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

Чтобы пользователям было проще, мы настоятельно рекомендуем использовать понятные имена для шаблонов.

Например, «generic-zone» — неудачное название, а «Стандартный сервер Linux» понятнее.

parent

string

Имя родительской зоны.

state

string

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

Варианты:

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