problem.get

Descripción

integer/array problem.get(object parameters)

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

Este método sirve para recuperar problemas no resueltos. También es posible, si se especifica, recuperar además 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 conservan en la tabla de problemas. Para recuperar problemas que se resolvieron más atrás en el pasado, use 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 revocarse 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.

Parameter Type Description
eventids ID/array Devolver solo problemas con los IDs dados.
groupids ID/array Devolver solo problemas creados por objetos que pertenecen a los grupos de hosts dados.
hostids ID/array Devolver solo problemas creados por objetos que pertenecen a los hosts dados.
objectids ID/array Devolver solo problemas creados por los objetos dados.
source integer Devolver solo problemas con el tipo dado.

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

Predeterminado: 0 - problem creado por un trigger.
object integer Devolver solo problemas creados por objetos del tipo dado.

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

Predeterminado: 0 - trigger.
acknowledged boolean Si se establece en true, devolver solo problemas reconocidos.
action integer Devolver solo problemas para los que se hayan realizado las acciones de actualización de evento dadas. Para varias acciones, use 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 problemas con los IDs dados de los usuarios que realizaron las acciones de actualización del evento problem.
suppressed boolean Si se establece en true, devolver solo problemas suprimidos.
symptom boolean Si se establece en true, devolver solo eventos problem de síntoma.
severities integer/array Devolver solo problemas con las severidades de evento dadas. Se aplica solo si object es trigger.
evaltype integer Método de evaluación de etiquetas.

Valores posibles:
0 - (predeterminado) And/Or;
2 - Or.
tags array Devolver solo 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 - (predeterminado) Contains;
1 - Equals;
2 - Does not contain;
3 - Does not equal;
4 - Exists;
5 - Does not exist.
recent boolean Si se establece en true, devolver problemas recientes, incluidos los resueltos dentro de ok_period y cualquier problema no resuelto.
Si se establece en false, devolver solo problemas no resueltos.
eventid_from string Devolver solo problemas con IDs mayores o iguales que el ID dado.
eventid_till string Devolver solo problemas con IDs menores o iguales que el ID dado.
time_from timestamp Devolver solo problemas que se hayan creado después o en el momento dado.
time_till timestamp Devolver solo problemas que se hayan creado antes o en el momento dado.
selectAcknowledges query Devolver una propiedad acknowledges con las actualizaciones del problem. Las actualizaciones del problem se ordenan en orden cronológico inverso.

El objeto de actualización del problem 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 (consulte 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 se suprimirá el evento;
taskid - (ID) ID de la tarea si el evento actual está experimentando un cambio de rango;
maintenanceid - (ID) ID del mantenimiento.

Admite count.
selectTags query Devolver una propiedad tags con las etiquetas del problem. 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 problem;
suppress_until - (integer) tiempo hasta el que el problem 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 único valor o un array de valores con los que comparar.

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

Valores posibles: eventid.
countOutput boolean Estos parámetros se describen en la 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 cualquiera de los siguientes:

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

Ejemplos

Recuperar eventos de problema de trigger

Recupera eventos recientes del trigger "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",
            "suppressed": "1",
            "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",
                    "maintenanceid": "0"
                }
            ],
            "opdata": "",
            "suppression_data": [
                {
                    "maintenanceid": "15",
                    "suppress_until": "1472511600",
                    "userid": "0"
                }
            ],
            "tags": [
                {
                    "tag": "test-tag",
                    "value": "test-value"
                }
            ],
            "urls": []
        }
    ],
    "id": 1
}

Recuperar problemas reconocidos por un usuario especificado

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

Ver también

Fuente

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