Passive und aktive Prüfprotokolle

Dieser Abschnitt enthält Protokolldetails zu passiven und aktiven Prüfungen, die von Zabbix Agent und Zabbix agent 2 durchgeführt werden.

Zabbix verwendet für die Kommunikation mit den Agents ein JSON-basiertes Kommunikationsprotokoll.

Die Protokolle von Zabbix Agent und Zabbix agent 2 sind seit Zabbix 7.0 vereinheitlicht. Der Unterschied zwischen Anfragen und Antworten von Zabbix Agent und Zabbix agent 2 wird durch den Wert des Tags "variant" ausgedrückt.

Passive checks

Ein passiver Check ist eine einfache Datenanforderung. Zabbix Server oder Proxy fragt nach bestimmten Daten (zum Beispiel CPU-Auslastung), und der Zabbix Agent sendet das Ergebnis an den Server zurück.

Passive Checks werden asynchron ausgeführt - es ist nicht erforderlich, die Antwort auf eine Anfrage zu erhalten, bevor weitere Checks gestartet werden. Auch die DNS-Auflösung erfolgt asynchron.

Der Agent-Poller versucht, eine Verbindung zu allen Adressen herzustellen, die von der DNS-Abfrage zurückgegeben werden. Dadurch wird sichergestellt, dass der Poller bei einer nicht erreichbaren IP-Adresse die nächste verfügbare Adresse versucht, was die Wahrscheinlichkeit einer erfolgreichen Verbindung erhöht. Diese Verbesserung gilt sowohl für Zabbix Server als auch für Proxy.

Die maximale Parallelität asynchroner Checks beträgt 1000 (definiert durch MaxConcurrentChecksPerPoller).

Die Anzahl der asynchronen Agent-Poller wird durch den Parameter StartAgentPollers definiert.

Server-Anfrage

Für die Definition von Header und Datenlänge siehe Protokolldetails.

{
  "request": "passive checks",
  "data": [
    {
      "key": "agent.version",
      "timeout": 3
    }
  ]
}

Agent-Antwort

{
  "version": "8.0.0",
  "variant": 2,
  "data": [
    {
      "value": "8.0.0"
    }
  ]
}

Zum Beispiel für unterstützte Items:

1. Server öffnet eine TCP-Verbindung
2. Server sendet <HEADER><DATALEN>{"request":"passive checks","data":[{"key":"agent.ping","timeout":3}]}
3. Agent liest die Anfrage und antwortet mit <HEADER><DATALEN>{"version":"8.0.0","variant":2,"data":[{"value":1}]}
4. Server verarbeitet die Daten, um den Wert zu erhalten, in unserem Fall '1'
5. TCP-Verbindung wird geschlossen

Für nicht unterstützte Items:

1. Server öffnet eine TCP-Verbindung
2. Server sendet <HEADER><DATALEN>{"request":"passive checks","data":[{"key":"vfs.fs.size[/nono]","timeout":3}]}
3. Agent liest die Anfrage und antwortet mit <HEADER><DATALEN>{"version":"8.0.0","variant":2,"data":[{"error":"Unsupported item key."}]}
4. Server verarbeitet die Daten, ändert den Item-Status auf nicht unterstützt mit der angegebenen Fehlermeldung
5. TCP-Verbindung wird geschlossen

Failover auf das alte Protokoll

Damit der Zabbix-Server oder Proxy mit Agents aus Versionen vor 7.2 zusammenarbeiten kann, die das Klartextprotokoll verwenden, ist ein Failover auf das alte Protokoll implementiert.

Passive Prüfungen werden nach einem Neustart oder bei einer Änderung der Schnittstellenkonfiguration über das JSON-Protokoll (7.0 und neuer) ausgeführt.
Wenn als Antwort kein gültiges JSON empfangen wird (der Agent sendet "ZBX_NOTSUPPORTED"), speichert Zabbix die Schnittstelle als altes Protokoll im Cache und wiederholt die Prüfung, indem nur der Datenpunkt-Schlüssel gesendet wird.

Beachten Sie, dass der Zabbix-Server/Proxy jede Stunde erneut versucht, mit allen Schnittstellen das neue Protokoll zu verwenden, und bei Bedarf auf das alte Protokoll zurückfällt.

Aktive Prüfungen

Aktive Prüfungen erfordern eine komplexere Verarbeitung. Der Agent muss zunächst vom Server/Proxy eine Liste von Datenpunkten und/oder Remote-Befehlen zur unabhängigen Verarbeitung abrufen.

Die Server/Proxys, von denen die aktiven Prüfungen abgerufen werden, sind im Parameter 'ServerActive' der Konfigurationsdatei des Agenten aufgeführt. Die Häufigkeit der Abfrage dieser Prüfungen wird durch den Parameter 'RefreshActiveChecks' in derselben Konfigurationsdatei festgelegt. Wenn die Aktualisierung aktiver Prüfungen jedoch fehlschlägt, wird der Versuch nach fest kodierten 60 Sekunden wiederholt.

