history.push

Beschreibung

object history.push(object/array itemHistoryData)

Diese Methode ermöglicht das Senden von Verlaufsdaten von Datenpunkten an den Zabbix-Server.

Diese Methode ist für Benutzer aller Typen verfügbar. Die Berechtigung zum Aufrufen der Methode kann in den Benutzerrolleinstellungen widerrufen werden. Weitere Informationen finden Sie unter Benutzerrollen.

Die IP-Adresse der Zabbix-Weboberfläche muss im Feld Allowed hosts des Zabbix trapper angegeben werden, damit die Methode funktioniert.

Parameter

(object/array) Zu sendende Datenpunkt-Verlaufsdaten.

Die Methode unterstützt die folgenden Parameter.

Parameter Type Beschreibung
itemid ID ID des zugehörigen Datenpunkts.

Parameter behavior:
- erforderlich, wenn host und key nicht gesetzt sind
host string Technischer Name des Hosts.

Parameter behavior:
- erforderlich, wenn itemid nicht gesetzt ist
key string Datenpunktschlüssel.

Parameter behavior:
- erforderlich, wenn itemid nicht gesetzt ist
value mixed Datenpunktwert.

Parameter behavior:
- erforderlich
clock timestamp Zeitpunkt, zu dem der Wert empfangen wurde.
ns integer Nanosekunden, zu denen der Wert empfangen wurde.

Rückgabewerte

(object) Gibt das Ergebnis des Datensendevorgangs zurück.

Beispiele

Verlaufsdaten von Datenpunkten senden

Senden Sie Verlaufsdaten von Datenpunkten für die Datenpunkte „10600“, „10601“ und „999999“ an den Zabbix Server.

Anfrage:

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

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "response": "success",
        "data": [
            {
                "itemid": "10600"
            },
            {
                "itemid": "10600"
            },
            {
                "itemid": "10601",
                "error": "Datenpunkt ist deaktiviert."
            },
            {
                "error": "Keine Berechtigungen für das referenzierte Objekt oder es existiert nicht."
            }
        ]
    },
    "id": 1
}

Siehe auch

Quelle

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