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.