Der Agent sendet dann regelmäßig die neuen Werte an den Server(n). Wenn der Agent einen Remote-Befehl zur Ausführung erhalten hat, wird auch das Ausführungsergebnis gesendet. Beachten Sie, dass die Ausführung von Remote-Befehlen auf einem aktiven Agent seit Zabbix agent 7.0 unterstützt wird.

Abrufen der Liste der Datenpunkte

Agent-Anfrage

Die Anfrage für aktive Prüfungen wird verwendet, um die aktiven Prüfungen abzurufen, die vom Agent verarbeitet werden sollen.
Diese Anfrage wird vom Agent beim Start und anschließend in Intervallen von RefreshActiveChecks gesendet.

{
  "request": "active checks",
  "host": "Zabbix server",
  "host_metadata": "mysql,nginx",
  "interface": "zabbix.server.lan",
  "ip": "159.168.1.1",
  "port": 12050,
  "version": "8.0.0",
  "variant": 2,
  "config_revision": 1,
  "session": "e3dcbd9ace2c9694e1d7bbd030eeef6e"
}

Serverantwort

Die Antwort auf aktive Prüfungen wird vom Server nach der Verarbeitung der Anfrage für aktive Prüfungen an den Agent zurückgesendet.

{
  "response": "success",
  "config_revision": 2,
  "data": [
    {
      "key": "system.uptime",
      "itemid": 1234,
      "delay": "10s",
      "lastlogsize": 0,
      "mtime": 0
    },
    {
      "key": "agent.version",
      "itemid": 5678,
      "delay": "10m",
      "lastlogsize": 0,
      "mtime": 0,
      "timeout": "30s"
    }
  ],
  "commands": [
    {
      "command": "df -h --output=source,size / | awk 'NR>1 {print $2}'",
      "id": 1324,
      "wait": 1
    }
  ]
}

Der Server muss mit success antworten.

Zum Beispiel:

1. Agent öffnet eine TCP-Verbindung
2. Agent fragt die Liste der Prüfungen ab
3. Server antwortet mit einer Liste von Datenpunkten und auszuführenden Remote-Befehlen
4. Agent analysiert die Antwort
5. TCP-Verbindung wird geschlossen
6. Agent beginnt mit der periodischen Datenerfassung und führt Remote-Befehle aus (seit Zabbix agent 7.0 unterstützt)

Senden der gesammelten Daten

Agent sendet

Die Anforderung für Agent-Daten enthält die gesammelten Datenpunktwerte und die Werte für ausgeführte Remote-Befehle (falls vorhanden).

{
  "request": "agent data",
  "data": [
    {
      "id": 1,
      "itemid": 5678,
      "value": "7.0.0",
      "clock": 1712830783,
      "ns": 76808644
    },
    {
      "id": 2,
      "itemid": 1234,
      "value": "69672",
      "clock": 1712830783,
      "ns": 77053975
    }
  ],
  "commands": [
    {
      "id": 1324,
      "value": "16G"
    }
  ],
  "session": "8495cd52070e6ca52b371f29c8574165",
  "host": "Zabbix server",
  "version": "8.0.0",
  "variant": 2
}

Jedem Wert wird eine virtuelle ID zugewiesen. Die Wert-ID ist ein einfacher aufsteigender Zähler, der innerhalb einer Datensitzung eindeutig ist (identifiziert durch das Sitzungstoken). Diese ID wird verwendet, um doppelte Werte zu verwerfen, die in Umgebungen mit schlechter Konnektivität gesendet werden können.

Serverantwort

Die Antwort auf Agent-Daten wird vom Server nach der Verarbeitung der Agent-Datenanforderung an den Agent zurückgesendet.

{
  "response": "success",
  "info": "processed: 2; failed: 0; total: 2; seconds spent: 0.003534"
}

Zum Beispiel:

1. Agent öffnet eine TCP-Verbindung
2. Agent sendet eine Liste von Werten
3. Server verarbeitet die Daten und sendet den Status zurück
4. TCP-Verbindung wird geschlossen

Heartbeat-Nachricht

Agent sendet

Die Heartbeat-Nachricht wird von einem aktiven Agent an den Zabbix Server/Proxy alle HeartbeatFrequency Sekunden gesendet (konfiguriert in der Konfigurationsdatei von Zabbix agent/ agent 2).

Sie wird verwendet, um die Verfügbarkeit aktiver Prüfungen zu überwachen.

{
  "request": "active check heartbeat",
  "host": "Zabbix server",
  "heartbeat_freq": 60,
  "version": "8.0.0",
  "variant": 2
}

Umleitungsantwort

Wenn ein Host neu zugewiesen wurde, kann der Server den Agent anweisen, seinen Heartbeat (und die nachfolgenden aktiven Prüfungen) an eine andere Proxy- oder Server-Instanz umzuleiten.

  {
    "response": "failed",
    "redirect": {
      "revision": 2,
      "address": "192.0.2.1:10055"
    }
  }

Älteres XML-Protokoll