community.zabbix.zabbix_host_events_info module – Get all triggers about a Zabbix host

Note

This module is part of the community.zabbix collection (version 3.1.2).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.zabbix. You need further requirements to be able to use this module, see Requirements for details.

To use it in a playbook, specify: community.zabbix.zabbix_host_events_info.

Synopsis 

This module allows you to see if a Zabbix host have no active alert to make actions on it. For this case use module Ansible “fail” to exclude host in trouble.
Length of “triggers_ok” allow if template’s triggers exist for Zabbix Host

Requirements 

The below requirements are needed on the host that executes this module.

python >= 3.9

Parameters 

Parameter	Comments
host_id_type string	Type of host_identifier Choices: `"hostname"` ← (default) `"visible_name"` `"hostid"`
host_identifier string / required	Identifier of Zabbix Host
http_login_password string	Basic Auth password
http_login_user string	Basic Auth login
tags list / elements=dictionary	list of tags to filter by
operator string / required	how to match tags Choices: `"like"` `"equal"` `"not_like"` `"not_equal"` `"exists"` `"not_exists"`
tag string / required	the tag name
value string / required	the tag value
trigger_severity string	Zabbix severity for search filter Choices: `"not_classified"` `"information"` `"warning"` `"average"` ← (default) `"high"` `"disaster"`

Examples 

# If you want to use Username and Password to be authenticated by Zabbix Server
- name: Set credentials to access Zabbix Server API
  ansible.builtin.set_fact:
    ansible_user: Admin
    ansible_httpapi_pass: zabbix

# If you want to use API token to be authenticated by Zabbix Server
# https://www.zabbix.com/documentation/current/en/manual/web_interface/frontend_sections/administration/general#api-tokens
- name: Set API token
  ansible.builtin.set_fact:
    ansible_zabbix_auth_key: 8ec0d52432c15c91fcafe9888500cf9a607f44091ab554dbee860f6b44fac895

- name: exclude machine if alert active on it
  # set task level variables as we change ansible_connection plugin here
  vars:
      ansible_network_os: community.zabbix.zabbix
      ansible_connection: httpapi
      ansible_httpapi_port: 443
      ansible_httpapi_use_ssl: true
      ansible_httpapi_validate_certs: false
      ansible_zabbix_url_path: "zabbixeu"  # If Zabbix WebUI runs on non-default (zabbix) path ,e.g. http://<FQDN>/zabbixeu
      ansible_host: zabbix-example-fqdn.org
  community.zabbix.zabbix_host_events_info:
      host_identifier: "{{inventory_hostname}}"
      host_id_type: "hostname"
  register: zbx_host
  delegate_to: localhost
- fail:
    msg: "machine alert in zabbix"
  when: zbx_host["triggers_problem"]|length > 0


- name: filter events for host based on tag
  # set task level variables as we change ansible_connection plugin here
  vars:
      ansible_network_os: community.zabbix.zabbix
      ansible_connection: httpapi
      ansible_httpapi_port: 443
      ansible_httpapi_use_ssl: true
      ansible_httpapi_validate_certs: false
      ansible_zabbix_url_path: "zabbixeu"  # If Zabbix WebUI runs on non-default (zabbix) path ,e.g. http://<FQDN>/zabbixeu
      ansible_host: zabbix-example-fqdn.org
  community.zabbix.zabbix_host_events_info:
      host_identifier: "{{inventory_hostname}}"
      host_id_type: "hostname"
      tags:
        - tag: ExampleTag
          value: ExampleValue
          operator: equal

Return Values 

Common return values are documented here, the following are the fields unique to this module:

Key	Description
triggers_ok complex	Host Zabbix Triggers in OK state Returned: On success
comments string	Additional description of the trigger Returned: success
description string	Name of the trigger Returned: success
error string	Error text if there have been any problems when updating the state of the trigger Returned: success
expression string	Reduced trigger expression Returned: success
flags integer	Origin of the trigger Returned: success
lastchange integer	Time when the trigger last changed its state (timestamp) Returned: success
priority integer	Severity of the trigger Returned: success
state integer	State of the trigger Returned: success
status integer	Whether the trigger is enabled or disabled Returned: success
templateid integer	ID of the parent template trigger Returned: success
triggerid integer	ID of the trigger Returned: success
type integer	Whether the trigger can generate multiple problem events Returned: success
url string	URL associated with the trigger Returned: success
value integer	Whether the trigger is in OK or problem state Returned: success
triggers_problem complex	Host Zabbix Triggers in problem state. See trigger and event objects in API documentation of your zabbix version for more Returned: On success
comments string	Additional description of the trigger Returned: success
description string	Name of the trigger Returned: success
error string	Error text if there have been any problems when updating the state of the trigger Returned: success
expression string	Reduced trigger expression Returned: success
flags integer	Origin of the trigger Returned: success
last_event complex	last event informations Returned: success
acknowledged integer	If set to true return only acknowledged events Returned: success
acknowledges complex	acknowledges informations Returned: success
alias string	Account who acknowledge Returned: success
clock integer	Time when the event was created (timestamp) Returned: success
message string	Text of the acknowledgement message Returned: success
clock integer	Time when the event was created (timestamp) Returned: success
eventid integer	ID of the event Returned: success
tags list / elements=string	List of tags Returned: success
value integer	State of the related object Returned: success
lastchange integer	Time when the trigger last changed its state (timestamp) Returned: success
priority integer	Severity of the trigger Returned: success
state integer	State of the trigger Returned: success
status integer	Whether the trigger is enabled or disabled Returned: success
templateid integer	ID of the parent template trigger Returned: success
triggerid integer	ID of the trigger Returned: success
type integer	Whether the trigger can generate multiple problem events Returned: success
url string	URL associated with the trigger Returned: success
value integer	Whether the trigger is in OK or problem state Returned: success

Authors

Stéphane Travassac (@stravassac)

community.zabbix.zabbix_host_events_info module – Get all triggers about a Zabbix host

Synopsis

Requirements

Parameters

Examples

Return Values