Transformaciones

Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana.

Para ver los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte. Trabajando en Grafana versión 10

Para ver los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte. Trabajando en Grafana versión 9

Las transformaciones procesan el conjunto de resultados antes de pasarlo a la visualización. Puede acceder a las transformaciones en la pestaña Transformar del editor de paneles de Amazon Managed Grafana.

Puede utilizar las transformaciones para cambiar el nombre de los campos, unir series temporales independientes, realizar operaciones matemáticas en todas las consultas y mucho más. Si tienes paneles grandes o consultas pesadas, poder reutilizar el resultado de la consulta de un panel a otro puede suponer un gran aumento de rendimiento.

nota

A veces, las transformaciones dan como resultado datos que no se pueden representar gráficamente. Cuando eso ocurre, Amazon Managed Grafana muestra una sugerencia en la visualización. Elija la sugerencia para cambiar a la visualización de tablas. A menudo, esto le ayuda a comprender mejor lo que la transformación está haciendo con sus datos.

Amazon Managed Grafana aplica las transformaciones en el orden en que aparecen en la pantalla. Cada transformación crea un nuevo conjunto de resultados que se pasa a la siguiente transformación del proceso.

El orden puede marcar una gran diferencia en el aspecto de los resultados. Por ejemplo, si utiliza la transformación reducida para condensar todos los resultados de una columna en un único valor, solo podrá aplicar las transformaciones a ese único valor.

Requisitos previos 

Antes de aplicar las transformaciones, debe cumplirse todo lo siguiente:

• Ha introducido una consulta y ha devuelto datos de una fuente de datos. Para obtener más información sobre las consultas, consulte Consultas.

• Ha aplicado una visualización que admite consultas, como una de las siguientes visualizaciones:

  • Calibre de barras

  • Calibre

  • Gráfico

  • Mapa de calor

  • Registros

  • Stat

  • Tabla

Aplicar una transformación

Las transformaciones están disponibles en la pestaña Transformar del panel inferior del editor de paneles, junto a la pestaña Consultas.

Para aplicar una transformación

1. En el panel al que desee añadir las transformaciones, elija el título del panel y, a continuación, elija Editar.

2. Elija la pestaña Transform (Transformación).

3. Seleccione una transformación.

   En la fila de transformación que aparece, puede configurar las opciones de transformación.

4. Para aplicar otra transformación, elija Añadir transformación. Tenga en cuenta que la siguiente transformación actúa sobre el conjunto de resultados devuelto por la transformación anterior.

Si tienes problemas, selecciona el icono de error para depurar las transformaciones.

Para eliminar una transformación, elige el icono de la papelera.

Tipos y opciones de transformación

Los espacios de trabajo de Grafana incluyen las siguientes transformaciones.

Reducir

Aplique la transformación Reduce cuando desee simplificar sus resultados hasta reducirlos a un solo valor. Reducir básicamente elimina el componente de tiempo. Si se visualiza como una tabla, reduce una columna a una fila (valor).

En el campo Cálculos, introduzca uno o más tipos de cálculo. Seleccione ver una lista de las opciones de cálculo. Para obtener información sobre los cálculos disponibles, consulteLista de cálculos.

Tras seleccionar al menos un cálculo, Amazon Managed Grafana mostrará un valor utilizando el cálculo que haya seleccionado. Si selecciona más de un cálculo, se mostrará más de un valor.

Merge

Utilice esta transformación para combinar los resultados 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, dos consultas devuelven datos de la tabla. Los datos se visualizan como dos tablas independientes antes de aplicar la transformación.

Consulta A

Tiempo	Trabajo	Tiempo de actividad
2020-07-07 11:34:20	nodo	25260122
2020-07-07 11:24:20	postgre	123001233

Consulta B

Tiempo	Trabajo	Errores
2020-07-07 11:34:20	nodo	15
2020-07-07 11:24:20	postgre	5

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

Tiempo	Trabajo	Errores	Tiempo de actividad
2020-07-07 11:34:20	nodo	15	25260122
2020-07-07 11:24:20	postgre	5	123001233

Filtre por nombre

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

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

Puede aplicar filtros de dos maneras:

• Introduzca una expresión regular.

