history.push

Descripción

object history.push(object/array itemHistoryData)

Este método permite enviar datos de historial de item al server de Zabbix.

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.

La dirección IP de la interfaz web de Zabbix debe especificarse en el campo Allowed hosts del Zabbix trapper para que el método funcione.

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

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

Ejemplos

Enviar datos históricos de métricas

Enviar datos históricos de métricas 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": "La métrica está deshabilitada."
            },
            {
                "error": "Sin permisos para el objeto referido o no existe."
            }
        ]
    },
    "id": 1
}

Véase también

Fuente

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