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 状态,与升级前一致。 计算监控项无需更改,但为保持一致,您也可以使用相同方式更新它们。