En el preprocesamiento es posible aplicar transformaciones a los valores de las m¨¦tricas recibidos antes de guardarlos en la base de datos.
Hay muchos usos para esta funcionalidad. Es posible que desee, por ejemplo:
Son posibles una o varias transformaciones. Las transformaciones (pasos de preprocesamiento) se ejecutan en el orden en que se definen.
Una m¨¦trica pasar¨¢ a ser no compatible si cualquiera de los pasos de preprocesamiento falla. Esto se puede evitar mediante el manejo de errores Personalizado en caso de error (disponible para transformaciones admitidas), que se puede configurar para descartar el valor o establecer un valor espec¨ªfico.
Para asegurarse de que la canalizaci¨®n de preprocesamiento configurada funcione, es posible probarla.
Para m¨¦tricas de registro, los metadatos de registro (sin valor) siempre restablecer¨¢n el estado de la m¨¦trica como no compatible y har¨¢n que la m¨¦trica sea compatible nuevamente, incluso si se produjo un error despu¨¦s de recibir un valor de registro del agente.
El preprocesamiento lo realiza el servidor Áú»¢¶Ä²© o el proxy (si las m¨¦tricas son monitoreadas por el proxy).
Tenga en cuenta que todos los valores pasados al preprocesamiento son del tipo cadena; Se realiza la conversi¨®n al tipo de valor deseado (como se define en la ³¦´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨®²Ô de la m¨¦trica) al final del proceso de preprocesamiento. Sin embargo, tambi¨¦n pueden realizarse conversiones si as¨ª lo requiere el paso de preprocesamiento correspondiente. Ver detalles del preprocesamiento para m¨¢s informaci¨®n t¨¦cnica.
Ver tambi¨¦n: Ejemplo de preprocesamiento de expresiones regulares
Los pasos de preprocesamiento se definen en la pesta?a Preprocesamiento del formulario de ³¦´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨®²Ô de la m¨¦trica.
Haga clic en Agregar para seleccionar una transformaci¨®n compatible.
El campo Tipo de informaci¨®n se muestra en la parte inferior de la pesta?a cuando se define al menos un paso de preprocesamiento. Si es necesario, es posible cambiar el tipo de informaci¨®n sin salir de la pesta?a Preprocesamiento. Consulte Crear una m¨¦trica para obtener una descripci¨®n detallada de los par¨¢metros.
Todas las transformaciones admitidas se enumeran a continuaci¨®n. Haga clic en el nombre de la transformaci¨®n para ver todos los detalles al respecto.
Nombre | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô | Tipo |
---|---|---|
Expresi¨®n regular | Haga coincidir el valor con la expresi¨®n regular y reempl¨¢celo con la salida requerida. | Texto |
Replace | Encuentre la cadena de b¨²squeda y reempl¨¢cela con otra (o nada). | |
Trim | Elimina los caracteres especificados del principio y del final del valor. | |
Recorte derecho | Elimina los caracteres especificados al final del valor. | |
Recorte izquierdo | Elimina los caracteres especificados del principio del valor. | |
XML XPath | Extrae un valor o fragmento de datos XML utilizando la funcionalidad XPath. | Datos estructurados |
Ruta JSON | Extrae un valor o fragmento de datos JSON usando la funcionalidad JSONPath. | |
CSV a JSON | Convierte los datos del archivo CSV al formato JSON. | |
XML a JSON | Convertir datos en formato XML a JSON. | |
Valor de SNMP walk | Extraiga el valor por el nombre OID/MIB especificado y aplique las opciones de formato. | SNMP |
SNMP walk a JSON | Convertir valores SNMP a JSON. | |
Valor de SNMP get | Aplicar opciones de formato al valor de obtenci¨®n SNMP. | |
Multiplicador personalizado | Multiplica el valor por el valor entero o de punto flotante especificado. | ´¡°ù¾±³Ù³¾¨¦³Ù¾±³¦²¹ |
Cambio simple | Calcular la diferencia entre el valor actual y el anterior. | Cambiar |
Cambio por segundo | Calcular la velocidad de cambio de valor (diferencia entre el valor actual y el anterior) por segundo. | |
Booleano a decimal | Convierte el valor del formato booleano a decimal. | Sistemas num¨¦ricos |
Octal a decimal | Convierte el valor del formato octal a decimal. | |
Hexadecimal a decimal | Convierte el valor del formato hexadecimal a decimal. | |
JavaScript | Ingrese el c¨®digo JavaScript. | Scripts personalizados |
In range | Define un rango en el que debe estar un valor. | ³Õ²¹±ô¾±»å²¹³¦¾±¨®²Ô |
Coincide con expresi¨®n regular | Especifique una expresi¨®n regular con la que un valor debe coincidir. | |
No coincide con la expresi¨®n regular | Especifique una expresi¨®n regular con la que un valor no debe coincidir. | |
Compruebe si hay errores en JSON | Compruebe si hay un mensaje de error a nivel de aplicaci¨®n ubicado en JSONPath. | |
Compruebe si hay errores en XML | Compruebe si hay un mensaje de error a nivel de aplicaci¨®n ubicado en XPath. | |
Compruebe si hay errores usando una expresi¨®n regular | Compruebe si hay un mensaje de error a nivel de aplicaci¨®n usando una expresi¨®n regular. | |
Compruebe si hay un valor no admitido | Compruebe si hubo un error al recuperar el valor del art¨ªculo. | |
Descartar sin cambios | Descartar un valor si no ha cambiado. | ³¢¾±³¾¾±³Ù²¹³¦¾±¨®²Ô |
Descartar sin cambios con latido | Descartar un valor si no ha cambiado dentro del per¨ªodo de tiempo definido. | |
Patr¨®n de Prometheus | Utilice la siguiente consulta para extraer los datos necesarios de las m¨¦tricas de Prometheus. | Prometheus |
Prometheus a JSON | Convierta las m¨¦tricas de Prometheus requeridas a JSON. |
Tenga en cuenta que para los pasos de preprocesamiento Cambiar y Acelerar, Áú»¢¶Ä²© tiene que recordar el ¨²ltimo valor para calcular/comparar el nuevo valor. seg¨²n sea necesario. Estos valores anteriores son manejados por el gestor de preprocesamiento. Si se reinicia el servidor o proxy Áú»¢¶Ä²© o hay alg¨²n cambio realizado a los pasos de preprocesamiento, el ¨²ltimo valor de la m¨¦trica correspondiente se restablece, lo que resulta en:
Haga coincidir el valor con la expresi¨®n regular y reempl¨¢celo con la salida requerida.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ:
Comentarios:
Busque la cadena de b¨²squeda y reempl¨¢cela por otra (o nada).
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ:
Comentarios:
Elimina los caracteres especificados del principio y del final del valor.
Elimine los caracteres especificados del final del valor.
Elimina los caracteres especificados del principio del valor.
Extraiga valor o fragmento de datos XML utilizando la funcionalidad XPath.
Comentarios:
Ejemplos:
number(/document/item/value) #will extract '10' from <document><item><value>10</value></item></document>
number(/document/item/@attribute) #will extract '10' from <document><item attribute="10"></item></document>
/document/item #will extract '<item><value>10</value></item>' from <document><item><value>10</value></item></document>
Extraiga un valor o fragmento de datos JSON usando la funcionalidad JSONPath.
Si marca la casilla de verificaci¨®n Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor espec¨ªfico o establecer un mensaje de error espec¨ªfico. En caso de que falle un paso de preprocesamiento, la m¨¦trica no dejar¨¢ de ser compatible si se selecciona la opci¨®n de descartar el valor o establecer un valor espec¨ªfico.
Convierta los datos del archivo CSV al formato JSON.
Para obtener m¨¢s informaci¨®n, consulte: Preprocesamiento de CSV a JSON.
Convierte datos en formato XML a JSON.
Para obtener m¨¢s informaci¨®n, consulte: Reglas de serializaci¨®n.
Si marca la casilla de verificaci¨®n Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor espec¨ªfico o establecer un mensaje de error espec¨ªfico. En caso de que falle un paso de preprocesamiento, la m¨¦trica no dejar¨¢ de ser compatible si se selecciona la opci¨®n de descartar el valor o establecer un valor espec¨ªfico.
Extraiga el valor por el nombre OID/MIB especificado y aplique las opciones de formato:
' '
se reemplaza por ':'
);Si marca la casilla de verificaci¨®n Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor espec¨ªfico o establecer un mensaje de error espec¨ªfico. En caso de que falle un paso de preprocesamiento, la m¨¦trica no dejar¨¢ de ser compatible si se selecciona la opci¨®n de descartar el valor o establecer un valor espec¨ªfico.
Convierta valores SNMP a JSON.
Especifique un nombre de campo en el JSON y la ruta SNMP OID correspondiente. Los valores de los campos se completar¨¢n con los valores de la ruta OID SNMP especificada.
Comentarios:
Aplique opciones de formato al valor de obtenci¨®n SNMP:
' '
se reemplaza por ':'
);Si marca la casilla de verificaci¨®n Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor espec¨ªfico o establecer un mensaje de error espec¨ªfico. En caso de que falle un paso de preprocesamiento, la m¨¦trica no dejar¨¢ de ser compatible si se selecciona la opci¨®n de descartar el valor o establecer un valor espec¨ªfico.
Multiplique el valor por el valor entero o de punto flotante especificado.
Comentarios:
1e+70
; macros de usuario y macros LLD; cadenas que incluyen macros, por ejemplo, {#MACRO}e+10
, {$MACRO1}e+{$MACRO2}
. Las macros deben resolverse en un n¨²mero entero o de punto flotante.Calcule la diferencia entre el valor actual y el anterior.
Comentarios:
Calcule la velocidad de cambio de valor (diferencia entre el valor actual y el anterior) por segundo.
Comentarios:
Convierta el valor del formato booleano a decimal.
Comentarios:
Convierta el valor del formato octal a decimal.
Si marca la casilla de verificaci¨®n Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor espec¨ªfico o establecer un mensaje de error espec¨ªfico. En caso de que falle un paso de preprocesamiento, la m¨¦trica no dejar¨¢ de ser compatible si se selecciona la opci¨®n de descartar el valor o establecer un valor espec¨ªfico.
Convierta el valor del formato hexadecimal a decimal.
Si marca la casilla de verificaci¨®n Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor espec¨ªfico o establecer un mensaje de error espec¨ªfico. En caso de que falle un paso de preprocesamiento, la m¨¦trica no dejar¨¢ de ser compatible si se selecciona la opci¨®n de descartar el valor o establecer un valor espec¨ªfico.
Ingrese el c¨®digo JavaScript en el editor modal que aparece al hacer clic en el campo de par¨¢metro o en el ¨ªcono del l¨¢piz que est¨¢ a su lado.
Comentarios:
Defina un rango en el que debe estar un valor especificando valores m¨ªnimos/m¨¢ximos (inclusive).
Comentarios:
Especifique una expresi¨®n regular con la que debe coincidir un valor.
Si marca la casilla de verificaci¨®n Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor espec¨ªfico o establecer un mensaje de error espec¨ªfico. En caso de que un paso de preprocesamiento falle, la m¨¦trica no dejar¨¢ de ser compatible si se selecciona la opci¨®n de descartar el valor o establecer un valor espec¨ªfico.
Especifique una expresi¨®n regular con la que un valor no debe coincidir.
Si marca la casilla de verificaci¨®n Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor espec¨ªfico o establecer un mensaje de error espec¨ªfico. En caso de que falle un paso de preprocesamiento, la m¨¦trica no dejar¨¢ de ser compatible si se selecciona la opci¨®n de descartar el valor o establecer un valor espec¨ªfico.
Busque un mensaje de error a nivel de aplicaci¨®n ubicado en JSONPath. Detenga el procesamiento si tuvo ¨¦xito y el mensaje no est¨¢ vac¨ªo; de lo contrario, contin¨²e procesando con el valor que hab¨ªa antes de este paso de preprocesamiento.
Comentarios:
Busque un mensaje de error a nivel de aplicaci¨®n ubicado en XPath. Detenga el procesamiento si tuvo ¨¦xito y el mensaje no est¨¢ vac¨ªo; de lo contrario, contin¨²e procesando con el valor que hab¨ªa antes de este paso de preprocesamiento.
Comentarios:
Busque un mensaje de error a nivel de aplicaci¨®n utilizando una expresi¨®n regular. Detenga el procesamiento si tuvo ¨¦xito y el mensaje no est¨¢ vac¨ªo; de lo contrario, contin¨²e procesando con el valor que hab¨ªa antes de este paso de preprocesamiento.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ:
Comentarios:
Compruebe si no se pudo recuperar ning¨²n valor de la m¨¦trica. Especifique c¨®mo se debe procesar el error, bas¨¢ndose en la inspecci¨®n del mensaje de error devuelto.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ:
Comentarios:
Descarta un valor si no ha cambiado.
Comentarios:
Descarta un valor si no ha cambiado dentro del per¨ªodo de tiempo definido (en segundos).
Comentarios:
Utilice la siguiente consulta para extraer los datos necesarios de las m¨¦tricas de Prometheus.
Consulte Comprobaciones de Prometheus para obtener m¨¢s detalles.
Convierta las m¨¦tricas de Prometheus requeridas a JSON.
Consulte Comprobaciones de Prometheus para obtener m¨¢s detalles.
Las macros de usuario y macros de usuario con contexto est¨¢n soportadas en:
El contexto de la macro se ignora cuando una macro se reemplaza con su valor. El valor de la macro se inserta en el c¨®digo tal cual, no es posible agregar escape adicional antes de colocar el valor en el c¨®digo JavaScript. Tenga en cuenta que esto puede provocar errores de JavaScript en algunos casos.
Consulte pruebas de preprocesamiento.