problem.get

Descrizione

integer/array problem.get(object parameters)

Questo metodo consente di recuperare i problemi in base ai parametri specificati.

Questo metodo serve per recuperare i problemi non risolti. È anche possibile, se specificato, recuperare inoltre i problemi risolti di recente. Il periodo che determina quanto indietro nel tempo si intende per "di recente" è definito in Administration → General. I problemi che sono stati risolti prima di tale periodo non vengono mantenuti nella tabella dei problemi. Per recuperare i problemi che sono stati risolti più indietro nel passato, utilizzare il metodo event.get.

Questo metodo può restituire problemi di un'entità eliminata se tali problemi non sono ancora stati rimossi dall'housekeeper.

Questo metodo è disponibile per utenti di qualsiasi tipo. I permessi per chiamare il metodo possono essere revocati nelle impostazioni del ruolo utente. Vedere User roles per ulteriori informazioni.

Parametri

(object) Parametri che definiscono l'output desiderato.

Il metodo supporta i seguenti parametri.

Parametro Type Descrizione
eventids ID/array Restituisce solo i problemi con gli ID specificati.
groupids ID/array Restituisce solo i problemi creati da oggetti che appartengono ai gruppi host specificati.
hostids ID/array Restituisce solo i problemi creati da oggetti che appartengono agli host specificati.
objectids ID/array Restituisce solo i problemi creati dagli oggetti specificati.
source integer Restituisce solo i problemi del tipo specificato.

Fare riferimento alla pagina dell'oggetto evento problema per un elenco dei tipi di evento supportati.

Predefinito: 0 - problema creato da un trigger.
object integer Restituisce solo i problemi creati da oggetti del tipo specificato.

Fare riferimento alla pagina dell'oggetto evento problema per un elenco dei tipi di oggetto supportati.

