history.push

Description

object history.push(object/array itemHistoryData)

Cette méthode permet d'envoyer les données d'historique des éléments au serveur Zabbix.

Cette méthode est disponible pour les utilisateurs de tout type. Les autorisations d'appel de la méthode peuvent être révoquées dans les paramètres du rôle utilisateur. Consultez User roles pour plus d'informations.

Paramètres

(object/array) Données d'historique d'élément à envoyer.

La méthode prend en charge les paramètres suivants.

Paramètre Type Description
itemid ID ID de l'élément associé.

Comportement du paramètre :
- obligatoire si host et key ne sont pas définis
host string Nom technique de l'hôte.

Comportement du paramètre :
- obligatoire si itemid n'est pas défini
key string Clé de l'élément.

Comportement du paramètre :
- obligatoire si itemid n'est pas défini
value mixed Valeur de l'élément.

Comportement du paramètre :
- obligatoire
clock timestamp Heure à laquelle la valeur a été reçue.
ns integer Nanosecondes au moment où la valeur a été reçue.

Valeurs de retour

(object) Renvoie le résultat de l’opération d’envoi des données.

Exemples

Envoyer les données d'historique des éléments

Envoyez les données d'historique des éléments au serveur Zabbix pour les éléments « 10600 », « 10601 » et « 999999 ».

Requête :

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

Réponse :

{
    "jsonrpc": "2.0",
    "result": {
        "response": "success",
        "data": [
            {
                "itemid": "10600"
            },
            {
                "itemid": "10600"
            },
            {
                "itemid": "10601",
                "error": "L'élément est désactivé."
            },
            {
                "error": "Aucune autorisation pour l'objet référencé ou celui-ci n'existe pas."
            }
        ]
    },
    "id": 1
}

Voir aussi

Source

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