2 Preprocesamiento de valores de métricas

Descripción general

El preprocesamiento le permite aplicar transformaciones a los valores de las métricas recibidas antes de guardarlos en la base de datos. Estas transformaciones/pasos de preprocesamiento son realizados por el servidor Zabbix o el proxy (si las métricas son monitorizadas por un proxy).

Esta función admite una variedad de casos de uso, tales como:

• convertir bytes a bits (por ejemplo, multiplicando los valores de tráfico de red por "8");
• calcular estadísticas por segundo para valores que aumentan incrementalmente;
• aplicar expresiones regulares para extraer o modificar valores;
• ejecutar scripts personalizados sobre los valores;
• descartar valores sin cambios para optimizar el almacenamiento en la base de datos.

Se pueden configurar uno o más pasos de preprocesamiento para una métrica. Estos pasos se ejecutan en el orden en que se configuran.

Todos los valores pasados al preprocesamiento se tratan inicialmente como cadenas de texto. La conversión al tipo de valor deseado (según lo definido en la configuración de la métrica) se realiza al final de la cadena de preprocesamiento. Sin embargo, pasos de preprocesamiento específicos pueden activar conversiones anteriores, si es necesario. Para información técnica detallada, consulte Detalles del preprocesamiento.

Para asegurarse de que su configuración de preprocesamiento funciona como espera, puede probarla.

Consulte también: Ejemplos de preprocesamiento

Configuración

Los pasos de preprocesamiento se definen en la pestaña Preprocesamiento del formulario de configuración de la métrica.

Haga clic en Añadir para seleccionar una transformación soportada.

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 Creando una métrica para una descripción detallada de los parámetros.

Transformaciones compatibles

Todas las transformaciones compatibles se enumeran a continuación. Haga clic en el nombre de la transformación para ver todos los detalles sobre ella.

Tenga en cuenta que para los pasos de preprocesamiento Cambio y Limitación, Zabbix debe recordar el último valor para calcular/comparar el nuevo valor según sea necesario. Estos valores anteriores son gestionados por el gestor de preprocesamiento. Si el servidor o proxy de Zabbix se reinicia o se realiza algún cambio en los pasos de preprocesamiento, el último valor de la métrica correspondiente se restablece, lo que resulta en:

• para los pasos Cambio simple, Cambio por segundo - el siguiente valor será ignorado porque no hay un valor anterior para calcular el cambio;
• para los pasos Descartar sin cambios, Descartar sin cambios con latido - el siguiente valor nunca se descartará, incluso si debería haberse descartado debido a las reglas de descarte.

Expresión regular

Coincide el valor con la expresión regular y reemplaza con la salida requerida.

Parámetros:

• pattern - la expresión regular;
  
• output - la plantilla de formato de salida. Una secuencia de escape \N (donde N=1…9) se reemplaza por el N-ésimo grupo coincidente. Una secuencia de escape \0 se reemplaza por el texto coincidente.

Comentarios:

• Si no se encuentra coincidencia con el valor de entrada, la métrica quedará como no soportada;
  
• La expresión regular permite extraer un máximo de 10 grupos capturados con la secuencia \N;
  
• Si marca la casilla Personalizado en caso de fallo, 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 el paso de preprocesamiento, la métrica no quedará como no soportada si se selecciona la opción de descartar el valor o establecer un valor específico.
  
• Consulte la sección de expresiones regulares para ver algunos ejemplos existentes.

Reemplazar

Busca la cadena de búsqueda y la reemplaza por otra (o por nada).

Parámetros:

• cadena de búsqueda: la cadena a buscar y reemplazar, distingue mayúsculas y minúsculas (obligatorio);
  
• reemplazo: la cadena por la que se 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 cuando se encuentra.

Comentarios:

• Todas las apariciones de la cadena de búsqueda serán reemplazadas;
• Es posible utilizar secuencias de escape para buscar o reemplazar saltos de línea, retorno de carro, tabulaciones y espacios "\n \r \t \s"; la barra invertida puede escaparse como "\\" y las secuencias de escape pueden escaparse 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 final del valor.

