获取

Description 描述

integer/array problem.get(object parameters)

The method allows to retrieve problems according to the given parameters. 此方法允许根据给定参数检索符合条件的问题

Parameters 参数

(object) Parameters defining the desired output. (object) 定义所需输出的参数

The method supports the following parameters. 此方法支持一下参数

Parameter	Type	Description
eventids	string/array	Return only problems with the given IDs. 仅返回所给IDs的问题
groupids	string/array	Return only problems created by objects that belong to the given host groups. 仅返回所属给定主机组对象的问题
hostids	string/array	Return only problems created by objects that belong to the given hosts. 仅返回所给定主机对象的问题
objectids	string/array	Return only problems created by the given objects. 仅返回所给对象创建的问题
applicationids	string/array	Return only problems created by objects that belong to the given applications. Applies only if object is trigger or item. 只返回属于给定应用程序的对象创建的问题。仅当对象是触发器或监控项时才应用。
source	integer	Return only problems with the given type. Refer to the problem event object page for a list of supported event types. Default: 0 - problem created by a trigger. 只返回给定类型的问题跳转到problem event object page 用于支持事件类型的列表。 \\默认：0 - 触发器创建的问题
object	integer	Return only problems created by objects of the given type. Refer to the problem event object page for a list of supported object types. Default: 0 - trigger. 只返回由给定类型的对象创建的问题 \\跳转到 problem event object page 用于支持事件类型的列表 \\默认：0-触发器
acknowledged	boolean	`true` - return acknowledged problems only; `false` - unacknowledged only. `true`-返回已知晓的问题返回未知晓的问题
severities	integer/array	Return only problems with given event severities. Applies only if object is trigger. 只返回给定事件严重程度的问题。仅当对象是触发器时才应用。
evaltype	integer	Rules for tag searching. Possible values: 0 - (default) And/Or; 2 - Or. 规则标签搜索。 \\可能的值： 0 - (默认)与/或；2 - 或
tags	array of objects	Return only problems with given tags. Exact match by tag and case-insensitive search by value and operator. Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`. An empty array returns all problems. Possible operator types: 0 - (default) Like; 1 - Equal. 只返回给定标签的问题。按标记精确匹配，按值和运算符不区分大小写搜索。格式：`[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`. 空数组返回所有问题可能的分隔类型： 0 - (默认) 相似 1 - 相等
recent	string	true - return PROBLEM and recently RESOLVED problems (depends on Display OK triggers for N seconds) Default: false - UNRESOLVED problems only true - 返回问题和最近已解决的问题（依赖于最近N秒显示OK的触发器）默认：false - 仅真正未处理的问题
eventid_from	string	Return only problems with IDs greater or equal to the given ID. 只返回ID大于或等于给定ID的问题。
eventid_till	string	Return only problems with IDs less or equal to the given ID. 只返回ID小于或等于给定ID的问题。
time_from	timestamp	Return only problems that have been created after or at the given time. 仅返回问题创建时间在所给时间之后的问题
time_till	timestamp	Return only problems that have been created before or at the given time. 仅返回问题创建时间在所给时间之前的问题
selectAcknowledges	query	Return problem's updates in the `acknowledges` property. Problem updates are sorted in reverse chronological order. The problem update object has the following properties: `acknowledgeid` - `(string)` update's ID; `userid` - `(string)` ID of the user that updated the event; `eventid` - `(string)` ID of the updated event; `clock` - `(timestamp)` time when the event was updated; `message` - `(string)` text of the message; `action` - `(integer)` update action that was performed see event.acknowledge; `old_severity` - `(integer)` event severity before this update action; `new_severity` - `(integer)` event severity after this update action; Supports `count`. 在`acknowledges`属性中返回问题的更新。问题更新按时间倒序排序。问题更新对象拥有以下属性：`acknowledgeid` - `(string)` 更新的ID 'userid'' - `(string)` 更新事件的用户的ID; `eventid` - `(string)` 更新时间的ID `clock` - `(timestamp)` 事件更新的时间 `message` - `(string)` 文本信息 `action` - `(integer)` 更新动作请参照 event.acknowledge; `old_severity` - `(integer)` 更新动作前事件的级别 `new_severity` - `(integer)` 更新动作后事件级别
selectTags	query	Return problem's tags. Output format: `[{"tag": "<tag>", "value": "<value>"}, ...]`. 返回问题标签，输出格式：`[{"tag": "<tag>", "value": "<value>"}, ...]`
sortfield	string/array	Sort the result by the given properties. Possible values are: `eventid`. 根据给定的属性对结果进行排序。可能的的值：`eventid`
countOutput	boolean	These parameters being common for all `get` methods are described in detail in the reference commentary page. 这个属性使用所有的`get`方法，详细定义在reference commentary页
editable	boolean
excludeSearch	boolean
filter	object
limit	integer
output	query
preservekeys	boolean
search	object
searchByAny	boolean
searchWildcardsEnabled	boolean
sortorder	string/array
startSearch	boolean

Return values 返回值

(integer/array) Returns either:

an array of objects;
一个数组对象
the count of retrieved objects, if the countOutput parameter has been used.
返回检索到对象的数量，如果countOutput参数被引用

Examples 示例如下

Retrieving trigger problem events 返回触发器问题事件

Retrieve recent events from trigger "15112." 返回最近触发器id是15112的事件

Request:

{
           "jsonrpc": "2.0",
           "method": "problem.get",
           "params": {
               "output": "extend",
               "selectAcknowledges": "extend",
               "selectTags": "extend",
               "objectids": "15112",
               "recent": "true",
               "sortfield": ["eventid"],
               "sortorder": "DESC"
           },
           "auth": "67f45d3eb1173338e1b1647c4bdc1916",
           "id": 1
       }

Response:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "eventid": "1245463",
                   "source": "0",
                   "object": "0",
                   "objectid": "15112",
                   "clock": "1472457242",
                   "ns": "209442442",
                   "r_eventid": "1245468",
                   "r_clock": "1472457285",
                   "r_ns": "125644870",
                   "correlationid": "0",
                   "userid": "1",
                   "name": "Zabbix agent on localhost is unreachable for 5 minutes",
                   "acknowledged": "1",
                   "severity": "3",
                   "acknowledges": [
                       {
                           "acknowledgeid": "14443",
                           "userid": "1",
                           "eventid": "1245463",
                           "clock": "1472457281",
                           "message": "problem solved",
                           "action": "6",
                           "old_severity": "0",
                           "new_severity": "0"
                       }
                   ],
                   "tags": [
                       {
                           "tag": "test tag",
                           "value": "test value"
                       }
                   ]
               }
           ],
           "id": 1
       }

Source

CEvent::get() in frontends/php/include/classes/api/services/CProblem.php.

Documentation

获取