Probleme beim Upgrade

Escape-bezogen

Zeichenlimit für Funktionsparameter nach dem Upgrade überschritten

Seit Zabbix 7.0 wird ein umgekehrter Schrägstrich in einem Parameter einer Funktion für den Verlauf, der in Anführungszeichen steht, als Escape-Zeichen statt als Literalzeichen behandelt.

Beim Upgrade von Versionen vor 7.0 werden solche umgekehrten Schrägstriche verdoppelt, damit die Funktion denselben Wert wie zuvor erhält. Beispielsweise wird find(/host/key,,"regexp","error \d+") zu find(/host/key,,"regexp","error \\d+"). Dies führt zu längeren Parametern und kann zu fehlerhaften Auslöserfunktionen führen, wenn die Parameterlänge 255 Zeichen überschreitet.

Um dieses Problem zu vermeiden, verschieben Sie lange Parameter vor oder nach dem Upgrade manuell in Benutzermakros, wie im folgenden Beispiel gezeigt.

Zur besseren Lesbarkeit werden lange Folgen umgekehrter Schrägstriche im folgenden Beispiel als Platzhalter angezeigt. Jeder Platzhalter steht für die angegebene Anzahl direkt aufeinanderfolgender umgekehrter Schrägstriche ohne Leerzeichen (z. B. bedeutet <3 backslashes> \\\).

Angenommen, Sie haben in Zabbix 6.0:

  • Einen vfs.file.contents[/tmp/ONE]-Datenpunkt, der die Datei /tmp/ONE liest, die 114 umgekehrte Schrägstriche gefolgt von a enthält:
<114 backslashes>a
  • Calculated_item_228 und Trigger_228, die einen Ausdruck verwenden, der nach 114 umgekehrten Schrägstrichen gefolgt von a sucht (in regulären Ausdrücken steht \\ für einen einzelnen Literal-Backslash):
find(/Zabbix server/vfs.file.contents[/tmp/ONE],1m:now,"regexp","<228 backslashes>a")
  • Calculated_item_232 und Trigger_232, die einen Ausdruck verwenden, der nach 116 umgekehrten Schrägstrichen gefolgt von a sucht:
find(/Zabbix server/vfs.file.contents[/tmp/ONE],1m:now,"regexp","<232 backslashes>a")

Mit dieser Konfiguration gilt:

  • Calculated_item_228 gibt 1 zurück und Trigger_228 wechselt in den PROBLEM-Status, da die Datei die 114 umgekehrten Schrägstriche gefolgt von a enthält, nach denen der Ausdruck sucht.
  • Calculated_item_232 gibt 0 zurück und Trigger_232 bleibt im OK-Status, da die Datei nur 114 umgekehrte Schrägstriche enthält, während der Ausdruck nach 116 sucht.

Beim Upgrade auf Zabbix 8.0 protokolliert der Zabbix-Server für jeden Auslöserfunktionsparameter, der zu lang für die Konvertierung ist, eine Warnung (suchen Sie im Protokoll nach MANUAL INTERVENTION IS REQUIRED, um alle betroffenen Parameter zu finden). Für Trigger_228 wird beispielsweise die folgende Warnung protokolliert:

2485502:20250228:115442.236 DBpatch_6050165(): cannot save in DB function parameter: resulting size 477 is longer than the maximum 255.
functionid:33792 function:'find'
used on host: 'Zabbix server'
  in trigger: 'Trigger_228'.
Current parameter value:
'$,1m:now,"regexp","<228 backslashes>a"'
Resulting escaped value would be:
'$,1m:now,"regexp","<456 backslashes>a"'
DB upgrade and Zabbix server can continue to run, but to make sure this function works correctly
MANUAL INTERVENTION IS REQUIRED !
Need to manually reduce the size of this parameter with macro as a workaround.

Nach dem Upgrade funktionieren die berechneten Datenpunkte wie zuvor (z. B. werden 228 umgekehrte Schrägstriche zu 456). Beide Auslöser wechseln jedoch in den PROBLEM-Status, da ihre Parameter nicht konvertiert wurden. Zabbix 8.0 liest jeweils zwei umgekehrte Schrägstriche als einen, und der reguläre Ausdruck halbiert ihre Anzahl erneut: Trigger_228 sucht nach 57 umgekehrten Schrägstrichen gefolgt von a, und Trigger_232 nach 58. Die Datei enthält 114 umgekehrte Schrägstriche gefolgt von a, daher werden beide Muster darin gefunden.

Um dies zu beheben, verschieben Sie die langen Werte in Benutzermakros:

Macro Value
{$228_BACKSLASHES_A} <228 backslashes>a
{$232_BACKSLASHES_A} <232 backslashes>a

Verwenden Sie anschließend die Makros in den Ausdrücken von Trigger_228 und Trigger_232:

find(/Zabbix server/vfs.file.contents[/tmp/ONE],1m:now,"regexp",{$228_BACKSLASHES_A})
find(/Zabbix server/vfs.file.contents[/tmp/ONE],1m:now,"regexp",{$232_BACKSLASHES_A})

Nun wechselt nur Trigger_228 in den PROBLEM-Status, wie vor dem Upgrade. Die berechneten Datenpunkte müssen nicht geändert werden, Sie können sie jedoch zur Konsistenz auf dieselbe Weise aktualisieren.