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".

Request:

{
     "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": "20617",
     "source": "0",
     "object": "0",
     "objectid": "14282",
     "clock": "1350477816",
     "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": "20616",
     "source": "0",
     "object": "0",
     "objectid": "14283",
     "clock": "1350477814",
     "value": "0",
     "acknowledged": "0",
     "ns": "0",
     "name": "Zabbix trapper processes more than 75% busy",
     "severity": "0",
     "r_eventid": "0",
     "c_eventid": "0",
     "correlationid": "0",
     "userid": "0",
     "cause_eventid": "0",
     "opdata": "",
     "suppressed": "0",
     "urls": []
     },
     {
     "eventid": "20615",
     "source": "0",
     "object": "0",
     "objectid": "14281",
     "clock": "1350477541",
     "value": "1",
     "acknowledged": "0",
     "ns": "0",
     "name": "High ICMP ping loss",
     "severity": "3",
     "r_eventid": "20616",
     "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": "503",
   "source": "0",
   "object": "0",
   "objectid": "23162",
   "clock": "1747212236",
   "value": "1",
   "acknowledged": "1",
   "ns": "413470863",
   "name": "Number of installed packages has been changed",
   "severity": "2",
   "r_eventid": "0",
   "c_eventid": "0",
   "correlationid": "0",
   "userid": "0",
   "cause_eventid": "0",
   "acknowledges": [
   {
   "userid": "10",
   "action": "2"
   }
   ],
   "opdata": "",
   "suppressed": "0",
   "urls": []
   }
   ],
   "id": 1
}

Преузимање главних окидача са бројем проблематичних догађаја

Преузмите првих 5 окидача који имају озбиљност "Упозорење", "Просечна", "Висока" или "Катастрофа", заједно са бројем проблематичних догађаја у одређеном временском периоду.

Request:

{
     "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.