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)време до догађаја ће бити потиснуто;<br>taskid - (ID)ID задатка ако тренутни догађај пролази кроз промену ранга;<br>username-(string)корисничко име корисника који је ажурирао догађај;<br>name -(string)име корисника који је ажурирао догађај;<br>surname-(string)презиме корисника који је ажурирао догађај.<br><br>Подржава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 Ови параметри који су заједнички за све методе get су детаљно описани у референтном коментару странице.
editable boolean
excludeSearch boolean
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Повратне вредности

(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": "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 окидача који имају озбиљност "Упозорење", "Просечна", "Висока" или "Катастрофа", заједно са бројем проблематичних догађаја у одређеном временском периоду.

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.