Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

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 Devolver solo los problemas con los IDs dados.
groupids ID/array Devolver solo los problemas creados por objetos que pertenecen a los grupos de equipos dados.
hostids ID/array Devolver solo los problemas creados por objetos que pertenecen a los equipos dados.
objectids ID/array Devolver solo los problemas creados por los objetos dados.
source entero 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 disparador.
object entero 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 - disparador.
acknowledged booleano true - devolver solo problemas reconocidos;
false - solo no reconocidos.
action entero Devolver solo los problemas para los cuales se han realizado las acciones de actualización de evento dadas. Para múltiples acciones, use una suma de cualquier valor de mapa de bits aceptable como máscara de bits (por ejemplo, 34 para reconocer y suprimir evento).
action_userids ID/array Devolver solo los problemas con los IDs dados de usuarios que realizaron las acciones de actualización de evento de problema.
suppressed booleano true - devolver solo problemas suprimidos;
false - devolver problemas en estado normal.
symptom booleano true - devolver solo eventos de problema de síntoma;
false - devolver solo eventos de problema de causa.
severities entero/array Devolver solo los problemas con las severidades de evento dadas. Solo aplica si el objeto es disparador.
evaltype entero Reglas para la búsqueda de etiquetas.

Valores posibles:
0 - (por defecto) Y/O;
2 - O.
tags array Devolver solo los problemas con las etiquetas dadas. Coincidencia exacta por etiqueta y búsqueda sensible o no sensible a mayúsculas/minúsculas por valor de etiqueta dependiendo del valor del operador.
Formato: [{"tag": "<etiqueta>", "value": "<valor>", "operator": "<operador>"}, ...].
Un array vacío devuelve todos los problemas.

Tipos de operador posibles:
0 - (por defecto) Contiene (coincidencia de subcadena, no sensible a mayúsculas/minúsculas);
1 - Igual (sensible a mayúsculas/minúsculas);
2 - No contiene (coincidencia de subcadena, no sensible a mayúsculas/minúsculas);
3 - No igual (sensible a mayúsculas/minúsculas);
4 - Existe;
5 - No existe.
recent booleano true - devolver problemas PROBLEM y recientemente RESUELTOS (depende de Mostrar disparadores 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 marca de tiempo Devolver solo los problemas que se hayan creado después o en el momento dado.
time_till marca de tiempo Devolver solo los problemas que se hayan creado antes o en el momento dado.
selectAcknowledges consulta 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 - (marca de tiempo) hora en que se actualizó el evento;
message - (cadena) texto del mensaje;
action - (entero) tipo de acción de actualización (ver event.acknowledge);
old_severity - (entero) severidad del evento antes de esta acción de actualización;
new_severity - (entero) severidad del evento después de esta acción de actualización;
suppress_until - (marca de tiempo) 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 consulta Devolver una propiedad tags con las etiquetas del problema. Formato de salida: [{"tag": "<etiqueta>", "value": "<valor>"}, ...].
selectSuppressionData consulta 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 - (entero) tiempo hasta que el problema esté suprimido.
filter objeto 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 único valor o un array de valores con los que comparar.

No admite propiedades de tipo de dato text data type.
sortfield cadena/array Ordenar el resultado por las propiedades dadas.

Valores posibles: eventid.
countOutput booleano Estos parámetros se describen en el comentario de referencia.
editable booleano
excludeSearch booleano
limit entero
output consulta
preservekeys booleano
search objeto
searchByAny booleano
searchWildcardsEnabled booleano
sortorder cadena/array
startSearch 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 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 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.