community.zabbix.zabbix_group_events_info 模块 – 获取关于 Zabbix 组的所有触发器
注意
此模块是 community.zabbix 集合(版本 3.2.0)的一部分。
如果您使用的是 ansible
包,您可能已经安装了此集合。它不包含在 ansible-core
中。要检查是否已安装,请运行 ansible-galaxy collection list
。
要安装它,请使用:ansible-galaxy collection install community.zabbix
。您需要进一步的要求才能使用此模块,请参阅 要求 了解详细信息。
要在 playbook 中使用它,请指定:community.zabbix.zabbix_group_events_info
。
概要
此模块允许您检查 Zabbix 主机组中所有主机的触发器状态。
要求
执行此模块的主机上需要以下要求。
python >= 3.9
参数
参数 |
注释 |
---|---|
Zabbix 中主机组的名称。 |
|
基本身份验证密码 |
|
基本身份验证登录名 |
|
用于搜索过滤器的 Zabbix 严重性 选项
|
示例
# If you want to use Username and Password to be authenticated by Zabbix Server
- name: Set credentials to access Zabbix Server API
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
set_fact:
ansible_zabbix_auth_key: 8ec0d52432c15c91fcafe9888500cf9a607f44091ab554dbee860f6b44fac895
- name: Fail if alert active in hostgroup
# 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_group_events_info:
hostgroup_name: "{{ inventory_hostname }}"
register: zbx_hostgroup
delegate_to: localhost
- fail:
msg: "Active alert in zabbix"
when: zbx_hostgroup["triggers_problem"] | length > 0
返回值
常见的返回值记录在此处,以下是此模块独有的字段
键 |
描述 |
---|---|
处于 OK 状态的 Zabbix 触发器 返回:成功时 |
|
触发器的附加描述 返回:成功 |
|
触发器的名称 返回:成功 |
|
如果更新触发器状态时出现任何问题,则显示错误文本 返回:成功 |
|
简化的触发器表达式 返回:成功 |
|
触发器的来源 返回:成功 |
|
触发器上次更改其状态的时间(时间戳) 返回:成功 |
|
触发器的严重性 返回:成功 |
|
触发器的状态 返回:成功 |
|
触发器是启用还是禁用 返回:成功 |
|
父模板触发器的 ID 返回:成功 |
|
触发器的 ID 返回:成功 |
|
触发器是否可以生成多个问题事件 返回:成功 |
|
与触发器关联的 URL 返回:成功 |
|
触发器处于 OK 状态还是问题状态 返回:成功 |
|
处于问题状态的 Zabbix 触发器。有关详细信息,请参阅您的 zabbix 版本的 API 文档中的触发器和事件对象 返回:成功时 |
|
触发器的附加描述 返回:成功 |
|
触发器的名称 返回:成功 |
|
如果更新触发器状态时出现任何问题,则显示错误文本 返回:成功 |
|
简化的触发器表达式 返回:成功 |
|
触发器的来源 返回:成功 |
|
上次事件信息 返回:成功 |
|
如果设置为 true,则仅返回已确认的事件 返回:成功 |
|
确认信息 返回:成功 |
|
创建事件的时间(时间戳) 返回:成功 |
|
确认消息的文本 返回:成功 |
|
确认的帐户 返回:成功 |
|
创建事件的时间(时间戳) 返回:成功 |
|
事件的 ID 返回:成功 |
|
相关对象的状态 返回:成功 |
|
触发器上次更改其状态的时间(时间戳) 返回:成功 |
|
触发器的严重性 返回:成功 |
|
触发器的状态 返回:成功 |
|
触发器是启用还是禁用 返回:成功 |
|
父模板触发器的 ID 返回:成功 |
|
触发器的 ID 返回:成功 |
|
触发器是否可以生成多个问题事件 返回:成功 |
|
与触发器关联的 URL 返回:成功 |
|
触发器处于 OK 状态还是问题状态 返回:成功 |