Модуль telekom_mms.icinga_director.icinga_service_template – Управление шаблонами сервисов в Icinga2

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install telekom_mms.icinga_director.

Для использования в playbook, укажите: telekom_mms.icinga_director.icinga_service_template.

Новое в telekom_mms.icinga_director 1.0.0

Краткое описание
Параметры
Примечания
Примеры

Краткое описание

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

Параметры

Параметр	Комментарии
append boolean added in telekom_mms.icinga_director 1.25.0	Не перезаписывать весь объект, а добавлять определенные свойства. Примечание - Добавление к существующим переменным, импортам или любому другому списку/словарю невозможно. Вы должны перезаписать полный список/словарь. Примечание - Переменные, установленные по умолчанию, также будут применены, даже если не заданы. Варианты: `false` `true`
check_command string	Определение команды проверки.
check_interval string	Ваш регулярный интервал проверки.
check_period string	Имя временного периода, определяющего, когда этот объект должен отслеживаться. По умолчанию не ограничено.
check_timeout string	Тайм-аут команды проверки в секундах. Перезаписывает атрибут тайм-аута CheckCommand.
client_cert path	Файл цепочки сертификатов в формате PEM, который будет использоваться для проверки подлинности клиента SSL. Этот файл может также включать ключ, и если ключ включен, `client_key` не требуется.
client_key path	Файл в формате PEM, содержащий ваш закрытый ключ, который будет использоваться для проверки подлинности клиента SSL. Если `client_cert` содержит как сертификат, так и ключ, этот параметр не требуется.
disabled boolean	Отключенные объекты не будут развернуты. Варианты: `false` ← (default) `true`
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` ← (default) `true`
force_basic_auth boolean	Учетные данные, указанные с помощью `url_username` и `url_password`, должны передаваться в HTTP-заголовке. Варианты: `false` ← (default) `true`

groups list / elements=string	Группы сервисов, которые должны быть напрямую назначены этому сервису. Группы сервисов могут быть полезны по разным причинам. Они помогают обеспечить представление, специфичное для типа сервиса, в Icinga Web 2, как для пользовательских панелей мониторинга, так и в качестве инструмента для применения ограничений. Группы сервисов могут быть напрямую назначены отдельным сервисам или шаблонам сервисов. Default: `[]`
http_agent string	Заголовок для идентификации, обычно отображается в логах веб-сервера. Default: `"ansible-httpget"`
icon_image string	URL, указывающий на значок для этого объекта. Попробуйте «tux.png» для значков, относящихся к public/img/icons, или «cloud» (без расширения) для элементов из шрифта значков Icinga
icon_image_alt string	Альтернативный текст, который будет отображаться, если вышеуказанный значок отсутствует
imports list / elements=string	Импортируемые шаблоны, добавьте столько, сколько вам нужно. Обратите внимание, что порядок имеет значение при импорте свойств из нескольких шаблонов — последний выигрывает. Default: `[]`
max_check_attempts string	Определяет, после скольких попыток проверки достигается новое жесткое состояние.
notes string added in telekom_mms.icinga_director 1.8.0	Дополнительные заметки для этого объекта.
notes_url string added in telekom_mms.icinga_director 1.8.0	URL, указывающий на дополнительные заметки для этого объекта. Разделите несколько URL-адресов следующим образом: “’http://url1’ ‘http://url2’”. Максимальная длина — 255 символов.
object_name aliases: name string / required	Имя шаблона сервиса.
retry_interval string	Интервал повтора, будет применяться после изменения состояния, если не достигнуто следующее жесткое состояние.
state string	Применить состояние функции. Choices: `"present"` ← (default) `"absent"`
url string / required	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_agent boolean	Должна ли команда проверки для этого сервиса выполняться на агенте Icinga. Choices: `false` `true`
use_gssapi boolean added in ansible-core 2.11	Использовать GSSAPI для выполнения аутентификации, обычно это Kerberos или Kerberos через аутентификацию Negotiate. Требуется установка библиотеки Python gssapi. Учетные данные для GSSAPI могут быть указаны с помощью `url_username`/`url_password` или с помощью переменной среды GSSAPI `KRB5CCNAME`, которая указывает на пользовательский кэш учетных данных Kerberos. Аутентификация NTLM не поддерживается, даже если механизм GSSAPI для NTLM был установлен. Choices: `false` ← (default) `true`
use_proxy boolean	Если `no`, прокси использоваться не будет, даже если он определен в переменной среды на целевых хостах. Choices: `false` `true` ← (default)

validate_certs boolean	Если `no`, SSL-сертификаты проверяться не будут. Это следует использовать только на лично контролируемых сайтах, использующих самоподписанные сертификаты. Варианты: `false` `true` ← (по умолчанию)
vars dictionary	Пользовательские свойства шаблона сервиса. По умолчанию: `{}`
volatile boolean	Является ли эта проверка нестабильной. Варианты: `false` `true`

Примечания

Примечание

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

Примеры

- name: Create servicetemplate
  telekom_mms.icinga_director.icinga_service_template:
    state: present
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    enable_flapping: true
    flapping_threshold_high: "30.0"
    flapping_threshold_low: "25.0"
    icon_image_alt: "alt text"
    icon_image: "http://url1"
    object_name: fooservicetemplate
    use_agent: false
    vars:
      procs_argument: consul
      procs_critical: '1:'
      procs_warning: '1:'

- name: Update servicetemplate
  telekom_mms.icinga_director.icinga_service_template:
    state: present
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    object_name: fooservicetemplate
    notes: "example note"
    notes_url: "'http://url1' 'http://url2'"
    append: true

- name: Create servicetemplate with event command
  telekom_mms.icinga_director.icinga_service_template:
    state: present
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    object_name: apache_check_servicetemplate
    use_agent: false
    event_command: restart_httpd
    notes: "example note"
    notes_url: "'http://url1' 'http://url2'"

Авторы

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_service_template_module.html