event.get

Description

integer/array event.get(object parameters)

La méthode permet de récupérer des événements en fonction des paramètres donnés.

Cette méthode peut renvoyer des événements d'une entité supprimée si ces événements n'ont pas encore été supprimés par le housekeeper.

Cette méthode est disponible pour tous les types d'utilisateurs. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres du le rôle d'utilisateur. Voir Rôles Utilisateur pour plus d'informations.

Paramètres

(object) Paramètres définissant la sortie souhaitée.

La méthode prend en charge les paramètres suivants.

Paramètre	Type	Description
eventids	string/array	Renvoie uniquement les événements avec les identifiants donnés.
groupids	string/array	Renvoie uniquement les événements créés par des objets appartenant aux groupes d'hôtes donnés.
hostids	string/array	Renvoie uniquement les événements créés par des objets appartenant aux hôtes donnés.
objectids	string/array	Renvoie uniquement les événements créés par les objets donnés.
source	integer	Renvoie uniquement les événements avec le type donné. Se référer à la page de l'objet Événement pour une liste des types d'événements supportés. Par défaut : 0 - événements de déclencheur.
object	integer	Renvoie uniquement les événements créés par des objets du type donné. Se référer à la page de l'objet Événement pour une liste des types d'événements supportés. Par défaut : 0 - déclencheur.
acknowledged	boolean	Si défini à `true`, ne renvoie que les événements acquittés.
suppressed	boolean	`true` - Renvoie uniquement les événements supprimés ; `false` - Renvoie uniquement les événements supprimés dont l'état est normal.
severities	integer/array	Renvoie uniquement les événements avec des sévérités données. S'applique uniquement si l'objet est déclencheur.
evaltype	integer	Règles pour la recherche de tags. Valeurs possibles : 0 - (par défaut) et/ou ; 2 - ou.
tags	array of object	Renvoie uniquement les événements avec des tags donnés. Correspondance exacte par tag et recherche non sensible à la casse par valeur et opérateur. Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`. Un tableau vide renvoie tous les événements. Types d'opérateurs possibles : 0 - (par défaut) Like; 1 - Equal; 2 - Not like; 3 - Not equal 4 - Exists; 5 - Not exists.
eventid_from	string	Renvoie uniquement les événements dont l'identifiant est supérieur ou égal à l'identifiant donné.
eventid_till	string	Renvoie uniquement les événements dont l'identifiant est inférieur ou égal à l'identifiant donné.
time_from	timestamp	Renvoie uniquement les événements créés après ou à l'heure indiquée.
time_till	timestamp	Renvoie uniquement les événements créés avant ou à l'heure indiquée.
problem_time_from	timestamp	Renvoie uniquement les événements qui étaient en état problème depuis `problem_time_from`. S'applique uniquement si la source est un événement de déclencheur et que l'objet est un déclencheur. Obligatoire si `problem_time_till` est spécifié.
problem_time_till	timestamp	Renvoie uniquement les événements qui étaient en état problème jusqu'à`problem_time_till`. S'applique uniquement si la source est un événement de déclencheur et que l'objet est un déclencheur. Obligatoire si `problem_time_from` est spécifié.
value	integer/array	Renvoie uniquement les événements avec les valeurs données.
selectHosts	query	Renvoie une propriété hosts avec les hôtes contenant l'objet qui a créé l'événement. Pris en charge uniquement pour les événements générés par des déclencheurs, des éléments ou des règles de découverte bas niveau.
selectRelatedObject	query	Renvoie une propriété `relatedObject avec l'objet qui a créé l'événement dans la propriété`. Le type d'objet renvoyé dépend du type d'événement.
select_alerts	query	Renvoie une propriété alerts avec les alertes générées par l'événement. Les alertes sont triées dans l'ordre chronologique inverse.
select_acknowledges	query	Renvoie une propriété `acknowledges` les mises à jour de l'événement. Les mises à jour d'événements sont triées dans l'ordre chronologique inverse. L'objet de mise à jour d'événement a les propriétés suivantes : `acknowledgeid` - `(string)` ID de l'acquittement ; `userid` - `(string)` ID de l'utilisateur qui a mis à jour l'événement ; `eventid` - `(string)` ID de l'événement mis à jour ; `clock` - `(timestamp)` heure de mise à jour de l'événement ; `message` - `(string)` texte du message ; `action` - `(integer)` action de mise à jour effectuée, voir event.acknowledge ; `old_severity` - `(integer)` sévérité de l'événement avant cette action de mise à jour ; `new_severity` - `(integer)` sévérité de l'événement après cette action de mise à jour ; `username` - `(string)` username de l'utilisateur qui a mis à jour l'événement ; `name` - `(string)` nom de l'utilisateur qui a mis à jour l'événement ; `surname` - `(string)` nom de famille de l'utilisateur qui a mis à jour l'événement. Supporte `count`.
selectTags	query	Renvoie une propriété tags avec les tags d'événement.
selectSuppressionData	query	Renvoie une propriété `suppression_data` avec la liste de maintenances : `maintenanceid` - `(string)` ID de la maintenance ; `suppress_until` - `(integer)` temps avant que l'événement soit supprimé.
sortfield	string/array	Trie le résultat par les propriétés données. Les valeurs possibles sont : `eventid`, `objectid` et `clock`.
countOutput	boolean	Ces paramètres, communs à toutes les méthodes "get", sont décrits dans les commentaires de référence.
editable	boolean
excludeSearch	boolean
filter	object
limit	integer
output	query
preservekeys	boolean
search	object
searchByAny	boolean
searchWildcardsEnabled	boolean
sortorder	string/array
startSearch	boolean

Valeurs retournées

(integer/array) Retourne soit :

un tableau d'objets ;
le nombre d'objets récupérés, si le paramètre countOutput a été utilisé.

Exemples

Récupération d'événements de déclencheur

Récupérer les derniers événements du déclencheur "13926".

Requête :

{
           "jsonrpc": "2.0",
           "method": "event.get",
           "params": {
               "output": "extend",
               "select_acknowledges": "extend",
               "selectTags": "extend",
               "selectSuppressionData": "extend",
               "objectids": "13926",
               "sortfield": ["clock", "eventid"],
               "sortorder": "DESC"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Réponse :

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "eventid": "9695",
                   "source": "0",
                   "object": "0",
                   "objectid": "13926",
                   "clock": "1347970410",
                   "value": "1",
                   "acknowledged": "1",
                   "ns": "413316245",
                   "name": "MySQL is down",
                   "severity": "5",
                   "r_eventid": "0",
                   "c_eventid": "0",
                   "correlationid": "0",
                   "userid": "0",
                   "opdata": "",
                   "acknowledges": [
                       {
                           "acknowledgeid": "1",
                           "userid": "1",
                           "eventid": "9695",
                           "clock": "1350640590",
                           "message": "Problem resolved.\n\r----[BULK ACKNOWLEDGE]----",
                           "action": "6",
                           "old_severity": "0",
                           "new_severity": "0",
                           "username": "Admin",
                           "name": "Zabbix",
                           "surname": "Administrator"
                       }
                   ],
                   "suppression_data": [
                       {
                           "maintenanceid": "15",
                           "suppress_until": "1472511600"
                       }
                   ],
                   "suppressed": "1",
                   "tags": [
                       {
                           "tag": "service",
                           "value": "mysqld"
                       },
                       {
                           "tag": "error",
                           "value": ""
                       }
                   ]
               },
               {
                   "eventid": "9671",
                   "source": "0",
                   "object": "0",
                   "objectid": "13926",
                   "clock": "1347970347",
                   "value": "0",
                   "acknowledged": "0",
                   "ns": "0",
                   "name": "Unavailable by ICMP ping",
                   "severity": "4",
                   "r_eventid": "0",
                   "c_eventid": "0",
                   "correlationid": "0",
                   "userid": "0",
                   "opdata": "",
                   "acknowledges": [],
                   "suppression_data": [],
                   "suppressed": "0",
                   "tags": []
               }
           ],
           "id": 1
       }

Récupération d'événements par période de temps

Récupérer tous les événements créés entre le 9 et le 10 octobre 2012, dans l'ordre chronologique inverse.