history.push

Descripción

objeto history.push(objeto/matriz itemHistoryData)

Este método permite enviar datos del historial de métricas al servidor Zabbix.

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. Consulte Roles de usuario para obtener más información.

Parámetros

(object/array) Datos históricos del item a enviar.

El método admite los siguientes parámetros.

Parámetro Tipo Descripción
itemid ID ID del item relacionado.

Comportamiento del parámetro:
- obligatorio si host y key no están establecidos
host string Nombre técnico del host.

Comportamiento del parámetro:
- obligatorio si itemid no está establecido
key string Clave del item.

Comportamiento del parámetro:
- obligatorio si itemid no está establecido
value mixed Valor del item.

Comportamiento del parámetro:
- obligatorio
clock timestamp Hora en que se recibió el valor.
ns integer Nanosegundos en que se recibió el valor.

Valores de retorno

(objeto) Devuelve el resultado de la operación de envío de datos.

Ejemplos

Enviar datos del historial de métrica

Envíe datos del historial de métrica al servidor Zabbix para las métricas "10600", "10601" y "999999".

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "history.push",
    "params": [
        {
            "itemid": 10600,
            "value": 0.5,
            "clock": 1690891294,
            "ns": 45440940
        },
        {
            "itemid": 10600,
            "value": 0.6,
            "clock": 1690891295,
            "ns": 312431
        },
        {
            "itemid": 10601,
            "value": "[Tue Aug 01 15:01:35 2023] [error] [client 1.2.3.4] File does not exist: /var/www/html/robots.txt"
        },
        {
            "itemid": 999999,
            "value": 123
        }
    ],
    "id": 1
}

Respuesta:

{
    "jsonrpc": "2.0",
    "result": {
        "response": "success",
        "data": [
            {
                "itemid": "10600"
            },
            {
                "itemid": "10600"
            },
            {
                "itemid": "10601",
                "error": "Item is disabled."
            },
            {
                "error": "No permissions to referred object or it does not exist."
            }
        ]
    },
    "id": 1
}

Ver también

Fuente

CHistory::push() en ui/include/classes/api/services/CHistory.php.