history.push

Descripción

object history.push(object/array itemHistoryData)

Este método permite enviar datos históricos de métricas al servidor Zabbix.

Este método está disponible para usuarios de cualquier tipo. Los permisos para llamar al método pueden ser revocados en la configuración del rol de usuario. Consulte Roles de usuario para 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

(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.