problem.get

Descripción

integer/array problem.get(parámetros del objeto)

El método permite recuperar problemas según los parámetros dados.

Este método es para recuperar problemas no resueltos. También es posible, si se especifica, recuperar adicionalmente problemas resueltos recientemente. El período que determina cuán antiguo es "recientemente" se define en Administración → General. Los problemas que se resolvieron 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 aún no han sido eliminados por el housekeeper.

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

Parámetros

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

El método admite los siguientes parámetros.

Parámetro	Tipo	Descripción
eventids	ID/array	Devolver solo los problemas con los IDs dados.
groupids	ID/array	Devolver solo los problemas creados por objetos que pertenecen a los grupos de host dados.
hostids	ID/array	Devolver solo los problemas creados por objetos que pertenecen a los hosts dados.
objectids	ID/array	Devolver solo los problemas creados por los objetos dados.
source	integer	Devolver solo los problemas con el tipo dado. Consulte la página del objeto de evento de problema para ver una lista de los tipos de eventos admitidos. Por defecto: 0 - problema creado por un trigger.
object	integer	Devolver solo los problemas creados por objetos del tipo dado. Consulte la página del objeto de evento de problema para ver una lista de los tipos de objetos admitidos. Por defecto: 0 - trigger.
acknowledged	boolean	`true` - devolver solo los problemas reconocidos; `false` - solo los no reconocidos.
action	integer	Devolver solo los problemas para los que se han realizado las acciones de actualización de eventos dadas. Para varias acciones, utilice una suma de cualquier valor de mapa de bits aceptable como máscara de bits (por ejemplo, 34 para reconocer y suprimir el evento).
action_userids	ID/array	Devolver solo los problemas con los IDs dados de los usuarios que realizaron las acciones de actualización del evento de problema.
suppressed	boolean	`true` - devolver solo los problemas suprimidos; `false` - devolver los problemas en estado normal.
symptom	boolean	`true` - devolver solo los eventos de problema de síntoma; `false` - devolver solo los eventos de problema de causa.
severities	integer/array	Devolver solo los problemas con las severidades de evento dadas. Solo se aplica si el objeto es trigger.
evaltype	integer	Método de evaluación de etiquetas. Valores posibles: 0 - (por defecto) And/Or; 2 - Or.
tags	array	Devolver solo los problemas con las etiquetas dadas. Formato: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`. Un array vacío devuelve todos los problemas. Valores posibles de operator: 0 - (por defecto) Contiene; 1 - Igual a; 2 - No contiene; 3 - No es igual a; 4 - Existe; 5 - No existe.
recent	boolean	`true` - devolver problemas PROBLEM y recientemente RESUELTOS (depende de Mostrar triggers OK durante N segundos) Por defecto: `false` - solo problemas NO RESUELTOS
eventid_from	string	Devolver solo los problemas con IDs mayores o iguales al ID dado.
eventid_till	string	Devolver solo los problemas con IDs menores o iguales al ID dado.
time_from	timestamp	Devolver solo los problemas que se hayan creado después o en el momento dado.
time_till	timestamp	Devolver solo los problemas que se hayan creado antes o en el momento dado.
selectAcknowledges	query	Devolver una propiedad `acknowledges` con las actualizaciones del problema. Las actualizaciones del problema se ordenan en orden cronológico inverso. El objeto de actualización del problema 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; `message` - `(string)` texto del mensaje; `action` - `(integer)`tipo de acción de actualización (ver `event.acknowledge`); `old_severity` - `(integer)` severidad del evento antes de esta acción de actualización; `new_severity` - `(integer)` severidad del evento después de esta acción de actualización; `suppress_until` - `(timestamp)` hora hasta que el evento será suprimido; `taskid` - `(ID)` ID de la tarea si el evento actual está experimentando un cambio de rango. Admite `count`.
selectTags	query	Devolver una propiedad `tags` con las etiquetas del problema. Formato de salida: `[{"tag": "<tag>", "value": "<value>"}, ...]`.
selectSuppressionData	query	Devolver 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` - `(integer)` tiempo hasta que el problema esté suprimido.
filter	object	Devolver solo aquellos resultados que coincidan exactamente con el filtro dado. Acepta un objeto, donde las claves son nombres de propiedades y los valores son un solo valor o un array de valores con los que comparar. No admite propiedades de tipo de dato `text` data type.
sortfield	string/array	Ordenar el resultado por las propiedades dadas. Valores posibles: `eventid`.
countOutput	boolean	Estos parámetros se describen en el comentario de referencia.
editable	boolean
excludeSearch	boolean
limit	integer
output	query
preservekeys	boolean
search	object
searchByAny	boolean
searchWildcardsEnabled	boolean
sortorder	string/array
startSearch	boolean

Valores de retorno

(integer/array) Devuelve:

un array de objetos;
el número de objetos recuperados, si se ha utilizado el parámetro countOutput.

Ejemplos

Recuperar eventos de problemas de disparadores

Recuperar eventos recientes del disparador "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": "El agente Zabbix en localhost no está disponible durante 5 minutos",
                   "acknowledged": "1",
                   "severity": "3",
                   "cause_eventid": "0",
                   "opdata": "",
                   "acknowledges": [
                       {
                           "acknowledgeid": "14443",
                           "userid": "1",
                           "eventid": "1245463",
                           "clock": "1472457281",
                           "message": "problema resuelto",
                           "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 un usuario especificado

Recuperar problemas reconocidos por el usuario con ID=10