アップグレードの問題

エスケープ関連

アップグレード後に関数パラメータの文字数制限を超過する

Zabbix 7.0 以降、履歴関数の引用符で囲まれた文字列パラメータ内のバックスラッシュは、リテラル文字ではなくエスケープ文字として扱われます。

7.0 より前のバージョンからアップグレードする際、このようなバックスラッシュは倍増され、関数が以前と同じ値を受け取るようになります。 例えば、find(/host/key,,"regexp","error \d+") は find(/host/key,,"regexp","error \\d+") になります。 これによりパラメータが長くなり、パラメータの長さが255文字を超えると、トリガー関数が壊れる可能性があります。

この問題を回避するには、以下の例に示すように、アップグレードの前後に長いパラメータを手動でユーザーマクロに移動します。

読みやすくするため、以下の例では、連続する長いバックスラッシュをプレースホルダーで示しています。 各プレースホルダーは、スペースを含めずに連続して記述された、指定された数のバックスラッシュ文字を表します(例: <3 backslashes> は \\\ を意味します)。

Zabbix 6.0 で、次の設定があるとします。

  • /tmp/ONE ファイルを読み取る vfs.file.contents[/tmp/ONE] アイテム。このファイルには、114個のバックスラッシュに続いて a が含まれています。
<114 backslashes>a
  • 114個のバックスラッシュに続いて a を検索する式を使用する Calculated_item_228 と Trigger_228(正規表現では、\\ は1個のリテラルなバックスラッシュを表します)。
find(/Zabbix server/vfs.file.contents[/tmp/ONE],1m:now,"regexp","<228 backslashes>a")
  • 116個のバックスラッシュに続いて a を検索する式を使用する Calculated_item_232 と Trigger_232。
find(/Zabbix server/vfs.file.contents[/tmp/ONE],1m:now,"regexp","<232 backslashes>a")

この設定では、次のようになります。

  • Calculated_item_228 は 1 を返し、Trigger_228 は障害状態になります。これは、ファイルに式が検索する114個のバックスラッシュに続いて a が含まれているためです。
  • Calculated_item_232 は 0 を返し、Trigger_232 は正常状態のままになります。これは、ファイルには114個のバックスラッシュしか含まれていない一方、式は116個を検索するためです。

Zabbix 8.0 へのアップグレード中、変換するには長すぎる各トリガー関数パラメータについて、Zabbix サーバーは警告をログに記録します(影響を受けるすべてのパラメータを確認するには、ログで MANUAL INTERVENTION IS REQUIRED を検索してください)。 例えば、Trigger_228 については、次の警告が記録されます。

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.

アップグレード後も、計算アイテムは以前と同じように動作します(例えば、228個のバックスラッシュは456個になります)。 ただし、両方のトリガーは障害状態になります。これは、パラメータが変換されなかったためです。 Zabbix 8.0 は2個のバックスラッシュを1個として読み取り、正規表現によってさらに半分になります。 Trigger_228 は57個のバックスラッシュに続いて a を検索し、Trigger_232 は58個を検索します。 ファイルには114個のバックスラッシュに続いて a が含まれているため、両方のパターンがファイル内で見つかります。

これを修正するには、長い値をユーザーマクロに移動します。

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

次に、Trigger_228 と 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})

これで、アップグレード前と同様に、Trigger_228 のみが障害状態になります。 計算アイテムを変更する必要はありませんが、一貫性を保つため、同じ方法で更新することもできます。