history.push

Beschreibung

object history.push(object/array itemHistoryData)

Mit dieser Methode können Datenpunkt-Verlaufsdaten an den Zabbix-Server gesendet werden.

Diese Methode ist für Benutzer aller Typen verfügbar. Die Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter Benutzerrollen.

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.