Áú»¢¶Ä²©

Esta es una traducci¨®n de la p¨¢gina de documentaci¨®n original en espa?ol. Ay¨²danos a mejorarla.

2 Preprocesamiento del valor de la m¨¦trica

¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô general

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:

  • multiplicar el valor del tr¨¢fico de la red por "8" para convertir bytes en bits;
  • obtener las estad¨ªsticas por segundo de un valor que aumenta progresivamente;
  • aplicar una expresi¨®n regular al valor;
  • utilizar un script personalizado para el valor;
  • elegir descartar los valores sin cambios.

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.

Transformaciones admitidas

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:

  • para pasos de Cambio simple, Cambio por segundo - el siguiente valor ser¨¢ ignorado porque no existe un valor previo para calcular el cambio;
  • para los pasos Descartar sin cambios, Descartar sin cambios con latido - el siguiente valor nunca ser¨¢ descartado, incluso si deber¨ªa haberlo sido debido a las reglas de descarte.
Expresi¨®n regular

Haga coincidir el valor con la expresi¨®n regular y reempl¨¢celo con la salida requerida.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ:

  • ±è²¹³Ù°ù¨®²Ô - la expresi¨®n regular;
  • salida: la plantilla de formato de salida. Una secuencia de escape \N (donde N=1¡­9) se reemplaza con el en¨¦simo grupo coincidente. Una secuencia de escape \0 se reemplaza con el texto coincidente.

Comentarios:

  • Si no se coincide con el valor de entrada, la m¨¦trica no ser¨¢ compatible;
  • La expresi¨®n regular admite la extracci¨®n de un m¨¢ximo de 10 grupos capturados con la secuencia \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 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.
  • Consulte la secci¨®n expresiones regulares para ver algunos ejemplos existentes.
Reemplazar

Busque la cadena de b¨²squeda y reempl¨¢cela por otra (o nada).

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ:

  • cadena de b¨²squeda: la cadena a buscar y reemplazar, distingue entre may¨²sculas y min¨²sculas (obligatorio);
  • reemplazo: la cadena con la que reemplazar la cadena de b¨²squeda. La cadena de reemplazo tambi¨¦n puede estar vac¨ªa, lo que permite eliminar la cadena de b¨²squeda donde se encuentre.

Comentarios:

  • Se reemplazar¨¢n todas las apariciones de la cadena de b¨²squeda;
  • Es posible utilizar secuencias de escape para buscar o reemplazar saltos de l¨ªnea, retornos de carro, tabulaciones y espacios "\n \r \t \s"; La barra invertida se puede escapar como "\\" y las secuencias de escape se pueden escapar como "\\n";
  • El escape de saltos de l¨ªnea, retorno de carro y tabulaciones se realiza autom¨¢ticamente durante el descubrimiento de bajo nivel.
Recortar

Elimina los caracteres especificados del principio y del final del valor.

Recorte derecho

Elimine los caracteres especificados del final del valor.

Recorte izquierdo

Elimina los caracteres especificados del principio del valor.

XML XPath

Extraiga valor o fragmento de datos XML utilizando la funcionalidad XPath.

Comentarios:

  • Para que esta opci¨®n funcione, el servidor Áú»¢¶Ä²© (o el proxy Áú»¢¶Ä²©) debe estar compilado con soporte libxml;
  • Los espacios de nombres no son compatibles;
  • 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.

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>
Ruta JSON

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.

CSV a JSON

Convierta los datos del archivo CSV al formato JSON.

Para obtener m¨¢s informaci¨®n, consulte: Preprocesamiento de CSV a JSON.

XML 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.

Valor de SNMP walk

