[comment]: # translation:outdated [comment]: # ({48cd3524-48cd3524}) # problem.get [comment]: # ({/48cd3524-48cd3524}) [comment]: # ({c91e55ea-a18b2713}) ### 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](/manual/web_interface/frontend_sections/administration/general#trigger-displaying-options)*. 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`](/manual/api/reference/event/get). ::: noteimportant Questo metodo può restituire problemi di un'entità eliminata se tali problemi non sono ancora stati rimossi dall'housekeeper. ::: ::: noteclassic 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](/manual/web_interface/frontend_sections/users/user_roles) per ulteriori informazioni. ::: [comment]: # ({/c91e55ea-a18b2713}) [comment]: # ({ec05f91b-98f39c6a}) ### Parametri `(object)` Parametri che definiscono l'output desiderato. Il metodo supporta i seguenti parametri. |Parametro|[Tipo](/manual/api/reference_commentary#data-types)|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.

Per un elenco dei tipi di evento supportati, fare riferimento alla [pagina dell'oggetto evento problema](object#problem).

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

Per un elenco dei tipi di oggetto supportati, fare riferimento alla [pagina dell'oggetto evento problema](object#problem).

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](/manual/api/reference/event/acknowledge#parameters) 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](/manual/web_interface/frontend_sections/monitoring/problems#using-filter) dei tag.

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

Valori possibili di [operator](/manual/web_interface/frontend_sections/monitoring/problems#using-filter):
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 [`ok_period`](/manual/api/reference/settings/object) 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 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`](/manual/api/reference/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 rank.

Supporta `count`.| |selectTags|query|Restituisce una proprietà [`tags`](/manual/api/reference/problem/object#problem-tag) con i tag del problema. Formato di output: `[{"tag": "", "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 le proprietà del [tipo di dato](/manual/api/reference_commentary#data-types) `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](/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]: # ({/ec05f91b-98f39c6a}) [comment]: # ({7223bab1-7223bab1}) ### Valori restituiti `(integer/array)` Restituisce o: - una matrice di oggetti; - il conteggio degli oggetti recuperati, se il parametro `countOutput` è stato usato. [comment]: # ({/7223bab1-7223bab1}) [comment]: # ({b41637d2-b41637d2}) ### Esempi [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({9d82627b-4d83529d}) #### Recupero degli eventi di problema del trigger Recupera gli eventi recenti dal trigger "15112." [Richiesta](/manual/api#performing-requests): ```json { "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: ```json { "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 } ``` [comment]: # ({/9d82627b-4d83529d}) [comment]: # ({36151502-by}) #### Recupero dei problemi riconosciuti dall'utente specificato Recupero dei problemi riconosciuti dall'utente con ID=10 [Richiesta](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "problem.get", "params": { "output": "extend", "action": 2, "action_userids": [10], "selectAcknowledges": ["userid", "action"], "sortfield": ["eventid"], "sortorder": "DESC" }, "id": 1 } ``` Risposta: ```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 su localhost non è raggiungibile da 5 minuti", "acknowledged": "1", "severity": "3", "cause_eventid": "0", "opdata": "", "acknowledges": [ { "userid": "10", "action": "2" } ], "suppressed": "0" } ], "id": 1 } ``` [comment]: # ({/36151502-by}) [comment]: # ({f5742bff-c6eb3ba0}) ### Vedi anche - [Avviso](/manual/api/reference/alert/object) - [Item](/manual/api/reference/item/object) - [Host](/manual/api/reference/host/object) - [Regola LLD](/manual/api/reference/discoveryrule/object#lld-rule) - [Trigger](/manual/api/reference/trigger/object) [comment]: # ({/f5742bff-c6eb3ba0}) [comment]: # ({15f9267d-15f9267d}) ### Fonte CEvent::get() in *ui/include/classes/api/services/CProblem.php*. [comment]: # ({/15f9267d-15f9267d})