2 Problemy z aktualizacją związane z ucieczką znaków

Przekroczono limit znaków dla parametrów funkcji po aktualizacji

Od wersji Zabbix 7.0 ukośnik odwrotny w parametrze będącym ciągiem znaków w cudzysłowie funkcji history function jest traktowany jako znak ucieczki, a nie znak literalny.

Podczas aktualizacji z wersji wcześniejszych niż 7.0 takie ukośniki odwrotne są podwajane, aby funkcja otrzymała tę samą wartość co wcześniej. Na przykład find(/host/key,,"regexp","error \d+") zmienia się na find(/host/key,,"regexp","error \\d+"). Prowadzi to do wydłużenia parametrów i może spowodować nieprawidłowe działanie funkcji wyzwalacza, gdy długość parametru przekroczy 255 znaków.

Aby uniknąć tego problemu, przed aktualizacją lub po niej ręcznie przenieś długie parametry do makr użytkownika, jak pokazano w poniższym przykładzie.

Dla czytelności długie sekwencje ukośników odwrotnych w poniższym przykładzie przedstawiono jako symbole zastępcze. Każdy symbol zastępczy oznacza podaną liczbę znaków ukośnika odwrotnego zapisanych jeden za drugim, bez spacji (np. <3 backslashes> oznacza \\\).

Załóżmy, że w Zabbix 6.0 masz:

  • pozycję vfs.file.contents[/tmp/ONE], która odczytuje plik /tmp/ONE zawierający 114 ukośników odwrotnych, po których następuje a:
<114 backslashes>a
  • Calculated_item_228 i Trigger_228, które używają wyrażenia wyszukującego 114 ukośników odwrotnych, po których następuje a (w wyrażeniach regularnych \\ oznacza jeden literalny ukośnik odwrotny):
find(/Zabbix server/vfs.file.contents[/tmp/ONE],1m:now,"regexp","<228 backslashes>a")
  • Calculated_item_232 i Trigger_232, które używają wyrażenia wyszukującego 116 ukośników odwrotnych, po których następuje a:
find(/Zabbix server/vfs.file.contents[/tmp/ONE],1m:now,"regexp","<232 backslashes>a")

Przy takiej konfiguracji:

  • Calculated_item_228 zwraca 1, a Trigger_228 przechodzi w stan PROBLEM, ponieważ plik zawiera 114 ukośników odwrotnych, po których następuje a, czego szuka wyrażenie.
  • Calculated_item_232 zwraca 0, a Trigger_232 pozostaje w stanie OK, ponieważ plik zawiera tylko 114 ukośników odwrotnych, podczas gdy wyrażenie szuka 116.

Podczas aktualizacji do wersji Zabbix 7.0.11 lub nowszej serwer Zabbix zapisze ostrzeżenie dla każdego parametru funkcji wyzwalacza, który jest zbyt długi, aby można go było przekonwertować (wyszukaj w dzienniku MANUAL INTERVENTION IS REQUIRED, aby znaleźć wszystkie parametry wymagające działania). Na przykład dla Trigger_228 zostanie zapisane następujące ostrzeżenie:

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.

Po aktualizacji obliczane pozycje będą działać tak jak wcześniej (np. 228 ukośników odwrotnych zmieni się w 456). Jednak oba wyzwalacze przejdą w stan PROBLEM, ponieważ ich parametry nie zostały przekonwertowane. Zabbix 7.0 odczytuje każde dwa ukośniki odwrotne jako jeden, a wyrażenie regularne ponownie zmniejsza ich liczbę o połowę: Trigger_228 szuka 57 ukośników odwrotnych, po których następuje a, a Trigger_232 szuka 58. Plik zawiera 114 ukośników odwrotnych, po których następuje a, dlatego oba wzorce zostaną w nim znalezione.

Aby to naprawić, przenieś długie wartości do makr użytkownika:

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

Następnie użyj makr w wyrażeniach Trigger_228 i 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})

Teraz tylko Trigger_228 przejdzie w stan PROBLEM, tak jak przed aktualizacją. Obliczanych pozycji nie trzeba zmieniać, ale dla zachowania spójności możesz zaktualizować je w ten sam sposób.