problem.get

Descripción

entero/matriz problem.get(parámetros de objeto)

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

Este método sirve para recuperar problemas no resueltos. También es posible, si se especifica, recuperar adicionalmente problemas resueltos recientemente. El período que determina la edad "reciente" se define en Administración → General. Los problemas que fueron resueltos antes de ese período no se mantienen en la tabla de problemas. Para recuperar 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 entidad eliminada si estos problemas no han sido eliminados todavía por el limpiador.

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	string/array	Devuelve sólo problemas con los ID proporcionados.
groupids	cadena/matriz	Devuelve sólo problemas creados por objetos que pertenecen a los grupos de hosts dados.
hostids	cadena/matriz	Devuelve sólo problemas creados por objetos que pertenecen a los hosts dados.
objectids	string/array	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.
suprimido	booleano	`true` - devuelve solo problemas suprimidos; `false` - devuelve problemas en el estado normal.
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.
etiquetas	matriz de objetos	Solo devuelve 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` - `(cadena)` ID de actualización; `userid` - `(cadena)` ID del usuario que actualizó el evento; `eventid` - `(string)` ID del evento actualizado; `clock` - `(timestamp)` hora en que se actualizó el evento; `mensaje` - `(cadena)` texto del mensaje; `acción` - `(entero)`tipo de acción de actualización (ver event.acknowledge) ; `old_severity` - gravedad del evento `(integer)` antes de esta acción de actualización; `new_severity` - gravedad del evento `(integer)` después de esta acción de actualización; Soporta `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: `maintenanceid` - `(string)` ID del mantenimiento; `suppress_until` - `(integer)` tiempo hasta el problema está suprimido.
sortfield	string/array	Ordena el resultado según las propiedades dadas. Los valores posibles son: `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
filtro	objeto
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"
           },
           "auth": "67f45d3eb1173338e1b1647c4bdc1916",
           "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",
                   "opdata": "",
                   "acknowledges": [
                       {
                           "acknowledgeid": "14443",
                           "userid": "1",
                           "eventid": "1245463",
                           "clock": "1472457281",
                           "message": "problem solved",
                           "action": "6",
                           "old_severity": "0",
                           "new_severity": "0"
                       }
                   ],
                   "suppression_data": [
                       {
                           "maintenanceid": "15",
                           "suppress_until": "1472511600"
                       }
                   ],
                   "suppressed": "1",
                   "tags": [
                       {
                           "tag": "test tag",
                           "value": "test value"
                       }
                   ]
               }
           ],
           "id": 1
       }

Ver también

Fuente

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

Documentation