history.push

Descrizione

object history.push(object/array itemHistoryData)

Questo metodo consente di inviare i dati dello storico degli elementi al server Zabbix.

Questo metodo è disponibile per utenti di qualsiasi tipo. I permessi per chiamare il metodo possono essere revocati nelle impostazioni dei ruoli utente. Consultare Ruoli utente per ulteriori informazioni.

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.