Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Transforma los datos

Las transformaciones son una forma eficaz de manipular los datos devueltos por una consulta antes de que el sistema aplique una visualización. Con las transformaciones, puede:

Para los usuarios que dependen de varias vistas del mismo conjunto de datos, las transformaciones ofrecen un método eficaz para crear y mantener numerosos paneles.

También puede utilizar el resultado de una transformación como entrada para otra transformación, lo que se traduce en un aumento del rendimiento.

Tipos de transformación

Grafana proporciona varias formas de transformar los datos. A continuación, encontrará una lista completa de funciones de transformación.

Orden de las transformaciones

Cuando hay varias transformaciones, Grafana las aplica en el orden en que aparecen en la lista. Cada transformación crea un conjunto de resultados que, a continuación, pasa a la siguiente transformación del proceso de procesamiento.

El orden en que Grafana aplica las transformaciones afecta directamente a los resultados. Por ejemplo, si utiliza una transformación de Reducción para condensar todos los resultados de una columna en un único valor, solo podrá aplicar las transformaciones a ese único valor.

Agregue una función de transformación a los datos

Los siguientes pasos lo guían para agregar una transformación a los datos.

Depura una transformación

Para ver los conjuntos de resultados de entrada y salida de la transformación, selecciona el icono de error situado en la parte derecha de la fila de la transformación.

Los conjuntos de resultados de entrada y salida pueden ayudarle a depurar una transformación.

Eliminar una transformación

Le recomendamos que elimine las transformaciones que no necesite. Al eliminar una transformación, se eliminan los datos de la visualización.

Requisitos previos:

Identifique todos los paneles que se basan en la transformación e informe a los usuarios afectados.

Funciones de transformación

Puede realizar las siguientes transformaciones en sus datos.

Agregue un campo a partir del cálculo

Use esta transformación para agregar un campo nuevo calculado a partir de otros dos campos. Cada transformación le permite añadir un campo nuevo.

Concatenar campos

Esta transformación combina todos los campos de todos los marcos en un solo resultado. Tenga en cuenta estas dos consultas.

Consulta A:

Consulta B:

Tras concatenar los campos, el marco de datos sería:

Config a partir de los resultados de la consulta

Esta transformación le permite seleccionar una consulta y, a partir de ella, extraer opciones estándar como el mínimo, el máximo, la unidad y los umbrales, y aplicarlas a otros resultados de consultas. Esto permite una configuración de visualización dinámica basada en consultas.

Si quieres extraer una configuración única para cada fila del resultado de la consulta de configuración, prueba la transformación de filas a campos.

Opciones

Convierte el tipo de campo

Esta transformación cambia el tipo de campo del campo especificado.

Por ejemplo, la siguiente consulta se puede modificar seleccionando el campo de hora como Hora y el formato de fecha como AAAA.

El resultado:

Filtrar datos por nombre

Utilice esta transformación para eliminar partes de los resultados de la consulta.

Grafana muestra el campo Identificador, seguido de los campos devueltos por la consulta.

Los filtros se pueden aplicar de dos maneras:

Filtra los datos por consulta

Utilice esta transformación en los paneles que tengan varias consultas si desea ocultar una o más consultas.

Grafana muestra las letras de identificación de la consulta en texto gris oscuro. Haga clic en un identificador de consulta para activar o desactivar el filtrado. Si la letra de consulta es blanca, se muestran los resultados. Si la letra de consulta está oscura, los resultados se ocultan.

Filtre los datos por valor

Esta transformación le permite filtrar sus datos directamente en Grafana y eliminar algunos puntos de datos del resultado de la consulta. Tiene la opción de incluir o excluir los datos que coincidan con una o más condiciones que defina. Las condiciones se aplican a un campo seleccionado.

Esta transformación resulta útil si la fuente de datos no filtra por valores de forma nativa. También puede utilizar esta opción para restringir los valores que se muestran si utiliza una consulta compartida.

Las condiciones disponibles para todos los campos son:

Las condiciones disponibles para los campos numéricos son:

Considere el siguiente conjunto de datos:

Si incluye los puntos de datos que tienen una temperatura inferior a 30 °C, la configuración tendrá el siguiente aspecto:

Y obtendrá el siguiente resultado, donde solo se incluyen las temperaturas por debajo de 30 °C:

Puede añadir más de una condición al filtro. Por ejemplo, es posible que desee incluir los datos solo si la altitud es superior a 100. Para ello, añada esa condición a la siguiente configuración:

Si tiene más de una condición, puede elegir si desea que la acción (incluir o excluir) se aplique en las filas que cumplan todas las condiciones o que coincidan con alguna de las condiciones que haya agregado.

En el ejemplo anterior, elegimos Hacer coincidir todo porque queríamos incluir las filas que tienen una temperatura inferior a 30 °C y una altitud superior a 100 °C. Si en su lugar quisiéramos incluir las filas que tienen una temperatura inferior a 30 grados o una altitud superior a 100 grados, seleccionaríamos Coincidir con cualquier otra. Esto incluiría la primera fila de los datos originales, que tiene una temperatura de 32 °C (no coincide con la primera condición) pero una altitud de 101 (que coincide con la segunda condición), por lo que se incluye.

