El formato de la clave de la métrica, incluidos los parámetros de la clave, debe seguir las reglas de sintaxis. Las siguientes ilustraciones muestran la sintaxis admitida. Los elementos y caracteres permitidos en cada punto pueden determinarse siguiendo las flechas: si se puede llegar a algún bloque a través de la línea, está permitido; si no, no está permitido.
Para construir una clave de métrica válida, se comienza especificando el nombre de la clave, luego se puede elegir tener parámetros o no, como se muestra en las dos líneas que se pueden seguir.
El propio nombre de la clave tiene un rango limitado de caracteres permitidos, que simplemente se suceden unos a otros. Los caracteres permitidos son:
Lo que significa:
Una clave de métrica puede tener múltiples parámetros que se separan por comas.
Cada parámetro de la clave puede ser una cadena entre comillas, una cadena sin comillas o un array.
El parámetro también puede dejarse vacío, utilizando así el valor por defecto. En ese caso, se debe añadir el número adecuado de comas si se especifican más parámetros. Por ejemplo, la clave de métrica icmpping[,,200,,500] indicaría que el intervalo entre pings individuales es de 200 milisegundos, el tiempo de espera - 500 milisegundos, y todos los demás parámetros se dejan con sus valores por defecto.
Es posible incluir macros en los parámetros. Estas pueden ser macros de usuario o algunas de las macros integradas. Para ver qué macros integradas se admiten en los parámetros de la clave de métrica, busque en la página Macros soportadas "parámetros de la clave de métrica".
Si el parámetro de la clave es una cadena entre comillas, se permite cualquier carácter Unicode. Si la cadena del parámetro de la 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 de la clave contiene una coma, este parámetro debe ir entre comillas.
Para entrecomillar los parámetros de la clave de la métrica, utilice únicamente comillas dobles. No se admiten comillas simples.
No se permiten matrices de parámetros multinivel, por ejemplo, [a,[b,[c,d]],e]
.
Si el parámetro de la clave es una cadena sin comillas, se permite cualquier carácter Unicode excepto la coma y el corchete derecho (]). El parámetro sin comillas no puede comenzar con un corchete izquierdo ([).
Si el parámetro de la clave es un array, se encierra nuevamente entre corchetes, donde los parámetros individuales se ajustan a las reglas y sintaxis de especificar múltiples parámetros.