Extraiga el valor por el nombre OID/MIB especificado y aplique las opciones de formato:

  • Sin cambios - devuelve una cadena hexadecimal como una cadena hexadecimal sin escape;
  • UTF-8 de hex-STRING - convierte cadena hexadecimal a cadena UTF-8;
  • MAC de hex-STRING - valida la cadena hexadecimal como direcci¨®n MAC y devuelve una cadena de direcci¨®n MAC adecuada (donde ' ' se reemplaza por ':');
  • Entero de BITS: convierte los primeros 8 bytes de una cadena de bits expresada como una secuencia de caracteres hexadecimales (por ejemplo, "1A 2B 3C 4D") en un entero sin signo de 64 bits. En cadenas de bits de m¨¢s de 8 bytes, los bytes siguientes se ignorar¨¢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.

SNMP walk a JSON

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:

  • Est¨¢n disponibles opciones de formato de valores similares a las del paso Valor de caminata SNMP;
  • Puede utilizar este paso de preprocesamiento para descubrimiento de OID SNMP;
  • 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.
Valor SNMP get

Aplique opciones de formato al valor de obtenci¨®n SNMP:

  • UTF-8 de Hex-STRING - convierte una cadena hexadecimal a una cadena UTF-8;
  • MAC de Hex-STRING - valida la cadena hexadecimal como direcci¨®n MAC y devuelve una cadena de direcci¨®n MAC adecuada (donde ' ' se reemplaza por ':');
  • Entero de BITS: convierte los primeros 8 bytes de una cadena de bits expresada como una secuencia de caracteres hexadecimales (por ejemplo, "1A 2B 3C 4D") en un entero sin signo de 64 bits. En cadenas de bits de m¨¢s de 8 bytes, los bytes siguientes se ignorar¨¢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.

Multiplicador personalizado

Multiplique el valor por el valor entero o de punto flotante especificado.

Comentarios:

  • Utilice esta opci¨®n para convertir valores recibidos en KB, MBps, etc., a B, Bps. De lo contrario, Áú»¢¶Ä²© no puede configurar correctamente prefijos (K, M, G, etc.).
  • Tenga en cuenta que si el tipo de informaci¨®n del elemento es Num¨¦rica (sin firmar), los valores entrantes con una parte fraccionaria se recortar¨¢n (es decir, '0,9' se convertir¨¢ en '0') antes de que se aplique el multiplicador personalizado;
  • Si usa un multiplicador personalizado o almacena el valor como Cambio por segundo para las m¨¦tricas con el tipo de informaci¨®n establecido en Num¨¦rica (sin firmar) y el valor calculado resultante es en realidad un n¨²mero flotante, el valor calculado a¨²n se acepta como un uno correcto recortando la parte decimal y almacenando el valor como un n¨²mero entero;
  • Compatible: notaci¨®n cient¨ªfica, por ejemplo, 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.
  • 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.
Cambio simple

Calcule la diferencia entre el valor actual y el anterior.

Comentarios:

  • Este paso puede ser ¨²til para medir un valor en constante crecimiento;
  • Evaluado como valor-prev_value, donde valor - el valor actual; prev_value - el valor recibido previamente;
  • S¨®lo se permite una operaci¨®n de cambio por m¨¦trica ("Cambio simple" o "Cambio por segundo");
  • Si el valor actual es menor que el valor anterior, Áú»¢¶Ä²© descarta esa diferencia (no almacena nada) y espera otro 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 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.
Cambio por segundo

Calcule la velocidad de cambio de valor (diferencia entre el valor actual y el anterior) por segundo.

Comentarios:

  • Este paso es ¨²til para calcular la velocidad por segundo de un valor en constante crecimiento;
  • Como este c¨¢lculo puede producir n¨²meros de punto flotante, se recomienda establecer el 'Tipo de informaci¨®n' en Num¨¦rico (flotante), incluso si los valores sin procesar entrantes son n¨²meros enteros. Esto es especialmente relevante para n¨²meros peque?os donde la parte decimal es importante. Si los valores de punto flotante son grandes y pueden exceder la longitud del campo 'flotante', en cuyo caso se puede perder el valor completo, se sugiere usar Numeric (unsigned) y as¨ª recortar solo la parte decimal.
  • Evaluado como (valor-prev_value)/(time-prev_time), donde value - el valor actual; prev_value - el valor recibido previamente; hora - la marca de tiempo actual; prev_time - la marca de tiempo del valor anterior;
  • S¨®lo se permite una operaci¨®n de cambio por m¨¦trica ("Cambio simple" o "Cambio por segundo");
  • Si el valor actual es menor que el valor anterior, Áú»¢¶Ä²© descarta esa diferencia (no almacena nada) y espera otro valor. Esto ayuda a trabajar correctamente, por ejemplo, con un ajuste (desbordamiento) de contadores SNMP de 32 bits.
  • 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.
