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

(objeto/matriz) Datos del historial 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 informados
host	cadena	Nombre técnico del equipo. Comportamiento del parámetro: - obligatorio si `itemid` no está informados
clave	cadena	Clave de la métrica. Comportamiento del parámetro: - obligatorio si `itemid` no está informado
valor	mixto	Valor de la métrica. Comportamiento del parámetro: - obligatorio
reloj	marca de tiempo	Hora en que se recibió el valor.
ns	entero	Nanosegundos cuando 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.

Documentation