获取

描述

integer/array event.get(object parameters)

该方法允许根据给定的参数检索事件。

如果管家尚未删除这些事件，则此方法可能会返回已删除实体的事件。

此方法适用于任何类型的用户。可以在用户角色设置中撤销调用该方法的权限。查看 用户角色。

参数

(object) 定义所需要输出的参数。

此方法支持以下参数。

参数类型描述
eventidsstring/array仅返回具有给定 ID 的事件。
groupidsstring/array仅返回由属于给定主机组的对象创建的事件。
hostidsstring/array仅返回由属于给定主机的对象创建的事件。
objectidsstring/array仅返回由给定对象创建的事件。
sourceinteger仅返回给定类型的事件。

参阅 事件对象页面 获取支持的事件类型列表。

默认值：0 - 触发器事件。
objectinteger仅返回由给定类型的对象创建的事件。

参阅 事件对象页面 获取支持的事件类型列表。

默认值：0 - 触发器。
acknowledgedboolean如果设置为 true 仅返回已确认的事件。
suppressedbooleantrue - 只返回被抑制的事件；
false - 返回正常状态的事件。
severitiesinteger/array仅返回具有给定严重性的事件。仅当对象是触发器时才适用。
evaltypeinteger标签搜索规则。

可用值：
0 - （默认）和/或；
2 - 或。
tags对象数组仅返回具有给定标签的事件。通过标签进行精确匹配，通过值和操作符进行不区分大小写的匹配。
格式：[{“tag”：”<tag>”， “value”：”<value>”，”operator”：”<operator>”}，…]。
空数组返回所有事件。

可能的运算符类型：
0 - （默认） Like（类似于……）；
1 - Equal（等于）；
2 - Not like（不类似于……）；
3 - Not equal（不等于）；
4 - Exists（存在）；
5 - Not exists（不存在）。
eventid_fromstring仅返回 ID 大于或等于给定 ID 的事件。
eventid_tillstring仅返回 ID 小于或等于给定 ID 的事件。
time_fromtimestamp仅返回在给定时间或在给定时间之后创建的事件。
time_tilltimestamp仅返回在给定时间或在给定时间之前创建的事件。
problem_time_fromtimestamp仅返回从problem_time_from设定的时间开始处于问题状态的事件。仅当事件源是触发器事件且对象为触发时适用。如果指定了 problem_time_till ，则为强制性。
problem_time_tilltimestamp仅返回在problem_time_still设定的时间之前处于问题状态的事件。仅当事件源是触发器事件且对象为触发时适用。如果指定了 problem_time_from ，则为强制性。
valueinteger/array仅返回具有给定值的事件。
selectHostsquery返回 主机 属性，其中 hosts 包含创建事件的对象。仅支持由触发器、监控项或 LLD 规则生成的事件。
selectRelatedObjectquery返回带有创建事件的对象的 ‘relatedObject ‘ 属性。返回的对象类型取决于事件类型。
select_alertsquery返回由事件生成的告警的 告警 属性。警报按时间倒序排列。
select_acknowledgesquery返回带有事件更新的 acknowledges 属性。 事件更新按时间倒序排列。

事件更新对象具有以下属性：
acknowledgeid - (string) 确认事件的ID；
userid - (string) 更新事件的用户ID；
eventid - (string) 更新事件的ID；
clock - (timestamp) 事件被更新的时间；
message - (string) 消息文本；
action - (integer) 更新执行的操作，参见 event.acknowledge；
old_severity - (integer) 此更新操作之前的事件严重性；
new_severity - (integer) 此更新操作后的事件严重性；
username - (string) 更新该事件的用户的username（用户名）；
name - (string) 更新该事件的用户的name（可见名）；
surname - (string) 更新事件的用户的surname（姓）。

支持 count。
selectTagsquery返回事件标签的 标签 属性。
selectSuppressionDataquery返回维护列表的suppression_data 属性：
maintenanceid - (string) 维护期ID；
suppress_until - (integer) 事件被抑制的时间。
sortfieldstring/array按给定属性对结果进行排序。

可用值：eventid，objectid 和 clock。
countOutputboolean这些参数对于所有的 get 方法都是通用的，详细描述请参见 参考说明 页面。
editableboolean
excludeSearchboolean
filterobject
limitinteger
outputquery
preservekeysboolean
searchobject
searchByAnyboolean
searchWildcardsEnabledboolean
sortorderstring/array
startSearchboolean

返回值

(integer/array) 返回其中之一：

  • 一个对象数组；
  • 如果使用了 countOutput 参数，则返回检索到的对象的计数。

示例

检索触发器事件

检索ID为 “13926” 的触发器的最新事件。

请求：

  1. {
  2.            "jsonrpc": "2.0",
  3.            "method": "event.get",
  4.            "params": {
  5.            "output": "extend",
  6.            "select_acknowledges": "extend",
  7.            "selectTags": "extend",
  8.            "selectSuppressionData": "extend",
  9.            "objectids": "13926",
  10.            "sortfield": ["clock", "eventid"],
  11.            "sortorder": "DESC"
  12.            },
  13.            "auth": "038e1d7b1735c6a5436ee9eae095879e",
  14.            "id": 1
  15.        }

