problem.get

Descrizione

integer/array problem.get(object parameters)

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

Questo metodo serve per recuperare i problemi non risolti. Se specificato, è anche possibile recuperare ulteriormente i problemi risolti di recente. Il periodo che determina quanto sia "recente" è definito in Administration > General. I problemi risolti prima di tale periodo non vengono conservati nella tabella dei problemi. Per recuperare i problemi risolti più indietro nel passato, usare 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. Le autorizzazioni per chiamare il metodo possono essere revocate nelle impostazioni del ruolo utente. Per ulteriori informazioni, vedere User roles.

Parametri

(object) Parametri che definiscono l'output desiderato.

Il metodo supporta i seguenti parametri.

Parameter Type Description
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 con il tipo specificato.

Per l'elenco dei tipi di evento supportati, fare riferimento alla pagina dell'oggetto evento problema.

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

Per l'elenco dei tipi di oggetto supportati, fare riferimento alla pagina dell'oggetto evento problema.

Predefinito: 0 - trigger.
acknowledged boolean Se impostato su true, restituisce solo i problemi riconosciuti.
action integer Restituisce solo i problemi per i quali sono state eseguite le azioni di aggiornamento evento specificate. Per più azioni, usare la somma di eventuali valori bitmap accettabili come bitmask (ad esempio, 34 per acknowledge e soppressione dell'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 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 i problemi recenti, inclusi quelli risolti entro il ok_period e tutti i problemi non risolti.
Se impostato su false, restituisce solo i problemi non risolti.
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 di aggiornamento del 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) momento fino al quale l'evento sarà soppresso;
taskid - (ID) ID del task se l'evento corrente è in fase di cambio di stato;
maintenanceid - (ID) ID della maintenance.

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) tempo fino al 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 o un array di valori da confrontare.

Non supporta le proprietà di tipo data type text.
sortfield string/array Ordina il risultato in base alle proprietà specificate.

Valori possibili: eventid.
countOutput boolean Questi parametri sono descritti nella reference commentary.
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 uno dei seguenti:

  • un array di oggetti;
  • il numero di oggetti recuperati, se è stato utilizzato il parametro countOutput.

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",
            "suppressed": "1",
            "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",
                    "maintenanceid": "0"
                }
            ],
            "opdata": "",
            "suppression_data": [
                {
                    "maintenanceid": "15",
                    "suppress_until": "1472511600",
                    "userid": "0"
                }
            ],
            "tags": [
                {
                    "tag": "test-tag",
                    "value": "test-value"
                }
            ],
            "urls": []
        }
    ],
    "id": 1
}

Recupero dei problemi riconosciuti da un 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 on localhost is unreachable for 5 minutes",
            "acknowledged": "1",
            "severity": "3",
            "cause_eventid": "0",
            "suppressed": "0",
            "acknowledges": [
                {
                    "acknowledgeid": "9",
                    "userid": "10",
                    "action": "2"
                }
            ],
            "opdata": "",
            "urls": []
        }
    ],
    "id": 1
}

Vedi anche

Fonte

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