监控项 键格式(包括键参数)必须遵循语法规则。以下插图描述了支持的语法结构。通过跟随箭头可以确定在每个位置允许的元素和字符——如果可以通过线条到达某个块,则允许该块;否则不允许。
要构造一个有效的 监控项 键,首先需要指定键名称,然后可以选择是否包含参数——如图中所示的两条可选路径所示。
键名本身允许使用的字符范围有限,这些字符直接连续使用。允许的字符包括:
含义如下:
一个 监控项 键可以包含多个参数,参数之间用逗号分隔。
每个键参数可以是带引号的 string、不带引号的 string 或一个 array。
参数也可以留空,从而使用默认值。在这种情况下,如果指定了后续参数,则必须添加适当数量的逗号。例如,监控项 键 icmpping[,,200,,500] 表示各个 ping 之间的间隔为 200 毫秒,超时时间为 500 毫秒,所有其他参数使用默认值。
参数中也可以包含宏。这些宏可以是 监控项监控项原型 或某些内置宏。要查看 监控项 键参数中支持哪些特定的内置宏,请在页面 Supported macros 上搜索 "监控项 key parameters"。
如果键参数是带引号的 string,则任何 Unicode 字符都是 允许。如果键参数 string 包含引号,则此参数具有 要加引号,并且参数中每个引号都需要进行转义 string
必须使用反斜杠 (\
) 进行转义。如果键参数 string
包含逗号,则此参数必须用引号括起来。
::: notewarning 要引用监控项键参数,请使用双引号 仅支持双引号。不支持单引号。 仅返回OutputFormat格式要求结果
::: noteimportant 多级参数数组,例如 [a,[b,[c,d]],e]
不被允许。 仅返回OutputFormat格式要求结果
如果键参数是一个未加引号的 string,则除逗号和右方括号(])外,允许使用任何 Unicode 字符。未加引号的参数不能以左方括号([).
开头。
如果键参数是一个 array,则再次用方括号将其括起来,其中各个参数需符合指定多个参数的规则和语法。