t_systems_mms.icinga_director.icinga_service – Управление службами в Icinga2
Примечание
Этот плагин входит в коллекцию t_systems_mms.icinga_director (версия 1.13.0).
Для его установки используйте: ansible-galaxy collection install t_systems_mms.icinga_director.
Для использования в плейбуке укажите: t_systems_mms.icinga_director.icinga_service.
Новое в версии 1.0.0: из t_systems_mms.icinga_director
Обзор
- Добавление или удаление службы в Icinga2 через API директора.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| check_command строка | Определение команды проверки. | |
| check_interval строка | Ваш стандартный интервал проверки. | |
| check_period строка | Имя временного периода, определяющего, когда этот объект должен контролироваться. По умолчанию не ограничено. | |
| check_timeout строка | Таймаут команды проверки в секундах. Переопределяет атрибут таймаута CheckCommand. | |
| client_cert путь | Файл цепочки сертификатов в формате PEM, используемый для проверки подлинности клиента SSL. Этот файл также может содержать ключ, и если ключ включен, client_key не требуется. | |
| client_key путь | Файл в формате PEM, содержащий ваш закрытый ключ, используемый для проверки подлинности клиента SSL. Если client_cert содержит как сертификат, так и ключ, этот параметр не требуется. | |
| disabled логическое |
| Отключенные объекты не будут развернуты. |
| enable_active_checks логическое |
| Активно проверять этот объект? |
| enable_event_handler логическое |
| Включить обработчики событий для этого объекта? |
| enable_notifications логическое |
| Отправлять уведомления для этого объекта? |
| enable_passive_checks логическое |
| Принимать результаты пассивной проверки для этого объекта? |
| enable_perfdata логическое |
| Обрабатывать данные производительности, предоставляемые этим объектом? |
| force логическое |
| Если yes, не использовать кэшированную копию.Псевдоним thirsty устарел и будет удален в версии 2.13.псевдонимы: thirsty |
| force_basic_auth логическое |
| Указанные в url_username и url_password учетные данные должны передаваться в заголовке HTTP. |
| groups список / элементы=строка | Значение по умолчанию: [] | Группы служб, которые должны быть непосредственно назначены этой службе. Группы служб могут быть полезны по разным причинам. Они полезны для предоставления специфичных для типа службы представлений в Icinga Web 2, как для пользовательских панелей мониторинга, так и для применения ограничений. Группы служб могут быть непосредственно назначены отдельным службам или шаблонам служб. |
| host строка / обязательно | Выберите хост, которому должна быть назначена эта служба. | |
| http_agent строка | Значение по умолчанию: "ansible-httpget" | Заголовок для идентификации, обычно отображается в журналах веб-сервера. |
| imports список / элементы=строка | Значение по умолчанию: [] | Импортируемые шаблоны, можно добавить любое количество. Обратите внимание, что порядок имеет значение при импорте свойств из нескольких шаблонов – последний шаблон имеет преимущество. |
| max_check_attempts строка | Определяет, после скольки попыток проверки достигается новое состояние. | |
| notes строка добавлено в 1.8.0 из t_systems_mms.icinga_director | Дополнительные примечания для этого объекта. | |
| notes_url строка добавлено в 1.8.0 из t_systems_mms.icinga_director | Ссылка на дополнительные примечания для этого объекта. Разделяйте несколько ссылок таким образом: "'http://url1' 'http://url2'". Максимальная длина – 255 символов. | |
| object_name строка / обязательно | Имя службы. псевдонимы: name | |
| retry_interval строка | Интервал повтора, будет применяться после изменения состояния, если не достигнуто следующее критическое состояние. | |
| state строка |
| Применение состояния функции. |
| url строка / обязательно | Ссылка HTTP, HTTPS или FTP в формате (http|https|ftp)://[user[:pass]]@host.domain[:port]/path | |
| url_password строка | Пароль для использования в аутентификации HTTP Basic. Если параметр url_username не указан, параметр url_password не будет использован. | |
| url_username строка | Имя пользователя для использования в аутентификации HTTP Basic. Этот параметр может использоваться без url_password для сайтов, допускающих пустые пароли | |
| use_agent логическое |
| Использовать ли команду проверки для этой службы на агенте Icinga. |
| use_gssapi логическое добавлено в 2.11 из ansible.builtin |
| Использовать ли GSSAPI для аутентификации, обычно это используется для аутентификации Kerberos или Kerberos через Negotiate. Требуется установка Python-библиотеки gssapi. Учетные данные для GSSAPI можно указать с помощью url_username/url_password или с помощью переменной среды GSSAPI KRB5CCNAME, которая указывает на пользовательский кэш учетных данных Kerberos.Аутентификация NTLM not поддерживается, даже если механизм GSSAPI для NTLM был установлен. |
| use_proxy логическое |
| Если no, прокси не будет использоваться, даже если он определен в переменной среды на целевых хостах. |
| validate_certs логическое |
| Если no, сертификаты SSL не будут проверены.Использовать только на сайтах под личным контролем, использующих самозаверяющие сертификаты. |
| vars словарь | Значение по умолчанию: {} | Пользовательские свойства службы. |
| volatile логическое |
| Является ли эта проверка временной? |
Примечания
Примечание
- Этот модуль поддерживает режим проверки.
Примеры
- name: Create service
tags: service
t_systems_mms.icinga_director.icinga_service:
state: present
url: "{{ icinga_url }}"
url_username: "{{ icinga_user }}"
url_password: "{{ icinga_pass }}"
object_name: "foo service"
check_command: hostalive
use_agent: false
host: foohost
vars:
procs_argument: consul
procs_critical: '1:'
procs_warning: '1:'
notes: "example note"
notes_url: "'http://url1' 'http://url2'"
Авторы
- Sebastian Gumprich (@rndmh3ro)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/t_systems_mms/icinga_director/icinga_service_module.html