Booleano a decimal

Convierta el valor del formato booleano a decimal.

Comentarios:

  • La representaci¨®n textual se traduce a 0 o 1. Por lo tanto, 'VERDADERO' se almacena como 1 y 'FALSO' se almacena como 0. Todos los valores coinciden sin distinguir entre may¨²sculas y min¨²sculas. Los valores actualmente reconocidos son, para TRUE - verdadero, t, s¨ª, y, encendido, en funcionamiento, habilitado, disponible, ok, maestro; para FALSO - falso, f, no, n, apagado, abajo, no utilizado, deshabilitado, no disponible, err, esclavo. Adem¨¢s, cualquier valor num¨¦rico distinto de cero se considera VERDADERO y el cero se considera FALSO.
  • 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.
Octal a decimal

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.

Hexadecimal a decimal

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.

JavaScript

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:

Dentro del rango

Defina un rango en el que debe estar un valor especificando valores m¨ªnimos/m¨¢ximos (inclusive).

Comentarios:

  • Se aceptan valores num¨¦ricos (incluido cualquier n¨²mero de d¨ªgitos, parte decimal opcional y parte exponencial opcional, valores negativos);
  • El valor m¨ªnimo debe ser menor que el m¨¢ximo;
  • Debe existir al menos un valor;
  • Se pueden utilizar macros de usuario y macros de descubrimiento de bajo nivel;
  • 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.
Coincide con la expresi¨®n regular

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.

No coincide con la expresi¨®n regular

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.

Comprobar si hay errores en JSON

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:

  • Estos errores de servicios externos se informan al usuario tal cual, sin agregar informaci¨®n del paso de preprocesamiento;
  • No se informar¨¢ ning¨²n error en caso de no poder analizar JSON no v¨¢lido;
  • 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.
Comprobar si hay errores en XML

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:

  • Estos errores de servicios externos se informan al usuario tal cual, sin agregar informaci¨®n del paso de preprocesamiento;
  • No se informar¨¢ ning¨²n error en caso de no poder analizar XML no v¨¢lido;
  • 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.
Compruebe si hay errores utilizando una expresi¨®n regular

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.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ:

  • ±è²¹³Ù°ù¨®²Ô - la expresi¨®n regular;
  • salida: la plantilla de formato de salida. Una secuencia de escape \N (donde N=1¡­9) se reemplaza con el en¨¦simo grupo coincidente. Una secuencia de escape \0 se reemplaza con el texto coincidente.

Comentarios:

  • Estos errores de servicios externos se informan al usuario tal cual, sin agregar informaci¨®n del paso de preprocesamiento;
  • 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.
Verifique el valor no soportado

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.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ:

  • alcance - seleccione el alcance del procesamiento de errores:
    cualquier error - cualquier error;
    coincidencias de error - solo el error que coincide con la expresi¨®n regular especificada en ±è²¹³Ù°ù¨®²Ô;
    * el error no coincide: solo el error que no coincide con la expresi¨®n regular especificada en ±è²¹³Ù°ù¨®²Ô*
  • ±è²¹³Ù°ù¨®²Ô: la expresi¨®n regular con la que hacer coincidir el error. Si se selecciona cualquier error en el par¨¢metro de alcance, este campo no se muestra. Si se muestra, este campo es obligatorio.