Recorte derecho

Elimina los caracteres especificados del final del valor.

Recorte izquierdo

Elimina los caracteres especificados del principio del valor.

XML XPath

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

Comentarios:

• Para que esta opción funcione, el servidor Zabbix (o el proxy Zabbix) debe estar compilado con soporte para libxml;
  
• No se admiten espacios de nombres;
  
• Si marca la casilla Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor especificado o establecer un mensaje de error especificado. En caso de que falle el paso de preprocesamiento, la métrica no quedará como no soportada si se selecciona la opción de descartar el valor o establecer un valor especificado.

Ejemplos:

number(/document/item/value) #extraerá '10' de <document><item><value>10</value></item></document>
       number(/document/item/@attribute) #extraerá '10' de <document><item attribute="10"></item></document>
       /document/item #extraerá '<item><value>10</value></item>' de <document><item><value>10</value></item></document>

JSON Path

Extrae un valor o fragmento de datos JSON utilizando la funcionalidad JSONPath.

Si marca la casilla Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor especificado o establecer un mensaje de error especificado. En caso de que falle el paso de preprocesamiento, la métrica no quedará como no soportada si se selecciona la opción de descartar el valor o establecer un valor especificado.

CSV a JSON

Convierte los datos de un archivo CSV en formato JSON.

Para más información, consulte: Preprocesamiento CSV a JSON.

XML a JSON

Convierte datos en formato XML a JSON.

Para más información, consulte: Reglas de serialización.

Si marca la casilla Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor especificado o establecer un mensaje de error especificado. En caso de que falle el paso de preprocesamiento, la métrica no quedará como no soportada si se selecciona la opción de descartar el valor o establecer un valor especificado.

Valor de SNMP walk

Extrae el valor por el OID/nombre de MIB especificado y aplica opciones de formato:

• Sin cambios: devuelve la cadena hexadecimal como una cadena hexadecimal sin escape (nota que aún se aplican las sugerencias de visualización);
  
• UTF-8 desde hex-STRING: convierte la cadena hexadecimal a una cadena UTF-8;
  
• MAC desde hex-STRING: valida la cadena hexadecimal como una dirección MAC y devuelve una cadena de dirección MAC adecuada (donde ' ' se reemplazan por ':');
  
• Entero desde 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 más largas que 8 bytes, los bytes siguientes serán ignorados.

Si marca la casilla Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor especificado o establecer un mensaje de error especificado. En caso de que falle un paso de preprocesamiento, la métrica no se volverá no soportada si se selecciona la opción de descartar el valor o establecer un valor especificado.

SNMP walk a JSON

Convierte valores SNMP a JSON.

Especifique un nombre de campo en el JSON y la ruta OID SNMP correspondiente. Los valores de los campos se rellenarán con los valores en la ruta OID SNMP especificada.

Comentarios:

• Hay disponibles opciones de formato de valor similares a las de la etapa Valor de SNMP walk;
  
• Puede utilizar este paso de preprocesamiento para el descubrimiento de OID SNMP;
  
• Si marca la casilla Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor especificado o establecer un mensaje de error especificado. En caso de que falle el paso de preprocesamiento, la métrica no quedará como no soportada si se selecciona la opción de descartar el valor o establecer un valor especificado.

Valor SNMP get

Aplicar opciones de formato al valor SNMP get:

• UTF-8 desde Hex-STRING: convierte una cadena hexadecimal en una cadena UTF-8;
  
• MAC desde Hex-STRING: valida la cadena hexadecimal como una dirección MAC y devuelve una cadena de dirección MAC adecuada (donde ' ' se reemplazan por ':');
  
• Entero desde 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 más largas que 8 bytes, los bytes siguientes serán ignorados.

Si marca la casilla Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor especificado o establecer un mensaje de error especificado. En caso de que falle un paso de preprocesamiento, la métrica no quedará como no soportada si se selecciona la opción de descartar el valor o establecer un valor especificado.

Multiplicador personalizado

Multiplica el valor por el valor entero o de coma flotante especificado.

Comentarios:

