integer/array problem.get(object parameters)
Метода омогућава преузимање проблема према датим параметрима.
Овај метод је за проналажење нерешених проблема. Такође је могуће, ако је наведено, додатно повратити недавно решене проблеме. Период који одређује колико је година "недавно" дефинисан је у Администрација → Опште. Проблеми који су решени пре тог периода се не чувају у табели проблема . Да бисте повратили проблеме који су решени раније у прошлости, користите метод event.get
.
Овај метод може вратити проблеме брисања идентитета ако ове проблеме није уклонио домаћина.
Ова метода је доступна корисницима било ког типа. Дозволе за позивање методе могу се опозвати у подешавањима улоге корисника. Погледајте Улоге корисника за више информација.
(object)
Параметри који дефинишу жељени излаз.
Метод подржава следеће параметре.
Parameter | Type | Description |
---|---|---|
eventids | ID/array | Враћа само проблеме са датим ID-ијевима. |
groupids | ID/array | Враћа само проблеме креиране од објеката који припадају датим групама домаћина. |
hostids | ID/array | Враћа само проблеме креиране према објектима који припадају датим домаћинима. |
objectids | ID/array | Враћа само проблеме креиране од датих објеката. |
source | integer | Враћа само проблеме са датим типом. Погледајте страница са објектом догађаја проблема за листу подржаних типова догађаја. Подразумевано: 0 - проблем креиран окидачем. |
object | integer | Враћа само проблеме креиране од објеката датог типа . Погледајте страницу објекта догађаја проблема за листу подржаних типова објеката. Подразумевано: 0 - окидач. |
acknowledged | boolean | true - враћа само потврђене проблеме;false - само непотврђено. |
action | integer | Враћа само проблеме за које су дате акције ажурирања догађаја изведена. За више акција, користите збир свих прихватљивих битмап вредности као битмаску (на пример, 34 за потврду и сузбијање догађаја). |
action_userids | ID/array | Враћа само проблеме са датим ID-ијевима корисника који су извршили акције ажурирања проблематичног догађаја . |
suppressed | boolean | true - враћа само потиснуте проблеме;false - враћа проблеме у нормалном стању. |
symptom | boolean | true - враћа само догађаје проблема са симптомима;false - враћа само узрок проблема. |
severities | integer/array | Враћа само проблеме са датим озбиљностима догађаја. Примењује се само ако је објекат окидач. |
evaltype | integer | Правила за претрагу ознака. Могуће вредности: 0 - (подразумевано) И/Или; 2 - Или. |
tags | array | Враћа само проблеме са датим ознакама. Тачно подударање по ознаци и претрага без обзира на велика и мала слова по вредности и оператору. Формат: [{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...] .Празан низ враћа све проблеме. Могући типови оператора: 0 - (подразумевано) Као; 1 - Једнако; 2 - Није као; 3 - Није једнако 4 - Постоји; 5 - Не постоји. |
recent | boolean | true - враћа ПРОБЛЕМ и недавно РЕШЕНЕ проблеме (зависи од окидача Приказа ОК за N секунди)Подразумевано: false - само НЕРЕШЕНИ проблеми |
eventid_from | string | Врати само проблеме са ID-ијевима који су већи или једнаки датом ID-ију. |
eventid_till | string | Враћа само проблеме са ID-ијевима мањим или једнаким датом ID-ију. |
time_from | timestamp | Враћа само проблеме који су креирани после или у датом тренутку. |
time_till | timestamp | Враћа само проблеме који су креирани пре или у датом тренутку. |
selectAcknowledges | query | Враћа својство acknowledges са ажурирањима проблема. Ажурирања проблема су сортирана у обрнутом хронолошком редоследу.Објекат ажурирања проблема има следећа својства: acknowledgeid - (ID) ID ажурирања;userid - (ID) ID корисника који је ажурирао догађај;eventid - (ID) ID ажурираног догађаја;clock - (timestamp) време када је догађај ажуриран;message - (string) текст поруке;action - (integer) тип акције ажурирања (погледајте event.acknowledge );old_severity - (integer) озбиљност догађаја пре ове акције ажурирања;new_severity - (integer) озбиљност догађаја након ове акције ажурирања;suppress_until - (timestamp) време до догађаја ће бити потиснуто;taskid - (ID) ID задатка ако тренутни догађај пролази кроз промену ранга.Подржава count . |
selectTags | query | Враћа својство tags са ознакама проблема. Формат излаза: [{"tag": "<tag>", "value": "<value>"}, ...] . |
selectSuppressionData | query | Враћа својство suppression_data са листом активних одржавања и ручне супресије:maintenanceid - (ID) ID одржавања;userid - (ID) ID корисника који је потиснуо проблем;suppress_until - (integer) време док проблем не буде потиснут. |
filter | object | Враћа само оне резултате који се тачно подударају са датим филтером. Прихвата објекат, где су кључеви имена својстава, а вредности су или једна вредност или низ вредности за подударање. Не подржава својства text тип података. |
sortfield | string/array | Сортира резултат према датим својствима. Могуће вредности: eventid . |
countOutput | boolean | Ови параметри који су описани у референтном коментару. |
editable | boolean | |
excludeSearch | boolean | |
limit | integer | |
output | query | |
preservekeys | boolean | |
search | object | |
searchByAny | boolean | |
searchWildcardsEnabled | boolean | |
sortorder | string/array | |
startSearch | boolean |
(integer/array)
Враћа било:
countOutput
коришћен.Преузми недавне догађаје са окидача „15112“.
{
"jsonrpc": "2.0",
"method": "problem.get",
"params": {
"output": "extend",
"selectAcknowledges": "extend",
"selectTags": "extend",
"selectSuppressionData": "extend",
"objectids": "15112",
"recent": "true",
"sortfield": ["eventid"],
"sortorder": "DESC"
},
"id": 1
}
Одговор:
{
"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",
"cause_eventid": "0",
"opdata": "",
"acknowledges": [
{
"acknowledgeid": "14443",
"userid": "1",
"eventid": "1245463",
"clock": "1472457281",
"message": "problem solved",
"action": "6",
"old_severity": "0",
"new_severity": "0",
"suppress_until": "1472511600",
"taskid": "0"
}
],
"suppression_data": [
{
"maintenanceid": "15",
"suppress_until": "1472511600",
"userid": "0"
}
],
"suppressed": "1",
"tags": [
{
"tag": "test-tag",
"value": "test-value"
}
]
}
],
"id": 1
}
Преузимање проблема које је корисник потврдио са ID=10
{
"jsonrpc": "2.0",
"method": "problem.get",
"params": {
"output": "extend",
"action": 2,
"action_userids": [10],
"selectAcknowledges": ["userid", "action"],
"sortfield": ["eventid"],
"sortorder": "DESC"
},
"id": 1
}
Одговор:
{
"jsonrpc": "2.0",
"result": [
{
"eventid": "1248566",
"source": "0",
"object": "0",
"objectid": "15142",
"clock": "1472457242",
"ns": "209442442",
"r_eventid": "1245468",
"r_clock": "1472457285",
"r_ns": "125644870",
"correlationid": "0",
"userid": "10",
"name": "Zabbix agent on localhost is unreachable for 5 minutes",
"acknowledged": "1",
"severity": "3",
"cause_eventid": "0",
"opdata": "",
"acknowledges": [
{
"userid": "10",
"action": "2"
}
],
"suppressed": "0"
}
],
"id": 1
}
CEvent::get() in ui/include/classes/api/services/CProblem.php.