[comment]: # translation:outdated

[comment]: # ({9464a98f-9464a98f})
# event.get

[comment]: # ({/9464a98f-9464a98f})

[comment]: # ({46def64c-a2311b6e})
### Опис

`integer/array event.get(object parameters)`

Метода омогућава преузимање догађаја према датим параметрима.

::: noteimportant
Ова метода може вратити догађаје избрисаног ентитета
 ако ти догађаји још увек нису уклоњени од стране сервисног чишћења
историје.
:::

::: noteclassic
Ова метода је доступна корисницима било ког типа. Дозволе 
за позивање методе могу се опозвати у подешавањима улоге корисника. Погледајте [Корисничке 
улоге](/manual/web_interface/frontend_sections/users/user_roles) 
за више информација.
:::

[comment]: # ({/46def64c-a2311b6e})

[comment]: # ({8a268fa1-99511e47})
### Параметри

`(object)` Параметри који дефинишу жељени излаз.

Метод подржава следеће параметре.

|Parameter|[Type](/manual/api/reference_commentary#data_types)|Опис|
|--|--|-- ----|
|eventids|ID/array|Врати само догађаје са датим ID-ијевима.|
|groupids|ID/array|Врати само догађаје креиране од објеката који припадају датим групама домаћина.|
|hostids|ID/array|Враћа само догађаје креиране од објеката који припадају датим домаћинима.|
|objectids|ID/array|Врати само догађаје креиране од датих објеката.|
|source|integer|Врати само догађаје са датим типом.<br><br> Погледајте [страницу објекта догађаја](object#event) за листу подржаних типова догађаја.<br><br>Подразумевано: 0 - окидачи догађаја.|
|object|integer|Врати само догађаје креиране од објеката датог типа .<br><br>Погледајте на [страници подржаних догађаја](object#event) за листу подржаних типова објеката.<br><br>Подразумевано: 0 - окидач.|
|acknowledged|boolean|Ако је подешено на `true` враћа само потврђене догађаје.|
|action|integer|Врати само догађаје за које су извршене дате [акције ажурирања догађаја](/manual/api/reference/event/acknowledge#parameters). За више акција, користите комбинацију било које прихватљиве битмап вредности као битмаску(на пример, 34 за потврду и сузбијање догађаја).|
|action_userids|ID/array|Врати само догађаје са датим ID-ијевима корисника који су извршили акције ажурирања догађаја.|
|suppressed|boolean|`true` - врати само потиснути догађаји;<br>`false` - враћа догађаје у нормално стање.|
|symptom|boolean|`true` - враћа само догађаје симптома;<br>`false` - враћа само догађаје узрока.|
|severities|integer/array|Врати само догађаје са датом озбиљношћу догађаја. Примењује се само ако је објекат окидач.|
|trigger_severities|integer/array|Врати само догађаје са датим озбиљностима окидача. Примењује се само ако је објекат окидач.|
|evaltype|integer|Правила за претрагу ознака.<br><br>Могуће вредности:<br>0 - (подразумевано) И/Или;<br>2 - Или.|
|tags|array|Врати само догађаје са датим ознакама. Тачно подударање по ознаци и претрага без обзира на велика и мала слова по вредности и оператору.<br>Формат: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>Празан низ враћа све догађаје.<br><br>Могући типови оператора:<br>0 - (подразумевано) Свиђа ми се;<br>1 - Једнако;<br>2 - Не као;<br>3 - Није једнако<br>4 - Постоји;<br>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` са ажурирањима догађаја. Ажурирања догађаја се сортирају обрнутим хронолошким редоследом.<br><br>Објекат ажурирања догађаја има следећа својства:<br>`acknowledgeid` - `(ID)` ID потврде;<br>`userid` - `(ID) ` ID корисника који је ажурирао догађај;<br>`clock` - `(timestamp)` време када је догађај ажуриран;<br>`message ` - `(string)` текст поруке;<br>` action ` - `(integer)` акција ажурирања која је извршена, погледајте[`event.acknowledge`](/manual/api/reference/event/acknowledge);<br>`old_severity` - `(integer)` озбиљност догађаја пре ове акције ажурирања;<br>`new_severity` - `(integer)` озбиљност догађаја након ове акције ажурирања;<br>`suppress_until`` - `(timestamp)` време до догађаја ће бити потиснуто;<br>`taskid ` - ` (ID)` ID задатка ако тренутни догађај пролази кроз промену ранга;<br>`username` - `(string)` корисничко име корисника који је ажурирао догађај;<br>`name ` - `(string)` име корисника који је ажурирао догађај;<br>`surname` - `(string)` презиме корисника који је ажурирао догађај.<br><br>Подржава `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` са листом активних одржавања и ручних сузбијања:<br>`maintenanceid ` - `(ID)` ID одржавања; <br>`userid` - `(ID)` ID корисника који је потиснуо догађај;<br>`suppress_until` - `(integer)` време док се догађај не потисне.|
|selectTags|query|Врати [`tags`](/manual/api/reference/event/object#event_tag) својство са ознакама догађаја.|
|filter|object|Врати само оне резултате који се тачно подударају са датим филтером.<br><br>Прихвата објекат, где су кључеви имена својстава, а вредности су или једна вредност или низ вредности за подударање.<br><br>Не подржава својства `text `[тип податка](/manual/api/reference_commentary#data-types).|
|sortfield|string/array|Сортирај резултат према датим својствима.<br><br>Могуће вредности: `eventid `, `objectid `, `clock `.<br><br>Могуће вредности када се користи заједно са `groupBy`: `objectid `.<br><br>Могуће вредности када се користе заједно са `countOutput` и `groupBy`: `objectid `, `rowscount `.|
|groupBy|string/array|Групишите резултате према датим особинама. Наведена својства ће бити враћена у резултатима.<br><br>Могуће вредности: `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|^|

[comment]: # ({/8a268fa1-99511e47})

[comment]: # ({e9f1f4d9-7223bab1})
### Повратне вредности

`(integer/array)` Враћа или:

- низ објеката;
- број преузетих објеката, ако је коришћен параметар `countOutput`, али параметар `groupBy` није коришћен;
- низ објеката са резултате агрегације, ако је коришћен параметар `groupBy`.

[comment]: # ({/e9f1f4d9-7223bab1})

[comment]: # ({b41637d2-b41637d2})
### Примери

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({70ce5d87-7bd1e923})
#### Преузимање догађаја окидача

Преузми најновије догађаје са окидача "22395".

[Request](/manual/api#performing-requests):

```json
{
     "jsonrpc": "2.0",
     "method": "event.get",
     "params": {
     "output": "extend",
     "selectAcknowledges": "extend",
     "selectSuppressionData": "extend",
     "selectTags": "extend",
     "objectids": "22395",
     "sortfield": ["clock", "eventid"],
     "sortorder": "DESC"
     },
     "id": 1
}
```

Одговор:

```json
{
     "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
}
```

[comment]: # ({/70ce5d87-7bd1e923})

[comment]: # ({095783aa-adbe5436})
#### Преузимање догађаја по временском периоду

Преузми све догађаје који су направљени између 9. и 10. октобра 
2012, обрнутим хронолошким редоследом.

[Захтев](/manual/api#performing-requests):

```json
{
     "jsonrpc": "2.0",
     "method": "event.get",
     "params": {
     "output": "extend",
     "time_from": "1349797228",
     "time_till": "1350661228",
     "sortfield": ["clock", "eventid"],
     "sortorder": "desc"
     },
     "id": 1
}
```

Одговор:

```json
{
     "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
}
```

[comment]: # ({/095783aa-adbe5436})

[comment]: # ({9d95bc7c-by})
#### Преузимање догађаја које је потврдио одређени корисник

Преузимање догађаја које је корисник потврдио са ID= 10

[Захтев](/manual/api#performing-requests):

```json
{
     "jsonrpc": "2.0",
     "method": "event.get",
     "params": {
     "output": "extend",
     "action": 2,
     "action_userids": [10],
     "selectAcknowledges": ["userid", "action"],
     "sortfield": ["eventid"],
     "sortorder": "DESC"
     },
     "id": 1
}
```

Одговор:

```json
{
     "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
}
```

[comment]: # ({/9d95bc7c-by})

[comment]: # ({af4d5016-5c2aeeb7})
#### Преузимање главних окидача са бројем проблематичних догађаја

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

[Request](/manual/api#performing-requests):

```json
{
     "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
}
```

Одговор:

```json
{
     "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
}
```

[comment]: # ({/af4d5016-5c2aeeb7})

[comment]: # ({ac13b9c8-c6eb3ba0})
### Такође погледајте

- [Упозорење](/manual/api/reference/alert/object#alert)
- [Ставка](/manual/api/reference/item/object#item)
- [Домаћин](/manual/api/reference/host/object#host)
- [LLD правило](/manual/api/reference/discoveryrule/object#lld-rule)
- [Сервис](/manual/api/reference/service/object#service)
- [Окидач](/manual/api/reference/trigger/object#trigger)

[comment]: # ({/ac13b9c8-c6eb3ba0})

[comment]: # ({f85dc7ca-f85dc7ca})
### Извор

CEvent::get() у *ui/include/classes/api/services/CEvent.php*.

[comment]: # ({/f85dc7ca-f85dc7ca})