这是原厂英文文档的翻译页面. 欢迎帮助我们 完善文档.

1 监控项键值的格式

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

要构建一个有效的监控项键值,首先要指定键值的名称,然后选择是否具有参数,如后面的两行所示。

键值的名称

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

0-9a-zA-Z_-.

即:

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

键值的参数

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

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

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

参数中可以包含宏。这些宏可以是 用户宏 或某些内置宏。要查看监控项键值参数中支持哪些特定的内置宏,请在页面 支持的宏 中搜索“监控项键值参数”。

参数 - 带引号的字符串

如果键值参数为带引号的字符串,则允许任何Unicode字符。如果键值参数的字符串包含引号,则该参数必须用引号括起来,并且作为参数字符串中的每个引号都必须用反斜杠()进行转义。如果键值参数的字符串包含逗号,则参数必须被括起来。

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

参数 - 不带引号的字符串

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

参数 - 数组

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

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