这是原厂英文文档的翻译页面. 欢迎帮助我们 完善文档.
2022 Zabbix中国峰会
2022 Zabbix中国峰会

1 监控项键值的格式

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

要构建有效的监控项键值,首先要指定键值的名称,然后选择是否具有参数,后面的两行描述了这一点。

键值名称

Key(键值)名称本身具有字符范围的限制,允许的字符是:

0-9a-zA-Z_-.

即:

  • 所有数字;
  • 所有小写字母;
  • 所有大写字母;
  • 下划线;
  • 破折号;
  • 点。

键值参数

一个键值可以包含由多个逗号分隔的参数。

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

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

参数 - 带引号的字符串

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

如果键值参数的字符串中包含逗号,则该参数必须用引号引起来。

如果键值参数的字符串包含引号,则该参数必须用引号括起来,并且作为参数字符串一部分的每个引号都必须用反斜杠(\)进行转义。

<提示>:要引用监控项键值参数,只能使用双引号,不支持单引号。 :::

参数 - 不带引号的字符串

如果键值的参数是不带引号的字符串,则允许使用任何Unicode字符,除逗号和右方括号(])之外,不带引号的参数不能以左方括号([)开头。

参数 - 数组

如果键值的参数是数组,它需要被方括号括起来,其中各个参数需要符合多个参数的规则和语法。

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