• Elija un campo para activar y desactivar el filtrado de ese campo. Los campos filtrados se muestran con texto gris oscuro, los campos sin filtrar tienen texto blanco.

Filtra los datos por consulta

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

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

Organice los campos

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

nota

Esta transformación solo funciona en los paneles que tienen una única consulta. Si su panel tiene varias consultas, debe aplicar una transformación de unión por campo (combinación externa) o eliminar las consultas adicionales.

Amazon Managed Grafana muestra una lista de los campos devueltos por la consulta. Puede realizar cualquiera de los siguientes cambios:

• Cambie el orden de los campos haciendo una pausa sobre un campo. El cursor se convierte en una mano y, a continuación, puede arrastrar el campo a su nueva ubicación.

• Para ocultar o mostrar un campo, selecciona el icono en forma de ojo situado junto al nombre del campo.

• Cambie el nombre de los campos escribiendo un nombre nuevo en el cuadro Cambiar nombre.

Unir por campo (unión externa)

Utilice esta transformación para unir varias series temporales a partir de un conjunto de resultados por campo.

Esta transformación resulta útil si desea combinar consultas para poder calcular los resultados de los campos.

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

• Modo: seleccione un modo:

  • Reducir fila: aplique el cálculo seleccionado en cada fila de campos seleccionados de forma independiente.

  • Opción binaria: aplique una operación matemática básica (summultiply,, etc.) a los valores de una sola fila de dos campos seleccionados.

• Nombre de campo: seleccione los nombres de los campos que desee usar en el cálculo del nuevo campo.

• Cálculo: selecciona un cálculo para usarlo cuando Amazon Managed Grafana cree el nuevo campo. Seleccione el campo para ver una lista de opciones de cálculo. Para obtener información sobre los cálculos disponibles, consulteLista de cálculos.

• Alias: (opcional) Introduzca el nombre del nuevo campo. Si lo deja en blanco, el nombre del campo se asignará para que coincida con el cálculo.

• Reemplazar todos los campos: (opcional) Utilice esta opción si desea ocultar todos los demás campos y mostrar solo el campo calculado en la visualización.

Etiquetas de los campos

nota

Para aplicar esta transformación, la consulta debe devolver campos etiquetados.

Al seleccionar esta transformación, Amazon Managed Grafana transforma automáticamente todos los datos etiquetados en campos.

Por ejemplo, considere el resultado de una consulta de dos series temporales.

1: etiquetas Servidor = Servidor A, Centro de datos = UE 2: etiquetas Servidor = Servidor B, Centro de datos = UE

Esta transformación daría como resultado la siguiente tabla.

Tiempo	Server	Datacenter	Valor
2020-07-07 11:34:20	Servidor A	UE	1
2020-07-07 11:34:20	Servidor B	UE	2

Nombre del campo de valor; si lo seleccionó Server como nombre del campo de valor, obtendrá un campo por cada valor de la Server etiqueta.

Tiempo	Datacenter	Servidor A	Servidor B
2020-07-07 11:34:20	UE	1	2

Agrupar por

Esta transformación ordena cada fotograma por el campo configurado. Cuando reverse está marcada, los valores se devuelven en el orden opuesto.

Agrupar por

Esta transformación agrupa los datos por un valor de campo (columna) específico y procesa los cálculos de cada grupo. Los cálculos disponibles son los mismos que para la transformación Reduce.

A continuación, se muestra un ejemplo de datos originales.

Tiempo	Server ID	Temperatura de la CPU	Estado del servidor
2020-07-07 11:34:20	servidor 1	80	Shutdown
2020-07-07 11:34:20	servidor 3	62	OK (Correcto)
2020-07-07 10:32:20	servidor 2	90	Sobrecarga
2020-07-07 10:31:22	servidor 3	55	OK (Correcto)
2020-07-07 09:30:57	servidor 3	62	Rebooting
2020-07-07 09:30:05	servidor 2	88	OK (Correcto)
2020-07-07 09:28:06	servidor 1	80	OK (Correcto)
2020-07-07 09:25:05	servidor 2	88	OK (Correcto)
2020-07-07 09:23:07	servidor 1	86	OK (Correcto)

Esta transformación consta de dos pasos. En primer lugar, debe especificar 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 agrupa por Server ID campo, agrupará los datos de esta manera:

