event.get

Beschrijving

integer/array event.get(object parameters)

De methode maakt het mogelijk om gebeurtenissen op te halen volgens de gegeven parameters.

Deze methode kan gebeurtenissen van een verwijderde entiteit retourneren als deze gebeurtenissen niet door de huishoudster zijn verwijderd nog.

Deze methode is beschikbaar voor gebruikers van elk type. Rechten om de methode aan te roepen, kan worden ingetrokken in de instellingen van de gebruikersrol. Zie Gebruiker rollen voor meer informatie.

Parameters

(object) Parameters die de gewenste uitvoer definiëren.

De methode ondersteunt de volgende parameters.

Parameter	Type	Beschrijving
eventids	string/array	Retourneer alleen gebeurtenissen met de opgegeven ID's.
groupids	string/array	Retourneert alleen gebeurtenissen die zijn gemaakt door objecten die tot de opgegeven hostgroepen behoren.
hostids	string/array	Retourneert alleen gebeurtenissen die zijn gemaakt door objecten die bij de opgegeven hosts horen.
objectids	string/array	Retourneert alleen gebeurtenissen die zijn gemaakt door de opgegeven objecten.
source	integer	Retourneert alleen gebeurtenissen met het opgegeven type. Raadpleeg de pagina met gebeurtenisobjecten voor een lijst met ondersteunde gebeurtenistypen. Standaard: 0 - gebeurtenissen activeren.
object	integer	Retourneer alleen gebeurtenissen die zijn gemaakt door objecten van het opgegeven type. Raadpleeg de pagina met gebeurtenisobjecten voor een lijst met ondersteunde objecttypen. Standaard : 0 - trigger.
acknowledged	boolean	Indien ingesteld op `true`, worden alleen bevestigde gebeurtenissen geretourneerd.
suppressed	boolean	`true` - retourneert alleen onderdrukte gebeurtenissen; `false` - retourneert gebeurtenissen in de normale staat.
severities	integer/array	Retourneert alleen gebeurtenissen met een bepaalde gebeurtenisernst. Is alleen van toepassing als object trigger is.
evaltype	integer	Regels voor het zoeken naar tags. Mogelijke waarden: 0 - (standaard) And/Or; 2 - Or.
tags	array van objecten	Retourneer alleen gebeurtenissen met opgegeven tags. Exacte overeenkomst op tag en hoofdletterongevoelig zoeken op waarde en operator. Formaat: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator> "}, ...]`. Een lege array retourneert alle gebeurtenissen. Mogelijke typen operatoren: 0 - (standaard) Like; 1 - Equal; 2 - Niet leuk; 3 - Niet gelijk 4 - Bestaat; 5 - Bestaat niet.
eventid_from	string	Retourneer alleen gebeurtenissen met ID's groter of gelijk aan de opgegeven ID.
eventid_till	string	Retourneer alleen gebeurtenissen met ID's die kleiner of gelijk zijn aan de opgegeven ID.
time_from	timestamp	Retourneer alleen gebeurtenissen die na of op het opgegeven tijdstip zijn gemaakt.
time_till	timestamp	Retourneer alleen gebeurtenissen die voor of op het opgegeven tijdstip zijn gemaakt.
problem_time_from	timestamp	Retourneert alleen gebeurtenissen die de probleemstatus hadden, beginnend met `problem_time_from`. Is alleen van toepassing als de bron een triggergebeurtenis is en het object een trigger is. Verplicht als `problem_time_till` is opgegeven.
problem_time_till	timestamp	Retourneert alleen gebeurtenissen die zich in de probleemstatus bevonden tot `problem_time_till`. Is alleen van toepassing als de bron een triggergebeurtenis is en het object een trigger is. Verplicht als `problem_time_from` is opgegeven.
value	integer/array	Retourneert alleen gebeurtenissen met de opgegeven waarden.
selectHosts	query	Retourneer een eigenschap hosts met hosts die het object bevatten dat de gebeurtenis heeft gemaakt. Alleen ondersteund voor gebeurtenissen die worden gegenereerd door triggers, items of LLD-regels.
selectRelatedObject	query	Retourneer een eigenschap `relatedObject` met het object dat de gebeurtenis heeft gemaakt. Het type object dat wordt geretourneerd, is afhankelijk van het gebeurtenistype.
select_alerts	query	Retourneer een eigenschap alerts met waarschuwingen die door de gebeurtenis zijn gegenereerd. Waarschuwingen worden in omgekeerde chronologische volgorde gesorteerd.
select_acknowledges	query	Retourneer een `acknowledges` eigenschap met gebeurtenisupdates. Gebeurtenisupdates worden in omgekeerde chronologische volgorde gesorteerd. Het gebeurtenisupdate-object heeft de volgende eigenschappen: `acknowledgeid` - `(string)` bevestigings-ID; `userid` - `(string)` ID van de gebruiker die de gebeurtenis heeft bijgewerkt; `eventid` - `(string)` ID van de bijgewerkte gebeurtenis; `clock` - `(timestamp)` tijd waarop de gebeurtenis is bijgewerkt; `message` - `(string)` tekst van het bericht; `action` - `(integer)` update-actie die is uitgevoerd zie event.acknowledge; `old_severity` - `(integer)` ernst van de gebeurtenis vóór deze update-actie; `new_severity` - `(integer)` ernst van de gebeurtenis na deze update-actie; `gebruikersnaam` - `(string)` gebruikersnaam van de gebruiker die de gebeurtenis heeft bijgewerkt; `naam` - `(string)` naam van de gebruiker die de gebeurtenis heeft bijgewerkt; `achternaam` - `(string)` achternaam van de gebruiker die de gebeurtenis heeft bijgewerkt . Ondersteunt `count`.
selectTags	query	Retourneer een eigenschap tags met gebeurtenistags.
selectSuppressionData	query	Retourneer een eigenschap `suppression_data` met de lijst met onderhoud: `maintenanceid` - `(string)` ID van het onderhoud; `suppress_until` - `(integer)` tijd tot de gebeurtenis wordt onderdrukt.
sortfield	string/array	Sorteer het resultaat op de gegeven eigenschappen. Mogelijke waarden zijn: `eventid`, `objectid` en `clock`.
countOutput	boolean	Deze parameters gelden voor alle `get`-methoden en worden in detail beschreven op de pagina referentiecommentaar.
editable	booleaans
excludeSearch	boolean
filter	object
limiet	geheel getal
uitvoer	vraag
preservekeys	boolean
zoeken	object
searchByAny	boolean
searchWildcardsIngeschakeld	boolean
sortorde	string/array
startZoeken	booleaans

