history.push

Descrição

object history.push(object/array itemHistoryData)

Este método permite enviar dados de histórico de item para o Zabbix server.

Este método está disponível para usuários de qualquer tipo. As permissões para chamar o método podem ser revogadas nas configurações de função do usuário. Consulte Funções de usuário para obter mais informações.

Parâmetros

(object/array) Dados do histórico do item a serem enviados.

O método suporta os seguintes parâmetros.

Parâmetro	Tipo	Descrição
itemid	ID	ID do item relacionado. Comportamento do parâmetro: - obrigatório se `host` e `key` não estiverem definidos
host	string	Nome técnico do host. Comportamento do parâmetro: - obrigatório se `itemid` não estiver definido
key	string	Chave do item. Comportamento do parâmetro: - obrigatório se `itemid` não estiver definido
value	mixed	Valor do item. Comportamento do parâmetro: - obrigatório
clock	timestamp	Hora em que o valor foi recebido.
ns	integer	Nanosegundos em que o valor foi recebido.

Valores de retorno

(object) Retorna o resultado da operação de envio de dados.

Exemplos

Enviar dados históricos do item

Enviar dados históricos do item para os items "10600", "10601" e "999999".

Requisição:

{
           "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
       }

Resposta:

{
           "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
       }

Veja também

Origem

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

Documentation