2022 Zabbix中国峰会
2022 Zabbix中国峰会

1 监控项键值的格式

监控项键值的格式(包括关键参数)必须遵循语法规则。 以下插图描述了支持的语法。 每个点的允许元素和字符可以通过跟随箭头来确定 - 如果可以通过线到达某个块,则允许,如果不能到达 - 则不允许。

要构建一个有效的监控项的键值,首先指定键值的名称,然后选择是否具有参数,如果都两个都满足则被执行。

键值 名称

Key名本身具有有限的允许字符范围,允许的字符是:

0-9a-zA-Z_-.

即:

  • 所有的数字;
  • 所有的小写字母;
  • 所有大写字母;
  • 下划线;
  • 减号;
  • 点.

键值的参数

监控项的键值可以有多个逗号分隔的参数。

每个key参数可以是带引号、无引号的字符串或数组。

参数也可以为空,此时使用默认值。在这种情况下,如果指定了其它参数,则必须添加对应数量的逗号。例如,键值 icmpping[,,200,,500] 将指定每ping一次的时间间隔为200毫秒,超时时间为500毫秒,所有其它参数为默认值。

参数 - 带引号的字符串

如果键值参数为带引号的字符串,则允许任何Unicode字符,如果包含双引号则需要被反斜杠转义。

<note warning>要引用监控项键值参数,请仅使用双引号,不支持单引号。 :::

参数 - 不带引号的字符串

如果键值的参数是一个不带引号的字符串,除逗号和右方括号(])之外,不带引号的参数不能以左方括号([)开头。

参数 - 数组

如果key参数是一个数组,它需要包含在方括号中,其中各个参数需要符合多个参数的规则和语法。

多级参数数组, 例如 [a,[b,[c,d]],e], 是不支持的。