Retourwaarden

(integer/array) Retourneert ofwel:

een reeks objecten;
het aantal opgehaalde objecten, als de countOutput parameter heeft gebruikt.

Voorbeelden

Ophalen van triggergebeurtenissen

Haal de laatste gebeurtenissen op uit trigger '13926'.

Verzoek:

{
           "jsonrpc": "2.0",
           "methode": "event.get",
           "parameters": {
               "uitvoer": "verlengen",
               "select_acknowledges": "verlengen",
               "selectTags": "verlengen",
               "selectSuppressionData": "verlengen",
               "objectids": "13926",
               "sortfield": ["klok", "eventid"],
               "sorteervolgorde": "DESC"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Antwoord:

{
           "jsonrpc": "2.0",
           "resultaat": [
               {
                   "eventid": "9695",
                   "bron": "0",
                   "object": "0",
                   "objectid": "13926",
                   "klok": "1347970410",
                   "waarde": "1",
                   "erkend": "1",
                   "ns": "413316245",
                   "name": "MySQL is niet beschikbaar",
                   "ernst": "5",
                   "r_eventid": "0",
                   "c_eventid": "0",
                   "correlatie-id": "0",
                   "use-id": "0",
                   "opdata": "",
                   "erkent": [
                       {
                           "acknowledgeid": "1",
                           "use-ID": "1",
                           "eventid": "9695",
                           "klok": "1350640590",
                           "message": "Probleem opgelost.\n\r----[BULK ACKNOWLEDGE]----",
                           "actie": "6",
                           "old_severity": "0",
                           "new_severity": "0",
                           "gebruikersnaam": "Beheerder",
                           "naam": "Zabbix",
                           "achternaam": "Beheerder"
                       }
                   ],
                   "suppression_data": [
                       {
                           "onderhoudsnummer": "15",
                           "suppress_until": "1472511600"
                       }
                   ],
                   "onderdrukt": "1",
                   "tags": [
                       {
                           "tag": "service",
                           "waarde": "mysqld"
                       },
                       {
                           "tag": "fout",
                           "waarde": ""
                       }
                   ]
               },
               {
                   "eventid": "9671",
                   "bron": "0",
                   "object": "0",
                   "objectid": "13926",
                   "klok": "1347970347",
                   "waarde": "0",
                   "bevestigd": "0",
                   "ns": "0",
                   "name": "Niet beschikbaar door ICMP-ping",
                   "ernst": "4",
                   "r_eventid": "0",
                   "c_eventid": "0",
                   "correlatie-id": "0",
                   "use-id": "0",
                   "opdata": "",
                   "bevestigt": [],
                   "suppression_data": [],
                   "onderdrukt": "0",
                   "tags": []
               }
           ],
           "id": 1
       }

Gebeurtenissen ophalen op tijdsperiode

Haal alle evenementen op die tussen 9 en 10 oktober zijn gemaakt, 2012, in omgekeerde chronologische volgorde.