アップグレードの問題
エスケープ関連
アップグレード後に関数パラメータの文字数制限を超過する
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 のみが障害状態になります。 計算アイテムを変更する必要はありませんが、一貫性を保つため、同じ方法で更新することもできます。