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.
(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 indicados. |
groupids | ID/array | Devolver solo los problemas creados por objetos que pertenecen a los grupos de equipos indicados. |
hostids | ID/array | Devolver solo los problemas creados por objetos que pertenecen a los equipos indicados. |
objectids | ID/array | Devolver solo los problemas creados por los objetos indicados. |
source | integer | Devolver solo los problemas con el tipo indicado. Consulte la página del objeto de evento de problema para ver una lista de los tipos de evento admitidos. Por defecto: 0 - problema creado por un disparador. |
object | integer | Devolver solo los problemas creados por objetos del tipo indicado. Consulte la página del objeto de evento de problema para ver una lista de los tipos de objeto admitidos. Por defecto: 0 - disparador. |
acknowledged | boolean | true - devolver solo problemas reconocidos;false - solo no reconocidos. |
action | integer | Devolver solo los problemas para los que se han realizado las acciones de actualización de evento indicadas. Para múltiples acciones, utilice 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 de usuarios que realizaron las acciones de actualización de evento de problema indicados. |
suppressed | boolean | true - devolver solo problemas suprimidos;false - devolver problemas en estado normal. |
symptom | boolean | true - devolver solo eventos de problema de síntoma;false - devolver solo eventos de problema de causa. |
severities | integer/array | Devolver solo los problemas con las severidades de evento indicadas. Solo se aplica si el objeto es un disparador. |
evaltype | integer | 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 indicadas. Coincidencia exacta por etiqueta y búsqueda insensible a mayúsculas/minúsculas por valor y operador. Formato: [{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...] .Un array vacío devuelve todos los problemas. Tipos de operador posibles: 0 - (por defecto) Like; 1 - Igual; 2 - No like; 3 - No igual 4 - Existe; 5 - No existe. |
recent | boolean | 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 indicado. |
eventid_till | string | Devolver solo los problemas con IDs menores o iguales al ID indicado. |
time_from | timestamp | Devolver solo los problemas que se hayan creado después o en el momento indicado. |
time_till | timestamp | Devolver solo los problemas que se hayan creado antes o en el momento indicado. |
selectAcknowledges | query | Devolver una propiedad acknowledges con las actualizaciones del problema. Las actualizaciones de problema se ordenan en orden cronológico inverso.El objeto de actualización de 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 la que el evento estará 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 indicado. 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 | string/array | Ordenar el resultado por las propiedades indicadas. 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 |
(integer/array)
Devuelve:
countOutput
.Recuperar eventos recientes del disparador "15112".
{
"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 con ID=10
{
"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": "El agente Zabbix en localhost no está disponible durante 5 minutos",
"acknowledged": "1",
"severity": "3",
"cause_eventid": "0",
"opdata": "",
"acknowledges": [
{
"userid": "10",
"action": "2"
}
],
"suppressed": "0"
}
],
"id": 1
}
CEvent::get() en ui/include/classes/api/services/CProblem.php.