响应：

  1. {
  2.            "jsonrpc": "2.0",
  3.            "result": [
  4.            {
  5.            "eventid": "9695",
  6.            "source": "0",
  7.            "object": "0",
  8.            "objectid": "13926",
  9.            "clock": "1347970410",
  10.            "value": "1",
  11.            "acknowledged": "1",
  12.            "ns": "413316245",
  13.            "name": "MySQL is down",
  14.            "severity": "5",
  15.            "r_eventid": "0",
  16.            "c_eventid": "0",
  17.            "correlationid": "0",
  18.            "userid": "0",
  19.            "opdata": "",
  20.            "acknowledges": [
  21.            {
  22.            "acknowledgeid": "1",
  23.            "userid": "1",
  24.            "eventid": "9695",
  25.            "clock": "1350640590",
  26.            "message": "Problem resolved.\n\r----[BULK ACKNOWLEDGE]----",
  27.            "action": "6",
  28.            "old_severity": "0",
  29.            "new_severity": "0",
  30.            "username": "Admin",
  31.            "name": "Zabbix",
  32.            "surname": "Administrator"
  33.            }
  34.            ],
  35.            "suppression_data": [
  36.            {
  37.            "maintenanceid": "15",
  38.            "suppress_until": "1472511600"
  39.            }
  40.            ],
  41.            "suppressed": "1",
  42.            "tags": [
  43.            {
  44.            "tag": "service",
  45.            "value": "mysqld"
  46.            },
  47.            {
  48.            "tag": "error",
  49.            "value": ""
  50.            }
  51.            ]
  52.            },
  53.            {
  54.            "eventid": "9671",
  55.            "source": "0",
  56.            "object": "0",
  57.            "objectid": "13926",
  58.            "clock": "1347970347",
  59.            "value": "0",
  60.            "acknowledged": "0",
  61.            "ns": "0",
  62.            "name": "Unavailable by ICMP ping",
  63.            "severity": "4",
  64.            "r_eventid": "0",
  65.            "c_eventid": "0",
  66.            "correlationid": "0",
  67.            "userid": "0",
  68.            "opdata": "",
  69.            "acknowledges": [],
  70.            "suppression_data": [],
  71.            "suppressed": "0",
  72.            "tags": []
  73.            }
  74.            ],
  75.            "id": 1
  76.        }

按时间段检索事件

按时间倒序检索在 2012 年 10 月 9 日至 10 日之间创建的所有事件。

请求：

  1. {
  2.            "jsonrpc": "2.0",
  3.            "method": "event.get",
  4.            "params": {
  5.            "output": "extend",
  6.            "time_from": "1349797228",
  7.            "time_till": "1350661228",
  8.            "sortfield": ["clock", "eventid"],
  9.            "sortorder": "desc"
  10.            },
  11.            "auth": "038e1d7b1735c6a5436ee9eae095879e",
  12.            "id": 1
  13.        }

响应：

  1. {
  2.            "jsonrpc": "2.0",
  3.            "result": [
  4.            {
  5.            "eventid": "20616",
  6.            "source": "0",
  7.            "object": "0",
  8.            "objectid": "14282",
  9.            "clock": "1350477814",
  10.            "value": "1",
  11.            "acknowledged": "0",
  12.            "ns": "0",
  13.            "name": "Less than 25% free in the history cache",
  14.            "severity": "3",
  15.            "r_eventid": "0",
  16.            "c_eventid": "0",
  17.            "correlationid": "0",
  18.            "userid": "0",
  19.            "opdata": "",
  20.            "suppressed": "0"
  21.            },
  22.            {
  23.            "eventid": "20617",
  24.            "source": "0",
  25.            "object": "0",
  26.            "objectid": "14283",
  27.            "clock": "1350477814",
  28.            "value": "0",
  29.            "acknowledged": "0",
  30.            "ns": "0",
  31.            "name": "Zabbix trapper processes more than 75% busy",
  32.            "severity": "3",
  33.            "r_eventid": "0",
  34.            "c_eventid": "0",
  35.            "correlationid": "0",
  36.            "userid": "0",
  37.            "opdata": "",
  38.            "suppressed": "0"
  39.            },
  40.            {
  41.            "eventid": "20618",
  42.            "source": "0",
  43.            "object": "0",
  44.            "objectid": "14284",
  45.            "clock": "1350477815",
  46.            "value": "1",
  47.            "acknowledged": "0",
  48.            "ns": "0",
  49.            "name": "High ICMP ping loss",
  50.            "severity": "3",
  51.            "r_eventid": "0",
  52.            "c_eventid": "0",
  53.            "correlationid": "0",
  54.            "userid": "0",
  55.            "opdata": "",
  56.            "suppressed": "0"
  57.            }
  58.            ],
  59.            "id": 1
  60.        }

参见

来源

ui/include/classes/api/services/CEvent.php 中的 CEvent::get() 。