2 转义相关升级问题
升级后超出函数参数的字符数限制
从 Zabbix 7.0 开始,历史函数的带引号字符串参数中的反斜杠会被视为转义字符,而不是普通字符。
从 7.0 之前的版本升级时,这类反斜杠会被加倍,以确保函数接收到的值与升级前相同。
例如,find(/host/key,,"regexp","error \d+") 会变为 find(/host/key,,"regexp","error \\d+")。
这会导致参数变长;当参数长度超过 255 个字符时,可能会导致触发器函数损坏。
为避免此问题,请在升级前或升级后,按照下面的示例将较长的参数手动移至用户宏中。
为便于阅读,下面示例中的连续反斜杠使用占位符表示。
每个占位符代表所述数量的连续反斜杠字符,中间没有空格(例如,<3 backslashes> 表示 \\\)。
假设在 Zabbix 6.0 中,您有:
- 一个
vfs.file.contents[/tmp/ONE]监控项,用于读取/tmp/ONE文件,该文件包含 114 个反斜杠,后跟字母a:
<114 backslashes>a
- Calculated_item_228 和 Trigger_228 使用以下表达式,该表达式查找 114 个反斜杠后跟字母
a的内容(在正则表达式中,\\表示一个普通反斜杠):
find(/Zabbix server/vfs.file.contents[/tmp/ONE],1m:now,"regexp","<228 backslashes>a")
- Calculated_item_232 和 Trigger_232 使用以下表达式,该表达式查找 116 个反斜杠后跟字母
a的内容:
find(/Zabbix server/vfs.file.contents[/tmp/ONE],1m:now,"regexp","<232 backslashes>a")
在此配置下:
- Calculated_item_228 返回
1,Trigger_228 进入 PROBLEM 状态,因为文件包含表达式所查找的 114 个反斜杠后跟字母a。 - Calculated_item_232 返回
0,Trigger_232 保持 OK 状态,因为文件仅包含 114 个反斜杠,而表达式查找的是 116 个反斜杠。
升级到 Zabbix 7.0.11 或更高版本期间,对于每个过长而无法转换的触发器函数参数,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 个)。
但是,两个触发器都会进入 PROBLEM 状态,因为它们的参数未被转换。
Zabbix 7.0 会将每两个反斜杠读取为一个反斜杠,而正则表达式又会将其数量减半:
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 会进入 PROBLEM 状态,与升级前一致。 计算监控项无需更改,但为保持一致,您也可以使用相同方式更新它们。