Documentation
Table of Contents
event.get
Опис
integer/array event.get(object parameters)
Метода омогућава преузимање догађаја према датим параметрима.
Ова метода може вратити догађаје избрисаног ентитета ако ти догађаји још увек нису уклоњени од стране сервисног чишћења историје.
Ова метода је доступна корисницима било ког типа. Дозволе за позивање методе могу се опозвати у подешавањима улоге корисника. Погледајте Корисничке улоге за више информација.
Параметри
(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 враћа само потврђене догађаје.| |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 својство са упозорењима која генерише догађај. Упозорења су сортирана обрнутим хронолошким редоследом.| |selectHosts|query|Враћа својство hosts са домаћинима који садрже објекат који је креирао догађај. Подржано само за догађаје генерисане окидачима, ставкама или LLD правилима.| |selectRelatedObject|query|Враћа својство relatedObject са објектом који је креирао догађај. Тип враћеног објекта зависи од типа догађаја.| |selectSuppressionData|query|Враћа својство suppression_data са листом активних одржавања и ручних сузбијања:maintenanceid - (ID) ID одржавања; userid - (ID) ID корисника који је потиснуо догађај;suppress_until - (integer) време док се догађај не потисне.| |selectTags|query|Враћа tags својство са ознакама догађаја.| |filter|object|Враћа само оне резултате који се тачно подударају са датим филтером.
Прихвата објекат, где су кључеви имена својстава, а вредности су или једна вредност или низ вредности за подударање.
Не подржава својства textтип податка.| |sortfield|string/array|Сортирај резултат према датим својствима.
Могуће вредности: eventid, objectid, clock.
Могуће вредности када се користи заједно са groupBy: objectid.
Могуће вредности када се користе заједно са countOutput и groupBy: objectid, rowscount.| |groupBy|string/array|Групише резултате према датим особинама. Наведена својства ће бити враћена у резултатима.
Могуће вредности: objectid.| |countOutput|boolean|Ови параметри су описани у референтном коментару.| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^| |select_acknowledges
(застарео)| query |Овај параметар је застарео, молим користите selectAcknowledges уместо тога.
Вратите својство acknowledges са ажурирањима догађаја.
Ажурирања догађаја се сортирају у обрнутом хронолошком редоследу.
Објекат ажурирања догађаја има следећа својства:acknowledgeid - (ID) ID потврде;userid - (ID) ID корисника који је ажурирао догађај;<br >clock - (timestamp) време када је догађај ажуриран;mesage - (string) текст поруке;action - (integer) акција ажурирања која је извршена, погледајте event.acknowledge;old_severity - (integer) озбиљност догађаја пре ове акције ажурирања;new_severity - (integer) озбиљност догађаја након ове акције ажурирања;suppress_until - (timestamp) време до догађаја ће бити потиснуто;taskid - (ID) ID задатка ако тренутни догађај пролази кроз промену ранга;username - ( string) корисничко име корисника који је ажурирао догађај;name - (string) име корисника који је ажурирао догађај;surname - (string) презиме корисника који је ажурирао догађај.
Подржава count.| |select_alerts
(застарео)|query|Овај параметар је застарео, молимо користите selectAlerts уместо тога.
Враћа alerts својство са упозорењима генерисаним догађајем.
Упозорења су сортирана обрнутим хронолошким редоследом.|
Повратне вредности
(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.