problem.get

Descripción

integer/array problem.get(object parameters)

El método permite recuperar problemas de acuerdo con los parámetros suministrados.

Este método sirve para recuperar problemas no resueltos. También es posible, si se especifica, poder recuperar adicionalmente problemas resueltos recientemente. El período que determina la edad "reciente" se define en AdministraciónGeneral. Los problemas que fueron resueltos antes de ese período no se mantienen en la tabla de problemas. Para recuperar los problemas que se resolvieron más atrás en el pasado, utilice el método event.get.

Este método puede devolver problemas de una métrica eliminada si estos problemas no han sido eliminados todavía por la tarea de limpieza.

Este método está disponible para usuarios de cualquier tipo. Los permisos para llamar al método se pueden revocar en la configuración de roles de usuario. Ver Roles de usuario para más información.

Parámetros

(objeto) Parámetros que definen la salida deseada.

El método admite los siguientes parámetros.

Parámetro Tipo Descripción
eventids ID/array Devuelve sólo problemas con los ID proporcionados.
groupids ID/matriz Devuelve sólo problemas creados por objetos que pertenecen a los grupos de hosts dados.
hostids ID/matriz Devuelve sólo problemas creados por objetos que pertenecen a los hosts dados.
objectids ID/matriz Devuelve sólo los problemas creados por los objetos dados.
fuente integer Devuelve solo problemas con el tipo dado.

Consulte la página de objeto de evento de problema para obtener una lista de los tipos de eventos admitidos.

Valor predeterminado: 0 - problema creado por un disparador.
objeto entero Devuelve solo problemas creados por objetos del tipo dado.

Consulte la página de objeto de evento de problema para obtener una lista de los tipos de objetos admitidos.

Predeterminado: 0 - disparador.
reconocido booleano true - devuelve solo problemas reconocidos;
false - solo no reconocidos.
acción integer Devuelve solo los problemas para los cuales se han realizado las [acciones de actualización de eventos] dadas (/manual/api/reference/event/acknowledge#parameters). Para acciones múltiples, utilice una combinación de valores de mapa de bits aceptables como máscara de bits.
action_userids ID/matriz Devuelve solo problemas con los ID proporcionados de los usuarios que realizaron las acciones de actualización del evento de problema.
suprimido booleano true - devuelve solo problemas suprimidos;
false - devuelve problemas en el estado normal.
síntoma booleano true - devuelve sólo eventos de problemas de síntomas;
false - devuelve sólo eventos de problemas de causas.
severidades integer/array Devuelve solo problemas con gravedades de eventos determinadas. Se aplica sólo si el objeto es el desencadenante.
evaltype integer Reglas para la búsqueda de etiquetas.

Valores posibles:
0 - (predeterminado) Y/O;
2 - O.
tags array Devuelve solo problemas con etiquetas dadas. Coincidencia exacta por etiqueta y búsqueda que no distingue entre mayúsculas y minúsculas por valor y operador.
Formato: [{"tag": "<tag>", "value": "<value>", "operator": "<operator> "}, ...].
Una matriz vacía devuelve todos los problemas.

Tipos de operadores posibles:
0 - (predeterminado) Me gusta;
1 - Igual;
2 - No me gusta;
3 - No es igual
4 - Existe;
5 - No existe.
reciente booleano verdadero - devuelve PROBLEMA y problemas RESUELTOS recientemente (depende de los activadores de Mostrar OK durante N segundos)
Valor predeterminado: falso - solo problemas NO RESUELTOS
eventid_from string Devuelve solo problemas con ID mayores o iguales al ID proporcionado.
eventid_till string Devuelve solo problemas con ID menores o iguales al ID proporcionado.
time_from timestamp Devuelve sólo los problemas que se han creado después o en el momento dado.
time_till timestamp Devuelve sólo los problemas que se han creado antes o en el momento dado.
selectAcknowledges query Devuelve una propiedad acuse de recibo con las actualizaciones del problema. Las actualizaciones de problemas se ordenan en orden cronológico inverso.

El objeto de actualización de problemas tiene las siguientes propiedades:
acknowledgeid - (ID) ID de la actualización;
userid - ( ID) ID del usuario que actualizó el evento;
eventid - (ID) ID del evento actualizado;
clock - (timestamp) hora en que se actualizó el evento;< br>message - (string) texto del mensaje;
action - (integer)tipo de acción de actualización (ver event.acknowledge);
old_severity - (entero) gravedad del evento antes de esta acción de actualización;
new_severity - (entero) gravedad del evento después de esta acción de actualización;
suppress_until - (timestamp) tiempo hasta que se suprima el evento;
taskid - (ID) ID de la tarea si el evento actual está experimentando un cambio de clasificación.

Admite count.
selectTags query Devuelve una propiedad tags con las etiquetas del problema. Formato de salida: [{"etiqueta": "<etiqueta>", "valor": "<valor>"}, ...].
selectSuppressionData query Devuelve una propiedad suppression_data con la lista de mantenimientos activos y supresiones manuales:
maintenanceid - (ID) ID del mantenimiento;
userid - (ID) ID del usuario que suprimió el problema;
suppress_until - (entero) tiempo hasta que se suprima el problema.
filtro objeto Devuelve sólo aquellos resultados que coinciden exactamente con el filtro dado.

Acepta un objeto, donde las claves son nombres de propiedades y los valores son un valor único o una matriz de valores con los que comparar.

No admite propiedades de text tipo de datos.
sortfield string/array Ordena el resultado según las propiedades dadas.

Valores posibles: eventid.
countOutput boolean Estos parámetros, que son comunes para todos los métodos get, se describen en detalle en la página comentario de referencia.
editable booleano
excluirBuscar booleano
límite entero
salida consulta
preservekeys booleano
buscar objeto
searchByAny booleano
searchWildcardsEnabled booleano
clasificación cadena/matriz
iniciarBuscar booleano

Valores de retorno

(entero/matriz) Devuelve:

  • una matriz de objetos;
  • el recuento de objetos recuperados, si el parámetro countOutput ha sido usado.

Ejemplos

Recuperando eventos de problemas de iniciador

Recupera eventos recientes del iniciador "15112".

Solicitud:

{
           "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
       }

Respuesta:

{
           "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
       }

Recuperar problemas reconocidos por el usuario especificado

Recuperando problemas reconocidos por el usuario con ID=10

Solicitud:

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

Respuesta:

{
           "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",
                   "opdata": "",
                   "acknowledges": [
                       {
                           "userid": "10",
                           "action": "2"
                       }
                   ],
                   "suppressed": "0"
               }
           ],
           "id": 1
       }

Ver también

Fuente

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