Se ignoran las condiciones que no sean válidas o que estén configuradas de forma incompleta.

Agrupar por

Esta transformación agrupa los datos por un valor de campo (columna) específico y procesa los cálculos de cada grupo. Haga clic aquí para ver una lista de las opciones de cálculo.

Este es un ejemplo de datos originales.

Esta transformación se lleva a cabo en dos pasos. En primer lugar, especifique uno o varios campos por los que agrupar los datos. Esto agrupará los mismos valores de esos campos, como si los hubiera ordenado. Por ejemplo, si los agrupamos por el campo ID del servidor, agruparía los datos de esta manera:

Todas las filas con el mismo valor de ID de servidor se agrupan.

Tras elegir el campo por el que desea agrupar los datos, puede añadir varios cálculos en los demás campos y aplicar el cálculo a cada grupo de filas. Por ejemplo, podríamos querer calcular la temperatura media de la CPU para cada uno de esos servidores. Por lo tanto, podemos añadir el cálculo medio aplicado en el campo de temperatura de la CPU para obtener lo siguiente:

Y podemos añadir más de un cálculo. Por ejemplo:

Entonces obtendríamos:

Esta transformación le permite extraer información clave de sus series temporales y mostrarla de forma cómoda.

Unir por campo

Utilice esta transformación para unir varios resultados en una sola tabla. Esto resulta especialmente útil para convertir los resultados de varias series temporales en una sola tabla ancha con un campo de tiempo compartido.

Combinación interna

Una combinación interna combina datos de varias tablas en las que todas las tablas comparten el mismo valor del campo seleccionado. Este tipo de combinación excluye los datos en los que los valores no coinciden en todos los resultados.

Utilice esta transformación para combinar los resultados de varias consultas (combinándolos en un campo de combinación aprobado o en la primera columna de tiempo) en un solo resultado y elimine las filas en las que no se pueda realizar una unión correcta.

En el siguiente ejemplo, dos consultas devuelven datos de la tabla. Se visualiza como dos tablas independientes antes de aplicar la transformación de unión interna.

Consulta A:

Consulta B:

El resultado después de aplicar la transformación de unión interna es el siguiente:

Unión externa

Una unión externa incluye todos los datos de una unión interna y las filas en las que los valores no coinciden en todas las entradas. Mientras que la combinación interna une la consulta A y la consulta B en el campo de tiempo, la combinación externa incluye todas las filas que no coinciden en el campo de tiempo.

En el siguiente ejemplo, dos consultas devuelven datos de la tabla. Se visualiza como dos tablas antes de aplicar la transformación de unión externa.

Consulta A:

Consulta B:

El resultado después de aplicar la transformación de unión externa es el siguiente:

Etiquetas de los campos

Esta transformación cambia los resultados de las series temporales que incluyen etiquetas o rótulos a una tabla en la que las claves y los valores de cada etiqueta se incluyen en el resultado de la tabla. Las etiquetas se pueden mostrar como columnas o como valores de fila.

Dado el resultado de una consulta de dos series temporales:

En el modo Columnas, el resultado es el siguiente:

En el modo «Filas», el resultado tiene una tabla para cada serie y muestra cada valor de etiqueta de la siguiente manera:

Nombre del campo de valor

Si seleccionó Servidor como nombre del campo de valor, obtendrá un campo por cada valor de la etiqueta del servidor.

Comportamiento de fusión

El transformador de etiquetas a campos es internamente dos transformaciones separadas. La primera actúa sobre una sola serie y extrae las etiquetas de los campos. La segunda es la transformación de combinación que une todos los resultados en una sola tabla. La transformación de combinación intenta unir todos los campos coincidentes. Este paso de combinación es obligatorio y no se puede desactivar.

Para ilustrarlo, a continuación se muestra un ejemplo en el que tiene dos consultas que devuelven series temporales sin etiquetas superpuestas.

En primer lugar, se obtendrán estas dos tablas:

Tras la fusión:

Merge

Utilice esta transformación para combinar el resultado de varias consultas en un único resultado. Esto resulta útil cuando se utiliza la visualización del panel de tablas. Los valores que se pueden combinar se combinan en la misma fila. Los valores se pueden combinar si los campos compartidos contienen los mismos datos.

En el siguiente ejemplo, tenemos dos consultas que devuelven datos de tablas. Se visualiza como dos tablas independientes antes de aplicar la transformación.

Consulta A:

Consulta B:

Este es el resultado después de aplicar la transformación Merge:

Organice los campos

Utilice esta transformación para cambiar el nombre, reordenar u ocultar los campos devueltos por la consulta.

Grafana muestra una lista de campos devueltos por la consulta. Puede hacer lo siguiente:

Divida por valores

Esta transformación puede ayudar a eliminar la necesidad de realizar múltiples consultas a la misma fuente de datos con WHERE cláusulas diferentes al graficar varias series. Considere una tabla SQL de métricas con los siguientes datos:

Antes de la versión 9.3, si querías trazar una línea de tendencia roja para EE. UU. y otra azul para la UE en el mismo TimeSeries panel, lo más probable es que tuvieras que dividirla en dos consultas:

SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='US'
SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='EU'

Esto también requiere que sepas con antelación qué regiones existen realmente en la tabla de métricas.

Con el transformador Particionar por valores, ahora puede emitir una sola consulta y dividir los resultados por valores únicos en una o más columnas (fields) de su elección. El siguiente ejemplo utiliza Region.

SELECT Time, Region, Value FROM metrics WHERE Time > '2022-10-20'

Reducir

La transformación Reducir aplica un cálculo a cada campo del marco y devuelve un único valor. Los campos de tiempo se eliminan al aplicar esta transformación.

Tenga en cuenta la entrada:

Consulta A:

Consulta B:

El transformador reductor tiene dos modos:

Por ejemplo, si utilizó el primer y el último cálculo con una transformación de serie a filas, el resultado sería:

Al reducir los campos con el último cálculo, se obtienen dos marcos, cada uno con una fila:

Consulta A:

Consulta B:

Cambiar el nombre por expresión regular

Utilice esta transformación para cambiar el nombre de partes de los resultados de la consulta mediante una expresión regular y un patrón de reemplazo.

Puede especificar una expresión regular, que solo se aplica a las coincidencias, junto con un patrón de reemplazo que admita las referencias inversas. Por ejemplo, imaginemos que está visualizando el uso de la CPU por host y desea eliminar el nombre de dominio. Podrías establecer la expresión regular en ([^\.]+)\..+ y el patrón de reemplazo en$1, web-01.example.com sería. web-01

De filas a campos

La transformación de filas a campos convierte las filas en campos separados. Esto puede resultar útil, ya que los campos se pueden diseñar y configurar de forma individual. También puede usar campos adicionales como fuentes para la configuración dinámica de campos o asignarlos a etiquetas de campo. Luego, las etiquetas adicionales se pueden usar para definir mejor los nombres de visualización de los campos resultantes.

Esta transformación incluye una tabla de campos en la que se enumeran todos los campos de los datos devueltos por la consulta de configuración. Esta tabla le permite controlar qué campo debe asignarse a cada propiedad de configuración (la opción *Usar as**). También puedes elegir qué valor seleccionar si hay varias filas en los datos devueltos.

Esta transformación requiere:

Útil cuando se visualizan datos en:

Asigne campos adicionales a etiquetas

Si un campo no se asigna a la propiedad de configuración, Grafana lo usará automáticamente como fuente para una etiqueta en el campo de salida:

Ejemplo:

Salida:

Las etiquetas adicionales ahora se pueden usar en el nombre de visualización del campo para proporcionar nombres de campo más completos.

Si desea extraer la configuración de una consulta y aplicarla a otra, debe usar la configuración de la transformación de los resultados de la consulta.

Ejemplo

Input:

Salida:

Como puede ver, cada fila de los datos de origen se convierte en un campo independiente. Cada campo ahora también tiene un conjunto de opciones de configuración máxima. Las opciones como el mínimo, el máximo, la unidad y los umbrales forman parte de la configuración del campo y, si se configuran de esta manera, la visualización utilizará esta opción en lugar de las opciones configuradas manualmente en el panel de opciones del editor de paneles.

Prepare series temporales

Preparar la transformación de series temporales resulta útil cuando una fuente de datos devuelve datos de series temporales en un formato que no es compatible con el panel que desea utilizar.

Esta transformación le ayuda a resolver este problema al convertir los datos de series temporales del formato ancho al formato largo o al revés.

Seleccione la opción Serie temporal de varios fotogramas para transformar el marco de datos de series temporales del formato ancho al formato largo.

Seleccione la opción Serie temporal ancha para transformar el marco de datos de la serie temporal del formato largo al ancho.

De series a filas

Utilice esta transformación para combinar el resultado de varias consultas de datos de series temporales en un único resultado. Esto resulta útil cuando se utiliza la visualización del panel de tablas.

El resultado de esta transformación contendrá tres columnas: Tiempo, Métrica y Valor. La columna Métrica se agrega para que pueda ver fácilmente de qué consulta se origina la métrica. Personalice este valor definiendo la etiqueta en la consulta de origen.

En el siguiente ejemplo, tenemos dos consultas que devuelven datos de series temporales. Se visualiza como dos tablas independientes antes de aplicar la transformación.

Consulta A:

Consulta B:

Este es el resultado después de aplicar la transformación de series a filas.

Ordenar por

Esta transformación ordenará cada cuadro por el campo configurado. Cuando reverse está marcada, los valores se devolverán en el orden opuesto.

Límite

Utilice esta transformación para limitar el número de filas que se muestran.

En el siguiente ejemplo, tenemos la siguiente respuesta de la fuente de datos:

Este es el resultado después de añadir una transformación de límite con un valor de '3':