Tiempo	Server ID	Temperatura de la CPU	Estado del servidor
2020-07-07 11:34:20	servidor 1	80	Shutdown
2020-07-07 09:28:06	servidor 1	80	OK (Correcto)
2020-07-07 09:23:07	servidor 1	86	OK (Correcto)

2020-07-07 10:32:20 | server 2 | 90 | Overload
2020-07-07 09:30:05 | server 2 | 88 | OK
2020-07-07 09:25:05 | server 2 | 88 | OK

2020-07-07 11:34:20 | server 3 | 62 | OK
2020-07-07 10:31:22 | server 3 | 55 | OK
2020-07-07 09:30:57 | server 3 | 62 | Rebooting

Todas las filas con el mismo valor de Server ID 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 el cálculo se aplicará a cada grupo de filas. Por ejemplo, es posible que desee calcular el promedio CPU temperature de cada uno de esos servidores. Puede añadir el cálculo medio aplicado en el CPU Temperature campo para obtener lo siguiente.

Server ID	Temperatura de la CPU (media)
servidor 1	82
servidor 2	8.6
servidor 3	59.6

Y puedes añadir más de uno de esos cálculos. Por ejemplo, puede utilizar los siguientes cálculos.

• Para el campoTime, puede calcular el último valor para saber cuándo se recibió el último punto de datos de cada servidor.

• Para el campoServer Status, puede calcular el último valor para conocer el último valor de estado de cada servidor.

• Para el campoTemperature, también puede calcular el último valor para conocer la última temperatura monitorizada de cada servidor.

La transformación Agrupar por produce los siguientes resultados.

Server ID	Temperatura de la CPU (media)	Temperatura de la CPU (última)	Hora (última)	Estado del servidor (último)
servidor 1	82	80	2020-07-07 11:34:20	Shutdown
servidor 2	8.6	90	2020-07-07 10:32:20	Sobrecarga
servidor 3	59.6	62	2020-07-07 11:34:20	OK (Correcto)

Con esta transformación, puede extraer cierta información clave de su serie temporal y mostrarla de forma cómoda.

De series a filas

Utilice esta transformación para combinar los resultados 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: TimeMetric, yValue. La Metric columna se agrega para que pueda ver de qué consulta se origina la métrica. Personalice este valor definiéndolo Label en la consulta de origen.

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

Consulta A

Tiempo	Temperatura
2020-07-07 11:34:20	25
2020-07-07 10:31:22	22
2020-07-07 09:30:05	19

Consulta B

Tiempo	Humedad
2020-07-07 11:34:20	24
2020-07-07 10:32:20	29
2020-07-07 09:30:57	33

Al aplicar la transformación se obtienen los siguientes resultados. Series to rows

Tiempo	Métrica	Valor
2020-07-07 11:34:20	Temperatura	25
2020-07-07 11:34:20	Humedad	22
2020-07-07 10:32:20	Humedad	29
2020-07-07 10:31:22	Temperatura	22
2020-07-07 09:30:57	Humedad	33
2020-07-07 09:30:05	Temperatura	19

Filtrar datos por valor

Esta transformación le permite filtrar sus datos directamente en el espacio de trabajo de 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 siguientes:

• Regex: coincide con una expresión regular.

• Es nulo: coincide si el valor es nulo.

• No es nulo: coincide si el valor no es nulo.

• Igual: coincide si el valor es igual al valor especificado.

• Diferente: coincide si el valor es diferente al valor especificado.

Las condiciones disponibles para los campos numéricos son las siguientes:

• Mayor: coincide si el valor es mayor que el valor especificado.

• Inferior: coincide si el valor es inferior al valor especificado.

• Mayor o igual: coincide si el valor es mayor o igual al valor especificado.

• Menor o igual: coincide si el valor es inferior o igual al valor especificado.

• Rango: haga coincidir un rango entre un mínimo y un máximo especificados. El mínimo y el máximo se incluyen en el rango.

Puede añadir más de una condición al filtro. Si tiene más de una condición, puede elegir si desea que la acción de incluir o excluir se aplique en las filas que cumplan todas o alguna de las condiciones que agregó.

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

Depure las transformaciones

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

Amazon Managed Grafana muestra la vista de depuración de transformaciones debajo de la fila de transformaciones.