Comentarios:

  • Normalmente, la ausencia o la imposibilidad de recuperar un valor provocar¨ªa que la m¨¦trica dejara de ser compatible. En este paso de preprocesamiento es posible modificar este comportamiento marcando la opci¨®n Personalizado en caso de error. Las siguientes opciones personalizadas de manejo de errores est¨¢n disponibles: Descartar valor, Establecer valor en (el valor se puede utilizar en iniciadores), o Establecer error en.
  • La m¨¦trica seguir¨¢ siendo compatible si Descartar valor o Establecer valor en est¨¢ seleccionado;
  • La captura de grupos de expresiones regulares se admite en los campos Establecer valor en o Establecer error en. Una secuencia de escape \N (donde N=1¡­9) se reemplaza con el en¨¦simo grupo coincidente. Una secuencia de escape \0 se reemplaza con el texto coincidente.
  • Para este paso de preprocesamiento, la casilla de verificaci¨®n Personalizado en caso de error est¨¢ atenuado y siempre marcado;
  • Estos pasos siempre se ejecutan como los primeros pasos de preprocesamiento y se colocan por encima de todos los dem¨¢s despu¨¦s de guardar los cambios en la m¨¦trica.
  • Se admiten varios pasos Verificar valor no admitido, en el orden especificado. Un paso para cualquier error se colocar¨¢ autom¨¢ticamente como el ¨²ltimo paso de este grupo.
Descartar sin cambios

Descarta un valor si no ha cambiado.

Comentarios:

  • Si se descarta un valor, no se guarda en la base de datos y el servidor Áú»¢¶Ä²© no tiene conocimiento de que se recibi¨® este valor. No se evaluar¨¢n expresiones de iniciador y, como resultado, no se crear¨¢n ni resolver¨¢n problemas para los iniciadores relacionados. Las funciones funcionar¨¢n solo en funci¨®n de los datos que realmente est¨¦n guardados en la base de datos. Como las tendencias se crean en funci¨®n de los datos de la base de datos, si no se guarda ning¨²n valor durante una hora, tampoco habr¨¢ datos de tendencias para esa hora.
  • Solo se puede especificar una opci¨®n de limitaci¨®n por m¨¦trica.
Descartar sin cambios con latido

Descarta un valor si no ha cambiado dentro del per¨ªodo de tiempo definido (en segundos).

Comentarios:

  • Se admiten valores enteros positivos para especificar los segundos (m¨ªnimo - 1 segundo);
  • Se pueden utilizar sufijos de tiempo (p. ej., 30 s, 1 m, 2 h, 1 d);
  • Se pueden utilizar macros de usuario y macros de descubrimiento de bajo nivel;
  • Si se descarta un valor, no se guarda en la base de datos y el servidor Áú»¢¶Ä²© no tiene conocimiento de que se recibi¨® este valor. No se evaluar¨¢n expresiones de iniciador y, como resultado, no se crear¨¢n ni resolver¨¢n problemas para los iniciadores relacionados. Las funciones funcionar¨¢n solo en funci¨®n de los datos que realmente est¨¦n guardados en la base de datos. Como las tendencias se crean en funci¨®n de los datos de la base de datos, si no se guarda ning¨²n valor durante una hora, tampoco habr¨¢ datos de tendencias para esa hora.
  • Solo se puede especificar una opci¨®n de limitaci¨®n por m¨¦trica.
Patr¨®n de Prometeo

Utilice la siguiente consulta para extraer los datos necesarios de las m¨¦tricas de Prometheus.

Consulte Comprobaciones de Prometheus para obtener m¨¢s detalles.

Prometheus a JSON

Convierta las m¨¦tricas de Prometheus requeridas a JSON.

Consulte Comprobaciones de Prometheus para obtener m¨¢s detalles.

Soporte de macros

Las macros de usuario y macros de usuario con contexto est¨¢n soportadas en:

  • par¨¢metros de los pasos de preprocesamiento, incluido el c¨®digo JavaScript;
  • par¨¢metros personalizados de manejo de errores (campos Establecer valor en y Establecer error 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.

Pruebas

Consulte pruebas de preprocesamiento.