• Utilice esta opción para convertir valores recibidos en KB, MBps, etc., a B, Bps. De lo contrario, Zabbix no podrá establecer correctamente los prefijos (K, M, G, etc.).
  
• Tenga en cuenta que si el tipo de información de la métrica es Numérico (sin signo), los valores entrantes con una parte fraccionaria se truncarán (es decir, '0.9' se convertirá en '0') antes de aplicar el multiplicador personalizado;
  
• Si utiliza un multiplicador personalizado o almacena el valor como Cambio por segundo para métricas con el tipo de información establecido en Numérico (sin signo) y el valor calculado resultante es en realidad un número flotante, el valor calculado aún se acepta como correcto truncando la parte decimal y almacenando el valor como un entero;
  
• Soportado: notación científica, por ejemplo, 1e+70; macros de usuario y macros LLD; cadenas que incluyan macros, por ejemplo, {#MACRO}e+10, {$MACRO1}e+{$MACRO2}. Las macros deben resolverse en un número entero o de coma flotante.
• Si marca la casilla Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor especificado o establecer un mensaje de error especificado. En caso de que falle un paso de preprocesamiento, la métrica no se volverá no soportada si se selecciona la opción de descartar el valor o establecer un valor especificado.

Cambio simple

Calcula la diferencia entre el valor actual y el anterior.

Comentarios:

• Este paso puede ser útil para medir un valor que crece constantemente;
  
• Se evalúa como valor-valor_anterior, donde valor - el valor actual; valor_anterior - el valor recibido anteriormente;
  
• Solo 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, Zabbix descarta esa diferencia (no almacena nada) y espera otro valor;
  
• Si marca la casilla Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor especificado o establecer un mensaje de error especificado. En caso de que falle un paso de preprocesamiento, la métrica no se volverá no soportada si se selecciona la opción de descartar el valor o establecer un valor especificado.

Cambio por segundo

Calcula la velocidad de cambio del 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 que crece constantemente;
  
• Como este cálculo puede producir números de coma flotante, se recomienda establecer el 'Tipo de información' en Numérico (coma flotante), incluso si los valores brutos entrantes son enteros. Esto es especialmente relevante para números pequeños donde la parte decimal importa. Si los valores de coma flotante son grandes y pueden exceder la longitud del campo 'float', en cuyo caso se puede perder todo el valor, en realidad se sugiere usar Numérico (sin signo) y así recortar solo la parte decimal.
  
• Se evalúa como (valor-valor_anterior)/(tiempo-tiempo_anterior), donde valor - el valor actual; valor_anterior - el valor recibido anteriormente; tiempo - la marca de tiempo actual; tiempo_anterior - la marca de tiempo del valor anterior;
  
• Solo 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, Zabbix descarta esa diferencia (no almacena nada) y espera otro valor. Esto ayuda a trabajar correctamente, por ejemplo, con un desbordamiento de contadores SNMP de 32 bits.
  
• Si marca la casilla Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor especificado o establecer un mensaje de error especificado. En caso de que falle un paso de preprocesamiento, la métrica no se volverá no soportada si se selecciona la opción de descartar el valor o establecer un valor especificado.

Booleano a decimal

Convierte el valor de formato booleano a decimal.

Comentarios:

• La representación textual se traduce en 0 o 1. Así, 'TRUE' se almacena como 1 y 'FALSE' se almacena como 0. Todos los valores se comparan sin distinguir mayúsculas de minúsculas. Los valores actualmente reconocidos son, para TRUE - true, t, yes, y, on, up, running, enabled, available, ok, master; para FALSE - false, f, no, n, off, down, unused, disabled, unavailable, err, slave. Además, cualquier valor numérico distinto de cero se considera TRUE y cero se considera FALSE.
  
• Si marca la casilla Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor especificado o establecer un mensaje de error especificado. En caso de que falle un paso de preprocesamiento, la métrica no se volverá no soportada si se selecciona la opción de descartar el valor o establecer un valor especificado.

Octal a decimal

Convierte el valor de formato octal a decimal.

Si marca la casilla Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor especificado o establecer un mensaje de error especificado. En caso de que falle el paso de preprocesamiento, la métrica no quedará como no soportada si se selecciona la opción de descartar el valor o establecer un valor especificado.

Hexadecimal a decimal

Convierte el valor de formato hexadecimal a decimal.

Si marca la casilla Personalizado en caso de fallo, 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 el paso de preprocesamiento, la métrica no quedará como no soportada si se selecciona la opción de descartar el valor o establecer un valor específico.

JavaScript

Introduzca el código JavaScript en el editor modal que se abre al hacer clic en el campo del parámetro o en el icono de lápiz junto a él.

Comentarios:

• La longitud de JavaScript disponible depende de la base de datos utilizada;
  
• Para más información, consulte: Preprocesamiento Javascript.

En rango

Defina un rango en el que un valor debe estar especificando los valores mínimo/máximo (inclusive).

Comentarios:

• Se aceptan valores numéricos (incluyendo 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 usar macros de usuario y macros de bajo nivel;
  
• Si marca la casilla Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor especificado o establecer un mensaje de error especificado. En caso de que falle un paso de preprocesamiento, la métrica no se volverá no soportada si se selecciona la opción de descartar el valor o establecer un valor especificado.

Coincide con la expresión regular

Especifique una expresión regular con la que un valor debe coincidir.

Si marca la casilla Personalizado en caso de fallo, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor especificado o establecer un mensaje de error especificado. En caso de que falle el paso de preprocesamiento, la métrica no quedará como no soportada si se selecciona la opción de descartar el valor o establecer un valor especificado.

No coincide con la expresión regular

Especifique una expresión regular que un valor no debe coincidir.

Si marca la casilla Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor especificado o establecer un mensaje de error especificado. En caso de que falle un paso de preprocesamiento, la métrica no quedará como no soportada si se selecciona la opción de descartar el valor o establecer un valor especificado.

Comprobar error en JSON

Comprueba si existe un mensaje de error a nivel de aplicación ubicado en JSONPath. Detiene el procesamiento si tiene éxito y el mensaje no está vacío; de lo contrario, continúa procesando con el valor que tenía antes de este paso de preprocesamiento.

Comentarios:

• Estos errores de servicios externos se informan al usuario tal cual, sin añadir información del paso de preprocesamiento;
  
• No se informará ningún error en caso de que falle el análisis de un JSON no válido;
  
• Si marca la casilla Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor especificado o establecer un mensaje de error especificado. En caso de que falle el paso de preprocesamiento, la métrica no quedará como no soportada si se selecciona la opción de descartar el valor o establecer un valor especificado.

Comprobar error en XML

Comprueba si hay un mensaje de error a nivel de aplicación localizado en XPath. Detiene el procesamiento si tiene éxito y el mensaje no está vacío; de lo contrario, continúa procesando con el valor que tenía antes de este paso de preprocesamiento.

Comentarios:

• Estos errores de servicios externos se informan al usuario tal cual, sin añadir información del paso de preprocesamiento;
  
• No se informará ningún error en caso de que falle el análisis de un XML no válido;
  
• Si marca la casilla Personalizado en caso de fallo, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor especificado o establecer un mensaje de error especificado. En caso de que falle el paso de preprocesamiento, la métrica no quedará como no soportada si se selecciona la opción de descartar el valor o establecer un valor especificado.

Comprobar error usando una expresión regular

Comprueba un mensaje de error a nivel de aplicación utilizando una expresión regular. Detiene el procesamiento si tiene éxito y el mensaje no está vacío; de lo contrario, continúa procesando con el valor que tenía antes de este paso de preprocesamiento.

Parámetros:

• pattern - la expresión regular;
  
• output - la plantilla de formato de salida. Una secuencia de escape \N (donde N=1…9) se reemplaza por el N-ésimo grupo coincidente. Una secuencia de escape \0 se reemplaza por el texto coincidente.

Comentarios:

• Estos errores de servicios externos se informan al usuario tal cual, sin añadir información del paso de preprocesamiento;
  
• Si marca la casilla Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor especificado o establecer un mensaje de error especificado. En caso de que falle el paso de preprocesamiento, la métrica no quedará como no soportada si se selecciona la opción de descartar el valor o establecer un valor especificado.

Comprobar si el valor no es compatible

Comprueba si no se pudo recuperar el valor de la métrica. Especifique cómo debe procesarse el fallo, basándose en la inspección del mensaje de error devuelto.

Parámetros:

• scope - seleccione el alcance del procesamiento de errores:
  cualquier error - cualquier error;
  el error coincide - solo el error que coincide con la expresión regular especificada en pattern;
  el error no coincide - solo el error que no coincide con la expresión regular especificada en pattern
  
• pattern - la expresión regular para hacer coincidir el error. Si en el parámetro scope se selecciona cualquier error, este campo no se muestra. Si se muestra, este campo es obligatorio.
  

Comentarios:

• Normalmente, la ausencia o el fallo al recuperar un valor haría que la métrica pasara a no ser compatible. Este paso de preprocesamiento le permite modificar este comportamiento. Si marca la casilla Personalizado en caso de fallo (siempre marcada y deshabilitada para este paso de preprocesamiento), es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor especificado o establecer un mensaje de error especificado. En caso de que falle el paso de preprocesamiento, la métrica no pasará a no ser compatible si se selecciona la opción de descartar el valor o establecer un valor especificado.
• Este paso de preprocesamiento solo comprueba si no se pudo recuperar el valor de la métrica. No comprueba, por ejemplo, si el tipo de valor recuperado (por ejemplo, cadena) coincide con el tipo de información de la métrica (por ejemplo, numérico); para más detalles, consulte Ejemplos de preprocesamiento. Si hay una incompatibilidad de tipo, la métrica aún puede pasar a no ser compatible después de que se ejecuten todos los pasos de preprocesamiento. Para comprobar una incompatibilidad de tipo, puede utilizar, por ejemplo, el paso de preprocesamiento Multiplicador personalizado; consulte Ejemplos de preprocesamiento.
• Se admite la captura de grupos de expresiones regulares en los campos Establecer valor en o Establecer error en. Utilice \N (donde N=1…9) para recuperar el N-ésimo grupo coincidente; utilice \0 para recuperar el texto coincidente;
• 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 múltiples pasos de Comprobar si el valor no es compatible, en el orden especificado. Un paso para cualquier error se colocará automáticamente como el último paso en este grupo.

Descartar sin cambios

Descartar un valor si no ha cambiado.

Comentarios:

• Si se descarta un valor, no se guarda en la base de datos y el servidor Zabbix no tiene conocimiento de que se recibió ese valor. No se evaluarán expresiones de disparadores, por lo tanto, no se crearán/resolverán problemas para los disparadores relacionados. Las funciones solo funcionarán en base a los datos que realmente se guarden en la base de datos. Como las tendencias se construyen en base a los datos en 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 usar sufijos de tiempo (por ejemplo, 30s, 1m, 2h, 1d);
  
• Se pueden usar macros de usuario y macros de bajo nivel de descubrimiento;
  
• Si se descarta un valor, no se guarda en la base de datos y el servidor Zabbix no tiene conocimiento de que se recibió este valor. No se evaluarán expresiones de disparadores, por lo tanto, no se crearán/solucionarán problemas para los disparadores relacionados. Las funciones solo funcionarán en base a los datos que realmente se guarden en la base de datos. Como las tendencias se construyen en base a los datos en la base de datos, si no hay ningún valor guardado 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 Prometheus

Utilice la siguiente consulta para extraer los datos requeridos de las métricas de Prometheus.

Consulte Comprobaciones de Prometheus para más detalles.

Prometheus a JSON

Convierte las métricas de Prometheus requeridas a JSON.

Consulta Comprobaciones de Prometheus para más detalles.

Soporte de macros

Se admiten macros de usuario y macros de usuario con contexto en:

• parámetros de pasos de preprocesamiento, incluido el código JavaScript;
• parámetros de gestión de errores personalizados (campos Establecer valor en y Establecer error en).

Pruebas

Consulte pruebas de preprocesamiento.