community.zabbix.zabbix_host_events_info – Получение всех триггеров для хоста Zabbix
Примечание
Этот плагин входит в коллекцию community.zabbix (версия 1.2.0).
Для установки используйте: ansible-galaxy collection install community.zabbix.
Чтобы использовать его в книге задач, укажите: community.zabbix.zabbix_host_events_info.
Описание
- Этот модуль позволяет определить, есть ли активные оповещения для хоста Zabbix, чтобы принять действия по нему. В этом случае используйте модуль Ansible ‘fail’, чтобы исключить проблемный хост.
- Длина «triggers_ok» позволяет, если триггеры шаблона существуют для хоста Zabbix.
Требования
Ниже перечислены требования, которые должны быть выполнены на хосте, выполняющем этот модуль.
- python >= 2.7
- zabbix-api >= 0.5.3
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| host_id_type строка |
| Тип идентификатора хоста |
| host_identifier строка / обязательно | Идентификатор хоста Zabbix | |
| http_login_password строка | Пароль авторизации Basic Auth | |
| http_login_user строка | Имя пользователя авторизации Basic Auth | |
| login_password строка / обязательно | Пароль пользователя Zabbix. | |
| login_user строка / обязательно | Имя пользователя Zabbix. | |
| server_url строка / обязательно | URL сервера Zabbix с протоколом (http или https). url является псевдонимом для server_url. псевдонимы: url | |
| timeout целое число | По умолчанию: 10 | Таймаут запроса API (секунды). |
| trigger_severity строка |
| Уровень серьезности Zabbix для фильтра поиска |
| validate_certs логическое значение |
| Если установлено в False, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых сайтах с использованием самозаверенных сертификатов. |
Примечания
Примечание
- Если вы используете login_password=zabbix, слово «zabbix» заменяется на «****» во всем выводе модуля, потому что login_password использует
no_log. Подробнее см. эту страницу FAQ.
Примеры
- name: exclude machine if alert active on it
community.zabbix.zabbix_host_events_info:
server_url: "{{ zabbix_url }}"
login_user: "{{ lookup('env','ZABBIX_USER') }}"
login_password: "{{ lookup('env','ZABBIX_PASSWORD') }}"
host_identifier: "{{inventory_hostname}}"
host_id_type: "hostname"
timeout: 120
register: zbx_host
delegate_to: localhost
- fail:
msg: "machine alert in zabbix"
when: zbx_host['triggers_problem']|length > 0
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание | |||
|---|---|---|---|---|---|
| triggers_ok complex | При успехе | Триггеры Zabbix хоста в состоянии OK | |||
| comments string | успех | Дополнительное описание триггера | |||
| description string | успех | Название триггера | |||
| error string | успех | Текст ошибки, если возникли проблемы при обновлении состояния триггера | |||
| expression string | успех | Сокращённое выражение триггера | |||
| flags integer | успех | Источник триггера | |||
| lastchange integer | успех | Время последнего изменения состояния триггера (отметка времени) | |||
| priority integer | успех | Уровень серьёзности триггера | |||
| state integer | успех | Состояние триггера | |||
| status integer | успех | Включён или выключен триггер | |||
| templateid integer | успех | Идентификатор родительского шаблонного триггера | |||
| triggerid integer | успех | Идентификатор триггера | |||
| type integer | успех | Может ли триггер генерировать несколько событий проблем | |||
| url string | успех | URL, связанный с триггером | |||
| value integer | успех | Состояние триггера: OK или проблема | |||
| triggers_problem complex | При успехе | Триггеры Zabbix хоста в состоянии проблемы. См. объекты триггера и события в документации API вашей версии Zabbix для более подробной информации. | |||
| comments string | успех | Дополнительное описание триггера | |||
| description string | успех | Название триггера | |||
| error string | успех | Текст ошибки, если возникли проблемы при обновлении состояния триггера | |||
| expression string | успех | Сокращённое выражение триггера | |||
| flags integer | успех | Источник триггера | |||
| last_event complex | успех | информация о последнем событии | |||
| acknowledged integer | успех | Если установить в значение true, возвращаются только подтверждённые события | |||
| acknowledges complex | успех | Информация о подтверждениях | |||
| alias string | успех | Аккаунт, который подтвердил | |||
| clock integer | успех | Время создания события (отметка времени) | |||
| message string | успех | Текст сообщения о подтверждении | |||
| clock integer | успех | Время создания события (отметка времени) | |||
| eventid integer | успех | Идентификатор события | |||
| value integer | успех | Состояние связанного объекта | |||
| lastchange integer | успех | Время последнего изменения состояния триггера (отметка времени) | |||
| priority integer | успех | Уровень серьёзности триггера | |||
| state integer | успех | Состояние триггера | |||
| status integer | успех | Включён или выключен триггер | |||
| templateid integer | успех | Идентификатор родительского шаблонного триггера | |||
| triggerid integer | успех | Идентификатор триггера | |||
| type integer | успех | Может ли триггер генерировать несколько событий проблем | |||
| url string | успех | URL, связанный с триггером | |||
| value integer | успех | Состояние триггера: OK или проблема | |||
Авторы
- Stéphane Travassac (@stravassac)
© 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/community/zabbix/zabbix_host_events_info_module.html
