history.push

Descrizione

object history.push(object/array itemHistoryData)

Questo metodo consente di inviare i dati storici degli item a Zabbix server.

Questo metodo è disponibile per utenti di qualsiasi tipo. Le autorizzazioni per chiamare il metodo possono essere revocate nelle impostazioni del ruolo utente. Per ulteriori informazioni, vedere Ruoli utente.

L'indirizzo IP dell'interfaccia web di Zabbix deve essere specificato nel campo Allowed hosts del Zabbix trapper affinché il metodo funzioni.

Parametri

(object/array) Dati della cronologia degli item da inviare.

Il metodo supporta i seguenti parametri.

Parametro Type Descrizione
itemid ID ID dell'item correlato.

Comportamento del parametro:
- obbligatorio se host e key non sono impostati
host string Nome tecnico del host.

Comportamento del parametro:
- obbligatorio se itemid non è impostato
key string Chiave dell'item.

Comportamento del parametro:
- obbligatorio se itemid non è impostato
value mixed Valore dell'item.

Comportamento del parametro:
- obbligatorio
clock timestamp Ora in cui il valore è stato ricevuto.
ns integer Nanosecondi in cui il valore è stato ricevuto.

Valori restituiti

(oggetto) Restituisce il risultato dell'operazione di invio dei dati.

Esempi

Invia i dati dello storico degli elementi

Invia i dati dello storico degli elementi al server Zabbix per gli elementi "10600", "10601" e "999999".

Richiesta:

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

Risposta:

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

Vedi anche

Sorgente

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