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, unos detrás de 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 hay más parámetros a especificar . Por ejemplo, la clave de métrica icmpping[,,200,,500] especificaría que el intervalo entre los pings individuales son de 200 milisegundos, el tiempo de espera es de 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 métrica, busque en la página Macros compatibles por "parámetros de la clave de la métrica".
Si el parámetro clave es una cadena entre comillas, se permite cualquier carácter Unicode. Si la cadena del parámetro clave contiene una comilla, este parámetro debe ir entre comillas, y cada comilla que forme parte de la cadena del parámetro debe escaparse con un carácter de barra invertida (\
). Si la cadena del parámetro clave contiene una coma, este parámetro debe ir entre comillas.
Para entrecomillar los parámetros clave de los ítems, utilice únicamente comillas dobles. Las comillas simples no son compatibles.
No se permiten matrices de parámetros multinivel, por ejemplo, [a,[b,[c,d]],e]
.
Si el parámetro clave es una cadena sin comillas, cualquier carácter Unicode está permitido excepto la coma y el corchete derecho (]). El parámetro sin comillas no puede comenzar por el corchete izquierdo ([).
Si el parámetro clave es una matriz, se vuelve a encerrar entre corchetes, donde los parámetros individuales se alinean con las reglas y la sintaxis de especificación de múltiples parámetros.