12 Trapper-Datenpunkte

Übersicht

Trapper-Datenpunkte akzeptieren eingehende Daten, anstatt sie abzufragen. Dies ist für alle Daten nützlich, die Sie an Zabbix senden möchten.

Konfiguration

So konfigurieren Sie einen Trapper-Datenpunkt:

1. Gehen Sie zu Datensammlung → Hosts.
2. Klicken Sie in der Zeile des Hosts auf Datenpunkte.
3. Klicken Sie auf Datenpunkt erstellen.
4. Geben Sie die Parameter des Datenpunkts im Konfigurationsformular ein.

Alle erforderlichen Eingabefelder sind mit einem roten Sternchen markiert.

Die Felder, die für Trapper-Datenpunkte spezifische Informationen erfordern, sind:

Daten senden

Das Senden von Daten an den Zabbix Server oder Proxy ist mit dem Dienstprogramm Zabbix sender oder dem Zabbix-sender-Protokoll möglich. Das Senden von Daten an den Zabbix Server ist auch mit der API-Methode history.push möglich.

Zabbix sender

Um Daten mit dem Dienstprogramm Zabbix sender an den Zabbix Server oder Proxy zu senden, können Sie den folgenden Befehl ausführen, um den „Testwert“ zu senden:

zabbix_sender -z <server IP address> -p 10051 -s "New host" -k trap -o "test value"

Um den „Testwert“ zu senden, werden die folgenden Befehlsoptionen verwendet:

• -z zur Angabe der IP-Adresse des Zabbix Servers
• -p zur Angabe der Portnummer des Zabbix Servers (standardmäßig 10051)
• -s zur Angabe des Hosts (achten Sie darauf, den technischen statt des sichtbaren Host-Namens zu verwenden)
• -k zur Angabe des Schlüssels des im Trapper-Datenpunkt konfigurierten Datenpunkts
• -o zur Angabe des zu sendenden Werts

Weitere Informationen zur Kommunikation zwischen Zabbix sender und dem Zabbix Server oder Proxy finden Sie unter Zabbix sender protocol.

history.push

Um Daten mit der API-Methode history.push an den Zabbix-Server zu senden, können Sie die folgende HTTP-POST-Anfrage mit einigen Testwerten ausführen:

curl --request POST \
  --url 'https://example.com/zabbix/api_jsonrpc.php' \
  --header 'Authorization: Bearer 0424bd59b807674191e7d77572075f33' \
  --header 'Content-Type: application/json-rpc' \
  --data '{"jsonrpc":"2.0","method":"history.push","params":[{"itemid":10600,"value":"test value 1"},{"itemid":10601,"value":"test value 2"},{"itemid":99999,"value":"test value 3"}],"id":1}'

Wenn die Anfrage korrekt ist, könnte die von der API zurückgegebene Antwort wie folgt aussehen:

{
    "jsonrpc": "2.0",
    "result": {
        "response": "success",
        "data": [
            {
                "itemid": "10600"
            },
            {
                "itemid": "10601",
                "error": "Item is disabled."
            },
            {
                "error": "No permissions to referred object or it does not exist."
            }
        ]
    },
    "id": 1
}

Fehler in den Antwortdaten weisen darauf hin, dass das Senden von Daten für bestimmte Datenpunkte die Validierung durch den Zabbix-Server nicht bestanden hat. Dies kann aus folgenden Gründen passieren:

• der Benutzer, der die Daten sendet, hat keine Leseberechtigung für den Host des Datenpunkts;
• der Host ist deaktiviert oder befindet sich in der Wartung ohne Datenerfassung;
• der Datenpunkt existiert nicht oder ist noch nicht im Konfigurations-Cache des Servers enthalten;
• der Datenpunkt ist deaktiviert oder sein Typ ist weder Zabbix-Trapper noch HTTP Agent (mit aktiviertem Trapping);
• die IP-Adresse oder der DNS-Name des Benutzers ist nicht in der Liste Allowed hosts des Datenpunkts eingetragen;
• ein anderer Datenpunkt hat einen Wert mit einem doppelten Zeitstempel auf Nanosekundenebene.

Das Fehlen von Fehlern zeigt an, dass die gesendeten Werte zur Verarbeitung akzeptiert wurden, einschließlich Vorverarbeitung (falls vorhanden), Auslöser-Verarbeitung und Speicherung in der Datenbank. Beachten Sie, dass die Verarbeitung eines akzeptierten Werts ebenfalls fehlschlagen kann (zum Beispiel während der Vorverarbeitung), wodurch der Wert verworfen wird.

Weitere Informationen zur Arbeit mit der Zabbix-API finden Sie unter API.

Daten anzeigen

Sobald Daten gesendet wurden, können Sie zu Monitoring → Letzte Daten navigieren, um das Ergebnis zu sehen: