El formato de la clave de métrica, incluidos los parámetros clave, debe seguir las reglas de sintaxis. Las siguientes ilustraciones muestran la sintaxis admitida. Los elementos permitidos y los caracteres en cada punto se pueden determinar siguiendo las flechas - si se puede llegar a algún bloque a través de la línea, está permitido, si no - no esta permitido.
Para construir una clave de métrica válida, se comienza especificando el nombre de la clave, entonces existe la opción de tener parámetros o no, como se muestra en las dos líneas que podrían seguirse.
El nombre de la clave en sí tiene un rango limitado de caracteres permitidos, lo que simplemente siguen unos a otros. Los caracteres permitidos son:
Lo que significa:
Una clave de métrica puede tener varios parámetros separados por comas.
Cada parámetro de la clave puede ser una cadena entre comillas, una cadena sin comillas o una matriz.
El parámetro también se puede dejar vacío, utilizando así el valor predeterminado. En ese caso, se debe agregar el número apropiado de comas si se requiere especificar parámetros adicionales. Por ejemplo, la clave de la métrica icmpping[,,200,,500] especificaría que el intervalo entre pings individuales es de 200 milisegundos, tiempo de espera - 500 milisegundos, y todos los demás parámetros se dejan en sus valores predeterminados.
Es posible incluir macros en los parámetros. Pueden ser macros de usuario o algunas de las macros integradas. Para ver qué macros integradas particulares son compatibles con los parámetros de la clave de la métrica,busque en la página Macros compatibles por "parámetros clave de la métrica".
Si el parámetro de la clave es una cadena entre comillas, cualquier carácter Unicode está permitido.
Si la cadena del parámetro clave contiene una coma, este parámetro debe ser entrecomillado.
Si la cadena del parámetro de la clave contiene comillas, este parámetro tiene que entrecomillarse y cada comilla que forma parte del parámetro de la cadena debe escaparse con un carácter de backsplash (\
).
Para entrecomillar parámetros de la clave de métricas, use solamente comillas dobles. Las comillas simples no son compatibles.
Si el parámetro clave es una cadena sin comillas, cualquier carácter Unicode es permitido excepto la coma y el corchete derecho (]). El parámetro sin comillas no puede comenzar con el corchete izquierdo ([).
Si el parámetro clave es una matriz, se encierra nuevamente en un corchete donde los parámetros individuales están en línea con las reglas y la sintaxis para especificar múltiples parámetros.
Matrices de parámetros de varios niveles, [a,[b,[c,d]],e]
, no están permitidos.