Documentation
Table of Contents
problem.get
³¢±ð¨ª°ù¨¢²õ
integer/array problem.get(object parameters)
A m¨®dszer lehet?v¨¦ teszi a probl¨¦m¨¢k visszakeres¨¦s¨¦t a megadottak szerint param¨¦tereket.
Ez a m¨®dszer a megoldatlan probl¨¦m¨¢k visszakeres¨¦s¨¦re szolg¨¢l. Az is lehets¨¦ges, ha meg van adva, a k?zelm¨²ltban megoldott probl¨¦m¨¢k tov¨¢bbi visszakeres¨¦s¨¦hez. Az pontban van meghat¨¢rozva, hogy h¨¢ny ¨¦ves a ?nemr¨¦g¡±. ´¡»å³¾¾±²Ô¾±²õ³ú³Ù°ù¨¢³¦¾±¨® ¡ú ?±ô³Ù²¹±ô¨¢²Ô´Ç²õ. Az ezt megel?z?en megoldott probl¨¦m¨¢k nem ker¨¹lnek t¨¢rol¨¢sra probl¨¦ma t¨¢bl¨¢zat. A r¨¦gebben megoldott probl¨¦m¨¢k visszakeres¨¦s¨¦hez a m¨²lt, haszn¨¢lja az event.get ³¾±ð³Ù¨®»å³Ü²õ³Ù.
Ez a m¨®dszer visszaadhatja a t?r?lt probl¨¦m¨¢kat ha ezeket a probl¨¦m¨¢kat a h¨¢zvezet?n? nem sz¨¹ntette meg m¨¦g.
Ez a m¨®dszer b¨¢rmilyen t¨ªpus¨² felhaszn¨¢l¨® sz¨¢m¨¢ra el¨¦rhet?. Enged¨¦lyek A met¨®dus megh¨ªv¨¢sa a felhaszn¨¢l¨®i szerepk?r be¨¢ll¨ªt¨¢saiban visszavonhat¨®. L¨¢sd: User roles tov¨¢bbi inform¨¢ci¨®¨¦rt.
Parameters
(object) Parameters defining the desired output.
The method supports the following parameters.
| Parameter | Type | Description |
|---|---|---|
| eventids | string/array | Return only problems with the given 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. |
| 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. |
| 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. |
| acknowledged | boolean | true - return acknowledged problems only;false - unacknowledged only. |
| suppressed | boolean | true - return only suppressed problems;false - return problems in the normal state. |
| 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. |
| 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; 2 - Not like; 3 - Not equal 4 - Exists; 5 - Not exists. |
| recent | boolean | true - return PROBLEM and recently RESOLVED problems (depends on Display OK triggers for N seconds)Default: false - UNRESOLVED problems only |
| eventid_from | string | Return only problems with IDs greater or equal to the given ID. |
| eventid_till | string | Return only problems with IDs less or equal to the given 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 an acknowledges property with the problem updates. 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)type of update action (see event.acknowledge);old_severity - (integer) event severity before this update action;new_severity - (integer) event severity after this update action;Supports count. |
| selectTags | query | Return a tags property with the problem tags. Output format: [{"tag": "<tag>", "value": "<value>"}, ...]. |
| selectSuppressionData | query | Return a suppression_data property with the list of maintenances:maintenanceid - (string) ID of the maintenance;suppress_until - (integer) time until the problem is suppressed. |
| sortfield | string/array | Sort the result by the given properties. Possible values are: eventid. |
| countOutput | boolean | These parameters being common for all get methods are described in detail in the reference commentary page. |
| editable | boolean | |
| excludeSearch | boolean | |
| filter | object | |
| limit | integer | |
| output | query | |
| preservekeys | boolean | |
| search | object | |
| searchByAny | boolean | |
| searchWildcardsEnabled | boolean | |
| sortorder | string/array | |
| startSearch | boolean |
Visszat¨¦r¨¦si ¨¦rt¨¦kek
(integer/array) A k?vetkez?ket adja vissza:
- objektumok t?mbje;
- a let?lt?tt objektumok sz¨¢ma, ha a
countOutputparam¨¦tert haszn¨¢lt¨¢k.
±Ê¨¦±ô»å¨¢°ì
Retrieving trigger problem events
Retrieve recent events from trigger "15112."
Request:
{
"jsonrpc": "2.0",
"method": "problem.get",
"params": {
"output": "extend",
"selectAcknowledges": "extend",
"selectTags": "extend",
"selectSuppressionData": "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": "Áú»¢¶Ä²© agent on localhost is unreachable for 5 minutes",
"acknowledged": "1",
"severity": "3",
"opdata": "",
"acknowledges": [
{
"acknowledgeid": "14443",
"userid": "1",
"eventid": "1245463",
"clock": "1472457281",
"message": "problem solved",
"action": "6",
"old_severity": "0",
"new_severity": "0"
}
],
"suppression_data": [
{
"maintenanceid": "15",
"suppress_until": "1472511600"
}
],
"suppressed": "1",
"tags": [
{
"tag": "test tag",
"value": "test value"
}
]
}
],
"id": 1
}L¨¢sd m¨¦g
¹ó´Ç°ù°ù¨¢²õ
CEvent::get() az ui/include/classes/api/services/CProblem.php-ban.