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

(objeto/array) Datos históricos de la métrica a enviar.

El método admite los siguientes parámetros.

Parámetro	Tipo	Descripción
itemid	ID	ID de la métrica relacionada. Comportamiento del parámetro: - obligatorio si `host` y `key` no están definidos
host	string	Nombre técnico del equipo. Comportamiento del parámetro: - obligatorio si `itemid` no está definido
key	string	Clave de la métrica. Comportamiento del parámetro: - obligatorio si `itemid` no está definido
value	mixed	Valor de la métrica. 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.

Documentation