community.zabbix.zabbix_host_events_info – Получение всех триггеров для хоста Zabbix
Примечание
Этот плагин входит в коллекцию community.zabbix (версия 1.1.0).
Для его установки используйте: ansible-galaxy collection install community.zabbix.
Для использования в playbook, укажите: 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/zabbix/zabbix_host_events_info_module.html