Predefinito: 0 - trigger.
acknowledged boolean Se impostato su true, restituisce solo i problemi confermati.
action integer Restituisce solo i problemi per i quali sono state eseguite le azioni di aggiornamento evento specificate. Per più azioni, utilizzare la somma di qualsiasi valore bitmap accettabile come bitmask (ad esempio, 34 per confermare e sopprimere l'evento).
action_userids ID/array Restituisce solo i problemi con gli ID specificati degli utenti che hanno eseguito le azioni di aggiornamento dell'evento problema.
suppressed boolean Se impostato su true, restituisce solo i problemi soppressi.
symptom boolean Se impostato su true, restituisce solo gli eventi problema di tipo sintomo.
severities integer/array Restituisce solo i problemi con le severità evento specificate. Si applica solo se object è trigger.
evaltype integer Metodo di valutazione dei tag.

Valori possibili:
0 - (predefinito) And/Or;
2 - Or.
tags array Restituisce solo i problemi con i tag specificati.
Formato: [{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...].
Un array vuoto restituisce tutti i problemi.

Valori possibili di operator:
0 - (predefinito) Contiene;
1 - Uguale a;
2 - Non contiene;
3 - Diverso da;
4 - Esiste;
5 - Non esiste.
recent boolean Se impostato su true, restituisce solo i problemi risolti di recente (dipende da ok_period).
eventid_from string Restituisce solo i problemi con ID maggiori o uguali all'ID specificato.
eventid_till string Restituisce solo i problemi con ID minori o uguali all'ID specificato.
time_from timestamp Restituisce solo i problemi creati dopo o al momento specificato.
time_till timestamp Restituisce solo i problemi creati prima o al momento specificato.
selectAcknowledges query Restituisce una proprietà acknowledges con gli aggiornamenti del problema. Gli aggiornamenti del problema sono ordinati in ordine cronologico inverso.

L'oggetto aggiornamento problema ha le seguenti proprietà:
acknowledgeid - (ID) ID dell'aggiornamento;
userid - (ID) ID dell'utente che ha aggiornato l'evento;
eventid - (ID) ID dell'evento aggiornato;
clock - (timestamp) ora in cui l'evento è stato aggiornato;
message - (string) testo del messaggio;
action - (integer) tipo di azione di aggiornamento (vedere event.acknowledge);
old_severity - (integer) severità dell'evento prima di questa azione di aggiornamento;
new_severity - (integer) severità dell'evento dopo questa azione di aggiornamento;
suppress_until - (timestamp) ora fino alla quale l'evento sarà soppresso;
taskid - (ID) ID del task se l'evento corrente è soggetto a una modifica di rango.

Supporta count.
selectTags query Restituisce una proprietà tags con i tag del problema. Formato di output: [{"tag": "<tag>", "value": "<value>"}, ...].
selectSuppressionData query Restituisce una proprietà suppression_data con l'elenco delle maintenance attive e delle soppressioni manuali:
maintenanceid - (ID) ID della maintenance;
userid - (ID) ID dell'utente che ha soppresso il problema;
suppress_until - (integer) ora fino alla quale il problema è soppresso.
filter object Restituisce solo i risultati che corrispondono esattamente al filtro specificato.

Accetta un oggetto in cui le chiavi sono nomi di proprietà e i valori sono un singolo valore oppure un array di valori da confrontare.

Non supporta proprietà del tipo di dato text.
sortfield string/array Ordina il risultato in base alle proprietà specificate.

Valori possibili: eventid.
countOutput boolean Questi parametri sono descritti nel commento di riferimento.
editable boolean
excludeSearch boolean
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Valori restituiti

(integer/array) Restituisce o:

  • una matrice di oggetti;
  • il conteggio degli oggetti recuperati, se il parametro countOutput è stato usato.

Esempi

Recupero degli eventi di problema del trigger

Recupera gli eventi recenti dal trigger "15112."

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "problem.get",
    "params": {
        "output": "extend",
        "selectAcknowledges": "extend",
        "selectTags": "extend",
        "selectSuppressionData": "extend",
        "objectids": "15112",
        "recent": true,
        "sortfield": ["eventid"],
        "sortorder": "DESC"
    },
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "eventid": "1245463",
            "source": "0",
            "object": "0",
            "objectid": "15112",
            "clock": "1472457242",
            "ns": "209442442",
            "r_eventid": "1245468",
            "r_clock": "1472457285",
            "r_ns": "125644870",
            "correlationid": "0",
            "userid": "1",
            "name": "Zabbix agent on localhost is unreachable for 5 minutes",
            "acknowledged": "1",
            "severity": "3",
            "cause_eventid": "0",
            "opdata": "",
            "acknowledges": [
                {
                    "acknowledgeid": "14443",
                    "userid": "1",
                    "eventid": "1245463",
                    "clock": "1472457281",
                    "message": "problem solved",
                    "action": "6",
                    "old_severity": "0",
                    "new_severity": "0",
                    "suppress_until": "1472511600",
                    "taskid": "0"
                }
            ],
            "suppression_data": [
                {
                    "maintenanceid": "15",
                    "suppress_until": "1472511600",
                    "userid": "0"
                }
            ],
            "suppressed": "1",
            "tags": [
                {
                    "tag": "test-tag",
                    "value": "test-value"
                }
            ]
        }
    ],
    "id": 1
}

Recupero dei problemi riconosciuti dall'utente specificato

Recupero dei problemi riconosciuti dall'utente con ID=10

Richiesta:

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

Risposta:

{
    "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 su localhost non è raggiungibile da 5 minuti",
            "acknowledged": "1",
            "severity": "3",
            "cause_eventid": "0",
            "opdata": "",
            "acknowledges": [
                {
                    "userid": "10",
                    "action": "2"
                }
            ],
            "suppressed": "0"
        }
    ],
    "id": 1
}

Vedi anche

Fonte

CEvent::get() in ui/include/classes/api/services/CProblem.php.