Documentation
Table of Contents
event.get
Опис
integer/array event.get(object parameters)
Метода омогућава преузимање догађаја према датим параметрима.
Ова метода може вратити догађаје избрисаног ентитета ако ти догађаји још увек нису уклоњени од стране сервисног чишћења историје.
Ова метода је доступна корисницима било ког типа. Дозволе за позивање методе могу се опозвати у подешавањима улоге корисника. Погледајте Корисничке улоге за више информација.
Параметри
(object) Параметри који дефинишу жељени излаз.
Метод подржава следеће параметре.
|Parameter|Type|Опис| |--|--|-- ----| |eventids|ID/array|Врати само догађаје са датим ID-ијевима.| |groupids|ID/array|Врати само догађаје креиране од објеката који припадају датим групама домаћина.| |hostids|ID/array|Враћа само догађаје креиране од објеката који припадају датим домаћинима.| |objectids|ID/array|Врати само догађаје креиране од датих објеката.| |source|integer|Врати само догађаје са датим типом.
Погледајте страницу објекта догађаја за листу подржаних типова догађаја.
Подразумевано: 0 - окидачи догађаја.| |object|integer|Врати само догађаје креиране од објеката датог типа .
Погледајте на страници подржаних догађаја за листу подржаних типова објеката.
Подразумевано: 0 - окидач.| |acknowledged|boolean|Ако је подешено на true враћа само потврђене догађаје.| |action|integer|Врати само догађаје за које су извршене дате акције ажурирања догађаја. За више акција, користите комбинацију било које прихватљиве битмап вредности као битмаску(на пример, 34 за потврду и сузбијање догађаја).| |action_userids|ID/array|Врати само догађаје са датим ID-ијевима корисника који су извршили акције ажурирања догађаја.| |suppressed|boolean|true - врати само потиснути догађаји;false - враћа догађаје у нормално стање.| |symptom|boolean|true - враћа само догађаје симптома;false - враћа само догађаје узрока.| |severities|integer/array|Врати само догађаје са датом озбиљношћу догађаја. Примењује се само ако је објекат окидач.| |trigger_severities|integer/array|Врати само догађаје са датим озбиљностима окидача. Примењује се само ако је објекат окидач.| |evaltype|integer|Правила за претрагу ознака.
Могуће вредности:
0 - (подразумевано) И/Или;
2 - Или.| |tags|array|Врати само догађаје са датим ознакама. Тачно подударање по ознаци и претрага без обзира на велика и мала слова по вредности и оператору.
Формат: [{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...].
Празан низ враћа све догађаје.
Могући типови оператора:
0 - (подразумевано) Свиђа ми се;
1 - Једнако;
2 - Не као;
3 - Није једнако
4 - Постоји;
5 - Не постоји.| |eventid_from|string|Врати само догађаје са ID-ијевима који су већи или једнаки датом ID-у.| |eventid_till|string|Врати само догађаје са ID-ијевима мањим или једнаким датом ID-ију.| |time_from|timestamp|Врати само догађаје који су креирани након или у датом тренутку.| |time_till|timestamp|Само врати догађаје који су креирани пре или у датом тренутку.| |problem_time_from|timestamp|Враћа само догађаје који су били у стању проблема почевши са problem_time_from. Примењује се само ако је извор окидач догађај, а објекат окидач. Обавезно ако је наведено problem_time_till.| |problem_time_till|timestamp|Враћа само догађаје који су били у стању проблема до problem_time_till. Примењује се само ако је извор окидач догађај, а објекат окидач. Обавезно ако је наведено problem_time_from.| |value|integer/array|Врати само догађаје са датим вредностима.| |selectAcknowledges|query|Врати својство acknowledges са ажурирањима догађаја. Ажурирања догађаја се сортирају обрнутим хронолошким редоследом.
Објекат ажурирања догађаја има следећа својства:acknowledgeid - (ID) ID потврде;userid - (ID) ID корисника који је ажурирао догађај;clock - (timestamp) време када је догађај ажуриран;message - (string) текст поруке;action - (integer) акција ажурирања која је извршена, погледајтеevent.acknowledge;old_severity - (integer) озбиљност догађаја пре ове акције ажурирања;new_severity - (integer) озбиљност догађаја након ове акције ажурирања;suppress_until`` -(timestamp)време до догађаја ће бити потиснуто;taskid - (ID)ID задатка ако тренутни догађај пролази кроз промену ранга;username-(string)корисничко име корисника који је ажурирао догађај;name -(string)име корисника који је ажурирао догађај;surname-(string)презиме корисника који је ажурирао догађај.count
Подржава.| |selectAlerts|query|Врати [alerts](/manual/api/reference/alert/object) својство са упозорењима која генерише догађај. Упозорења су сортирана обрнутим хронолошким редоследом.| |selectHosts|query|Врати својство [hosts](/manual/api/reference/host/object) са домаћинима који садрже објекат који је креирао догађај. Подржано само за догађаје генерисане окидачима, ставкама или LLD правилима.| |selectRelatedObject|query|Врати својствоrelatedObjectса објектом који је креирао догађај. Тип враћеног објекта зависи од типа догађаја.| |selectSuppressionData|query|Врати својствоsuppression_dataса листом активних одржавања и ручних сузбијања:maintenanceid -(ID)ID одржавања; userid-(ID)ID корисника који је потиснуо догађај;suppress_until-(integer)време док се догађај не потисне.| |selectTags|query|Врати [tags](/manual/api/reference/event/object#event_tag) својство са ознакама догађаја.| |filter|object|Врати само оне резултате који се тачно подударају са датим филтером.text
Прихвата објекат, где су кључеви имена својстава, а вредности су или једна вредност или низ вредности за подударање.
Не подржава својства[тип податка](/manual/api/reference_commentary#data-types).| |sortfield|string/array|Сортирај резултат према датим својствима.eventid
Могуће вредности:,objectid ,clock .groupBy
Могуће вредности када се користи заједно са:objectid .countOutput
Могуће вредности када се користе заједно саиgroupBy:objectid ,rowscount .| |groupBy|string/array|Групишите резултате према датим особинама. Наведена својства ће бити враћена у резултатима.objectid
Могуће вредности:.| |countOutput|boolean|Ови параметри који су заједнички за све методеget су детаљно описани у [референтном коментару](/manual/api/reference_commentary#common_get_method_parameters) странице.| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^| |select\_acknowledgesselectAcknowledges
(застарео)| query |Овај параметар је застарео, користитеуместо тога.acknowledges
Вратите својствоса ажурирањима догађаја.acknowledgeid
Ажурирања догађаја се сортирају у обрнутом хронолошком редоследу.
Објекат ажурирања догађаја има следећа својства:-(ID)ID потврде;userid -(ID)ID корисника који је ажурирао догађај;<br >clock -(timestamp)време када је догађај ажуриран;mesage -(string)текст поруке;action-(integer)акција ажурирања која је извршена, погледајте [event.acknowledge](/manual/api/reference/event/acknowledge);old_severity -(integer)озбиљност догађаја пре ове акције ажурирања;new_severity -(integer)озбиљност догађаја након ове акције ажурирања;suppress_until-(timestamp)време до догађаја ће бити потиснуто;taskid-(ID)ID задатка ако тренутни догађај пролази кроз промену ранга;username -( string)корисничко име корисника који је ажурирао догађај;name-(string)име корисника који је ажурирао догађај;surname-(string)презиме корисника који је ажурирали догађај.count
Подржава.| |select\_alertsselectAlerts
(застарео)|query|Овај параметар је застарео, молимо користитеуместо тога.alerts`](/manual/api/reference/alert/object) својство са упозорењима генерисаним догађајем.
Врати [
Упозорења су сортирана обрнутим хронолошким редоследом.|
Повратне вредности
(integer/array) Враћа или:
- низ објеката;
- број преузетих објеката, ако је коришћен параметар
countOutput, али параметарgroupByније коришћен; - низ објеката са резултате агрегације, ако је коришћен параметар
groupBy.
Примери
Преузимање догађаја окидача
Преузми најновије догађаје са окидача "22395".
{
"jsonrpc": "2.0",
"method": "event.get",
"params": {
"output": "extend",
"selectAcknowledges": "extend",
"selectSuppressionData": "extend",
"selectTags": "extend",
"objectids": "22395",
"sortfield": ["clock", "eventid"],
"sortorder": "DESC"
},
"id": 1
}Одговор:
{
"jsonrpc": "2.0",
"result": [
{
"eventid": "20",
"source": "0",
"object": "0",
"objectid": "22395",
"clock": "1728658089",
"value": "0",
"acknowledged": "0",
"ns": "461809482",
"name": "Load average is too high (per CPU load over 1.5 for 5m)",
"severity": "0",
"r_eventid": "0",
"c_eventid": "0",
"correlationid": "0",
"userid": "0",
"cause_eventid": "0",
"acknowledges": [],
"opdata": "Load averages(1m 5m 15m): (1.6328 3.0522 2.2515), # of CPUs: 2",
"suppression_data": [],
"suppressed": "0",
"tags": [
{
"tag": "scope",
"value": "capacity"
},
{
"tag": "scope",
"value": "performance"
},
{
"tag": "component",
"value": "cpu"
},
{
"tag": "class",
"value": "os"
},
{
"tag": "target",
"value": "linux"
}
],
"urls": []
},
{
"eventid": "4",
"source": "0",
"object": "0",
"objectid": "22395",
"clock": "1728657737",
"value": "1",
"acknowledged": "1",
"ns": "460759366",
"name": "Load average is too high (per CPU load over 1.5 for 5m)",
"severity": "3",
"r_eventid": "20",
"c_eventid": "0",
"correlationid": "0",
"userid": "0",
"cause_eventid": "0",
"acknowledges": [
{
"acknowledgeid": "1",
"userid": "1",
"clock": "1728657938",
"message": "Testing environment. Please disregard this alert.",
"action": "38",
"old_severity": "0",
"new_severity": "0",
"suppress_until": "1728744338",
"taskid": "0",
"username": "Admin",
"name": "Zabbix",
"surname": "Administrator"
}
],
"opdata": "Load averages(1m 5m 15m): (1.6328 3.0522 2.2515), # of CPUs: 2",
"suppression_data": [
{
"maintenanceid": "0",
"suppress_until": "1728744338",
"userid": "1"
}
],
"suppressed": "1",
"tags": [
{
"tag": "scope",
"value": "capacity"
},
{
"tag": "scope",
"value": "performance"
},
{
"tag": "component",
"value": "cpu"
},
{
"tag": "class",
"value": "os"
},
{
"tag": "target",
"value": "linux"
}
],
"urls": []
}
],
"id": 1
}Преузимање догађаја по временском периоду
Преузми све догађаје који су направљени између 9. и 10. октобра 2012, обрнутим хронолошким редоследом.
{
"jsonrpc": "2.0",
"method": "event.get",
"params": {
"output": "extend",
"time_from": "1349797228",
"time_till": "1350661228",
"sortfield": ["clock", "eventid"],
"sortorder": "desc"
},
"id": 1
}Одговор:
{
"jsonrpc": "2.0",
"result": [
{
"eventid": "20616",
"source": "0",
"object": "0",
"objectid": "14282",
"clock": "1350477814",
"value": "1",
"acknowledged": "0",
"ns": "0",
"name": "Less than 25% free in the history cache",
"severity": "3",
"r_eventid": "0",
"c_eventid": "0",
"correlationid": "0",
"userid": "0",
"cause_eventid": "0",
"opdata": "",
"suppressed": "0",
"urls": []
},
{
"eventid": "20617",
"source": "0",
"object": "0",
"objectid": "14283",
"clock": "1350477814",
"value": "0",
"acknowledged": "0",
"ns": "0",
"name": "Zabbix trapper processes more than 75% busy",
"severity": "3",
"r_eventid": "0",
"c_eventid": "0",
"correlationid": "0",
"userid": "0",
"cause_eventid": "0",
"opdata": "",
"suppressed": "0",
"urls": []
},
{
"eventid": "20618",
"source": "0",
"object": "0",
"objectid": "14284",
"clock": "1350477815",
"value": "1",
"acknowledged": "0",
"ns": "0",
"name": "High ICMP ping loss",
"severity": "3",
"r_eventid": "0",
"c_eventid": "0",
"correlationid": "0",
"userid": "0",
"cause_eventid": "0",
"opdata": "",
"suppressed": "0",
"urls": []
}
],
"id": 1
}Преузимање догађаја које је потврдио одређени корисник
Преузимање догађаја које је корисник потврдио са ID= 10
{
"jsonrpc": "2.0",
"method": "event.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",
"acknowledges": [
{
"userid": "10",
"action": "2"
}
],
"opdata": "",
"suppressed": "0",
"urls": []
}
],
"id": 1
}Преузимање главних окидача са бројем проблематичних догађаја
Преузмите првих 5 окидача који имају озбиљност "Упозорење", "Просечна", "Висока" или "Катастрофа", заједно са бројем проблематичних догађаја у одређеном временском периоду.
{
"jsonrpc": "2.0",
"method": "event.get",
"params": {
"countOutput": true,
"groupBy": "objectid",
"source": 0,
"object": 0,
"value": 1,
"time_from": 1672531200,
"time_till": 1677628800,
"trigger_severities": [2, 3, 4, 5],
"sortfield": ["rowscount"],
"sortorder": "DESC",
"limit": 5
},
"id": 1
}Одговор:
{
"jsonrpc": "2.0",
"result": [
{
"objectid": "232124",
"rowscount": "27"
},
{
"objectid": "29055",
"rowscount": "23"
},
{
"objectid": "253731",
"rowscount": "18"
},
{
"objectid": "254062",
"rowscount": "11"
},
{
"objectid": "23216",
"rowscount": "7"
}
],
"id": 1
}Такође погледајте
Извор
CEvent::get() у ui/include/classes/api/services/CEvent.php.