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.
# Paneles y visualizaciones en la versión 10 de Grafana
****
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).
El *panel* es el componente básico de visualización en Grafana. Cada panel tiene un editor de consultas específico para el origen de datos seleccionado en el panel. El editor de consultas le permite crear una consulta que devuelva los datos que desea visualizar.
Hay una amplia variedad de opciones de estilo y formato para cada panel. Los paneles se pueden arrastrar, soltar y cambiar de tamaño para reorganizarlos en el panel de control.
Antes de agregar un panel, asegúrese de haber configurado un origen de datos.
Es posible que haya más tipos de paneles disponibles si instala [complementos](grafana-plugins.md) adicionales en su espacio de trabajo.
Para obtener detalles sobre el uso de orígenes de datos específicos, consulte [Conexión con orígenes de datos](AMG-data-sources.md).
**Topics**
+ [Información general del editor de paneles](v10-panels-editor-overview.md)
+ [Vista de inspección del panel](v10-panels-panel-inspector.md)
+ [Consulta y transformación de los datos](v10-panels-query-xform.md)
+ [Configuración de opciones del panel](v10-panels-configure-panel-options.md)
+ [Configuración de opciones estándar](v10-panels-configure-standard-options.md)
+ [Configuración de una leyenda](v10-panels-configure-legend.md)
+ [Configuración de enlaces de datos](v10-panels-configure-data-links.md)
+ [Configuración de asignaciones de valores](v10-panels-configure-value-mappings.md)
+ [Configuración de umbrales](v10-panels-configure-thresholds.md)
+ [Configuración de anulaciones de campos](v10-panels-configure-overrides.md)
+ [Visualizaciones disponibles en la versión 10 de Grafana](v10-panels-viz.md)
# Información general del editor de paneles
****
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).
En el editor de paneles, puede actualizar todos los elementos de una visualización, incluido el origen de datos, las consultas, el intervalo de tiempo y las opciones de visualización.
Para agregar un panel a un panel de control nuevo, seleccione **\$1 Agregar visualización** en el centro del panel de control. Para agregar un panel a un panel de control existente, seleccione **Agregar** en el encabezado del panel de control y seleccione **Visualización** en el menú desplegable. También puede copiar y pegar un panel existente desde el mismo panel de control o desde uno diferente.
## Menú del panel
Para acceder al editor de paneles, pase el ratón por encima de la esquina superior derecha de cualquier panel. Seleccione el icono del menú del panel que aparece y seleccione **Editar**.
El menú del panel también le permite acceder a las siguientes acciones:
+ **Ver**: permite ver el panel en pantalla completa.
+ **Editar**: abra el editor de paneles para editar el panel y las opciones de visualización.
+ **Compartir**: comparta el panel como un enlace o panel de biblioteca.
+ **Explore**: abra el panel en **Explore**, donde podrá centrarse en la consulta.
+ **Inspeccionar**: abra el panel de **inspección**, donde puede revisar los datos del panel, las estadísticas, los metadatos, el JSON y la consulta.
+ **Datos**: abra el panel **Inspeccionar** en la pestaña **Datos**.
+ **Consulta**: abra el panel **Inspeccionar** en la pestaña **Consulta**.
+ **JSON del panel**: abra el panel **Inspección** en la pestaña **JSON**.
+ **Extensiones**: acceda a otras acciones proporcionadas por las aplicaciones instaladas, como la declaración de un incidente. Esta opción solo aparece si tiene instalados complementos de aplicaciones que contribuyan con una extensión al menú del panel.
+ **Más**: acceda a otras acciones del panel.
+ **Duplicar**: haga una copia del panel. Los paneles duplicados consultan los datos por separado del panel original. Si desea utilizar los mismos resultados de la consulta, puede utilizar el origen de datos `Dashboard` del segundo panel.
+ **Copiar**: copie el panel en el portapapeles.
+ **Crear panel de biblioteca**: cree un panel que se pueda importar a otros paneles de control.
+ **Crear alerta**: abra la página de configuración de reglas de alerta en **Alertas**, donde puede crear una [alerta gestionada por Grafana](v10-alerts.md) en función de las consultas del panel.
+ **Ocultar leyenda**: oculte la leyenda del panel.
+ **Obtener ayuda**: envíe una instantánea o los datos del panel al Soporte técnico de Grafana Labs.
+ **Eliminar**: retire el panel del panel de control.
## Editor de paneles
En esta sección se describen las áreas del editor de paneles de Grafana.
+ Encabezado del panel: la sección de encabezado muestra el panel de control en el que aparece el panel y los siguientes controles:
+ **Descartar**: descarta los cambios que haya hecho en el panel desde la última vez que guardó el panel de control.
+ **Guardar**: guarda los cambios que haya hecho en el panel.
+ **Aplicar**: aplique los cambios que haya hecho y, a continuación, cierra el editor de paneles y vuelve al panel de control. Tendrá que guardar el panel de control para conservar los cambios aplicados.
+ Vista previa de la visualización: la sección de vista previa de la visualización contiene las siguientes opciones:
+ **Vista de tabla**: convierte cualquier visualización en una tabla para poder ver los datos. Las vistas de tabla son útiles para solucionar problemas. Esta vista solo contiene los datos sin procesar. No incluye las transformaciones que pueda haber aplicado a los datos ni las opciones de formato disponibles en la visualización de la [tabla](v10-panels-table.md).
+ **Rellenar**: la vista previa de la visualización llena el espacio disponible. Si cambia el ancho del panel lateral o la altura del panel inferior, la visualización cambia para llenar cualquier espacio disponible.
+ **Real**: la vista previa de la visualización tiene el tamaño exacto del panel de control. Si no hay suficiente espacio disponible, la visualización se reducirá verticalmente y se conservará la relación de aspecto.
+ **Controles de intervalo de tiempo**: el **valor predeterminado** es la zona horaria local del navegador o la zona horaria seleccionada en un nivel superior.
+ Sección de datos: la sección de datos contiene pestañas en las que puede ingresar consultas, transformar los datos y crear reglas de alerta (si procede).
+ **Pestaña Consulta**: seleccione su origen de datos e ingrese las consultas aquí. Para obtener más información, consulte [Consulta y transformación de los datos](v10-panels-query-xform.md). Al crear inicialmente un panel de control, se le solicitará que seleccione un origen de datos. Puede actualizar el origen de datos o la consulta en esta pestaña.
+ **Pestaña Transformar**: aplique transformaciones de datos. Para obtener más información, consulte [Consulta y transformación de los datos](v10-panels-query-xform.md).
+ **Pestaña Alerta**: escriba reglas de alerta. Para obtener más información, consulte [Alertas en la versión 10 de Grafana](v10-alerts.md).
+ Opciones de visualización del panel: la sección de opciones de visualización contiene pestañas en las que puede configurar casi todos los aspectos de la visualización de datos. Los detalles varían según el tipo de visualización seleccionado.
## Panel de inspección de paneles
El panel de inspección le ayuda a entender los paneles y a solucionar sus problemas. Puede ver los datos sin procesar de cualquier panel, exportarlos a un archivo de valores separados por comas (CSV), ver las solicitudes de consulta y exportar los paneles y los datos a JSON.
**nota**
No todos los tipos de paneles incluyen todas las pestañas. Por ejemplo, los paneles de listas de paneles no tienen datos sin procesar para inspeccionar, por lo que no muestran las pestañas Estadísticas, Datos ni Consulta.
El inspector de paneles consta de las opciones siguientes:
+ El panel de inspección del panel se muestra como un panel en el lado derecho. Seleccione la flecha de la esquina superior derecha para ampliar o reducir el panel del panel.
+ **Pestaña Datos**: muestra los datos sin procesar devueltos por la consulta con las transformaciones aplicadas. Las opciones de campo, como las anulaciones y las asignaciones de valores, no se aplican de forma predeterminada.
+ **Pestaña Estadísticas**: muestra cuánto tiempo tarda la consulta y cuánto devuelve.
+ **Pestaña JSON**: permite ver y copiar el JSON del panel, el JSON de los datos del panel y el JSON de la estructura del marco de datos. Resulta útil si está aprovisionando o administrando Grafana.
+ **Pestaña Consulta**: muestra las solicitudes al servidor que se envían cuando Grafana consulta el origen de datos.
+ **Pestaña Error**: muestra los errores devueltos por una consulta. La pestaña solo está visible cuando una consulta devuelve un error.
# Vista de inspección del panel
****
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).
La vista de inspección del panel, que puede abrir a través del menú del panel, le ayuda a comprender los paneles y a solucionar sus problemas. Puede inspeccionar los datos sin procesar de cualquier panel de Amazon Managed Grafana, exportarlos a un archivo de valores separados por comas (CSV), ver las solicitudes de consulta y exportar los paneles y los datos a JSON.
**nota**
No todos los tipos de paneles incluyen todas las pestañas. Por ejemplo, los paneles de listas de paneles no tienen datos sin procesar para inspeccionar, por lo que no muestran las pestañas Estadísticas, Datos ni Consulta.
El inspector de paneles consta de las opciones siguientes:
1. El inspector de paneles muestra **Inspeccionar:** en la parte superior del panel. Seleccione la flecha de la esquina superior derecha para ampliar o reducir el panel.
1. **Pestaña Datos**: muestra los datos sin procesar devueltos por la consulta con las transformaciones aplicadas. Las opciones de campo, como las anulaciones y las asignaciones de valores, no se aplican de forma predeterminada.
1. **Pestaña Estadísticas**: muestra cuánto tiempo tarda la consulta y cuánto devuelve.
1. **Pestaña JSON**: permite ver y copiar el JSON del panel, el JSON de los datos del panel y el JSON de la estructura del marco de datos. Resulta útil si está aprovisionando o administrando Grafana.
1. **Pestaña Consulta**: muestra las solicitudes al servidor que se envían cuando Grafana consulta el origen de datos.
1. **Pestaña Error**: muestra los errores. Solo está visible cuando la consulta devuelve un error.
## Descarga de los resultados de las consultas sin procesar
Amazon Managed Grafana genera un archivo CSV que contiene sus datos, incluida cualquier transformación de esos datos. Puede elegir ver los datos antes o después de que el panel aplique las opciones de campo o las anule.
**Descarga de resultados de la consulta sin procesar**
1. Edite el panel que contiene los datos de las consultas que desea descargar.
1. En el editor de consultas, seleccione **Inspector de consultas**.
1. Seleccionar **Datos**.
Si su panel contiene varias consultas o consulta varios nodos, tiene opciones adicionales.
+ **Seleccionar resultado**: elija los datos del conjunto de resultados que desea ver.
+ **Transformación de datos**
+ **Unir por tiempo:** vea los datos sin procesar de todas sus consultas a la vez, un conjunto de resultados por columna. Seleccione un encabezado de columna para reordenar los datos.
1. Para ver los datos antes de que el sistema aplique las anulaciones en los campos, seleccione la opción **Datos formateados**.
1. Para descargar un archivo CSV con un formato específico para Excel, seleccione la opción **Descargar para Excel**.
1. Seleccione **Download CSV (Descargar CSV)**.
## Inspección del rendimiento de las consultas
En la pestaña **Estadísticas** se muestran estadísticas que indican cuánto tiempo tarda la consulta, cuántas consultas envía y el número de filas devueltas. Esta información puede ayudarlo a solucionar los problemas de las consultas, especialmente si alguno de los números es inesperadamente alto o bajo.
**Inspección del rendimiento de consultas**
1. Edite el panel que contiene la consulta con el rendimiento que desea inspeccionar.
1. En el editor de consultas, seleccione **Inspector de consultas**.
1. Seleccione **Estadísticas**.
Las estadísticas se muestran en formato de solo lectura.
## Inspección de la solicitud y respuesta a la consulta
Puede inspeccionar los datos de solicitud y respuesta de la consulta cuando desee solucionar un problema de una consulta que arroje resultados inesperados o que no devuelva los resultados esperados.
1. Edite el panel que contiene la consulta que desea exportar.
1. En el editor de consultas, seleccione **Inspector de consultas**.
1. Seleccione **Actualizar**.
El panel se rellena con los datos de respuesta.
1. Haga los ajustes necesarios y, a continuación, vuelva a ejecutar la consulta.
1. Para descargar los datos de solicitud y respuesta de la consulta, haga clic en el icono **Copiar al portapapeles** y pegue los resultados en otra aplicación.
# Consulta y transformación de los datos
****
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).
Amazon Managed Grafana admite muchos tipos de [orígenes de datos](AMG-data-sources.md). Las *consultas* a los orígenes de datos devuelven datos que Grafana puede *transformar* y visualizar. Cada origen de datos usa su propio lenguaje de consulta, y cada uno de los complementos de orígenes de datos implementa una interfaz de usuario para generar consultas llamada editor de consultas.
**Topics**
+ [Acerca de las consultas](#v10-panels-query-xform-about)
+ [Navegación por la pestaña de consultas](#v10-panels-query-xform-navigate)
+ [Adición de una consulta](#v10-panels-query-xform-add)
+ [Administración de consultas](#v10-panels-query-xform-manage)
+ [Opciones de consulta](#v10-panels-query-xform-options)
+ [Escritura de consultas de expresiones](v10-panels-query-xform-expressions.md)
+ [Uso compartido de los resultados de las consultas con otro panel](v10-panels-query-share.md)
+ [Transformación de datos](v10-panels-xform.md)
+ [Solución de problemas de consultas](v10-panels-query-troubleshoot.md)
+ [Tipos de cálculo](v10-panels-calculation-types.md)
## Acerca de las consultas
Los paneles de Grafana se comunican con los orígenes de datos mediante consultas, que recuperan datos para la visualización. Una consulta es una pregunta escrita en el lenguaje de consulta utilizado por el origen de datos.
Puede configurar la frecuencia de las consultas y los límites de recopilación de datos en las opciones de orígenes de datos del panel. Grafana admite hasta 26 consultas por panel.
Puede encontrar más información sobre el lenguaje de consulta de cada origen de datos en la sección [Orígenes de datos](AMG-data-sources.md).
**Editores de consultas**
El *editor de consultas* de cada origen de datos proporciona una interfaz de usuario personalizada que le ayuda a escribir consultas que aprovechen sus capacidades únicas.
Debido a las diferencias entre los lenguajes de consulta, cada editor de consultas de orígenes de datos tiene un aspecto y un funcionamiento diferentes. Según el origen de datos, el editor de consultas puede proporcionar características de autocompletado, nombres de métricas, sugerencias de variables o una interfaz visual de creación de consultas.
Para obtener más información sobre las características exclusivas del editor de consultas de un origen de datos específico, incluida información sobre las consultas y la sintaxis, consulte la documentación del origen de datos:
+ Para ver los orígenes de datos incluidos en Amazon Managed Grafana, consulte [Orígenes de datos integrados](AMG-data-sources-builtin.md).
+ Para ver los orígenes de datos incluidos en Grafana Enterprise, consulte [Conexión con orígenes de datos de Enterprise](AMG-data-sources-enterprise.md).
+ Para otros complementos de orígenes de datos que se instalan a través de [Búsqueda de complementos con el catálogo de complementos](grafana-plugins.md#plugin-catalog), la documentación está vinculada a la lista del catálogo de complementos.
**Sintaxis de la consulta**
Los orígenes de datos utilizan diferentes lenguajes de consulta para solicitar datos. Para obtener más información sobre el lenguaje de consulta exclusivo de un origen de datos específico, consulte su documentación.
**Ejemplo de PostgreSQL:**
```
SELECT hostname FROM host WHERE region IN($region)
```
**Ejemplo de PromQL:**
```
query_result(max_over_time([${__range_s}s]) != )
```
**Orígenes de datos especiales**
Grafana también incluye tres orígenes de datos especiales: **Grafana**, **Mixto** y **Panel de control**. Para obtener más información, consulte [Conexión con orígenes de datos](AMG-data-sources.md).
## Navegación por la pestaña de consultas
La pestaña **Consulta** de un panel consta de los siguientes elementos:
+ **Selector de orígenes de datos**: seleccione el origen de datos que se va a consultar.
+ **Opciones de consulta**: establece los parámetros máximos de recuperación de datos y los intervalos de tiempo de ejecución de las consultas.
+ **Botón Inspector de consultas**: abre el panel de inspector de consultas, donde puede ver y optimizar la consulta.
+ **Lista de editores de consultas**: muestra las consultas que ha escrito.
+ **Expresiones**: utiliza el generador de expresiones para crear expresiones de alerta. Para obtener más información sobre las expresiones, consulte [Escritura de consultas de expresiones](v10-panels-query-xform-expressions.md).
## Adición de una consulta
Una consulta devuelve datos que Grafana visualiza en los paneles del panel de control. Al crear un panel, Grafana selecciona automáticamente el origen de datos predeterminado.
**Adición de una consulta**
1. Edite el panel al que va a agregar una consulta.
1. Elija la pestaña **Queries** (Consultas).
1. Seleccione el menú desplegable **Origen de datos** y seleccione un origen de datos.
1. Elija **opciones de consulta** para configurar el número máximo de puntos de datos que necesita. Para obtener más información sobre las opciones de consulta, consulte [Opciones de consulta](#v10-panels-query-xform-options).
1. En el editor de consultas, escriba la consulta.
1. Seleccione **Aplicar**.
Grafana consulta el origen de datos y visualiza los datos.
## Administración de consultas
Grafana organiza las consultas en filas de consultas plegables. Cada fila de consulta contiene un editor de consultas y se identifica con una letra (A, B, C, etc.).
Para administrar las consultas, puede copiarlas, ocultarlas, eliminarlas, reordenarlas y activar la ayuda del editor de consultas.
## Opciones de consulta
Seleccione **Opciones de consulta** junto al selector de orígenes de datos para ver la configuración del origen de datos seleccionado. Los cambios que haga aquí solo afectarán a las consultas efectuadas en este panel.
Grafana establece valores predeterminados que se muestran en texto gris oscuro. Los cambios se muestran en texto blanco. Para devolver un campo a la configuración predeterminada, elimine el texto blanco del campo.
Las opciones de consulta de orígenes de datos del panel incluyen las siguientes:
+ **Máximo de puntos de datos**: si el origen de datos lo admite, se establece el número máximo de puntos de datos para cada serie devuelta. Si la consulta devuelve más puntos de datos que la configuración de puntos de datos máximos, el origen de datos reduce el número de puntos devueltos al agregarlos por promedio, máximo u otra función.
Puede limitar el número de puntos para mejorar el rendimiento de la consulta o suavizar la línea visualizada. El valor predeterminado es el ancho (o el número de píxeles) del gráfico, ya que solo puede visualizar tantos puntos de datos como el espacio disponible en el panel del gráfico.
Con los datos de streaming, Grafana utiliza el valor máximo de puntos de datos para el búfer móvil. La transmisión es un flujo continuo de datos y el almacenamiento en búfer divide la transmisión en partes.
+ **Intervalo mínimo**: establece un límite mínimo para el intervalo que se calcula automáticamente, que suele ser el intervalo mínimo de almacenamiento. Si se guarda un punto de datos cada 15 segundos, no se beneficiará de tener un intervalo inferior a ese. También puede establecerlo en un intervalo mínimo superior al intervalo de extracción para recuperar consultas más detalladas y que funcionen bien.
+ **Intervalo**: establece un intervalo de tiempo que puede utilizar para agregar o agrupar puntos de datos por tiempo.
Grafana calcula automáticamente un intervalo apropiado que puede usar como variable en las consultas con plantillas. La variable se mide en segundos (`$__interval`) o milisegundos (`$__interval_ms`).
Los intervalos se utilizan normalmente en funciones de agregación, como la suma o el promedio. Por ejemplo, esta es una consulta de Prometheus que usa la variable de intervalo: `rate(http_requests_total[$__interval])`.
Este intervalo automático se calcula en función del ancho del gráfico. A medida que el usuario se aleja de una visualización, el intervalo aumenta, lo que da como resultado una agregación más gruesa. Del mismo modo, si el usuario amplía la imagen, el intervalo disminuye, lo que da como resultado una agregación más detallada.
Para obtener más información, consulte [Variables globales](v10-dash-variable-add.md#v10-dash-variable-add-global).
+ **Tiempo relativo**: anula el intervalo de tiempo relativo de los paneles individuales, lo que hace que sean diferentes de lo que está seleccionado en el selector de tiempo del panel de control, en la esquina superior derecha del panel de control. Puede usarlo para mostrar métricas de diferentes períodos de tiempo o días en el mismo panel de control.
**nota**
Las anulaciones de tiempo del panel no tienen efecto cuando el intervalo de tiempo del panel de control es absoluto.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/v10-panels-query-xform.html)
+ **Cambio de hora**: anula el intervalo de tiempo de los paneles individuales mediante el cambio del inicio y el final en relación con el selector de tiempo. Por ejemplo, puede cambiar el intervalo de tiempo del panel para que esté dos horas antes que el selector de tiempo del panel de control.
**nota**
Las anulaciones de tiempo del panel no tienen efecto cuando el intervalo de tiempo del panel de control es absoluto.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/v10-panels-query-xform.html)
+ **Tiempo de espera de la caché**: *(visible solo si está disponible en el origen de datos)* anula el tiempo de espera de la caché predeterminado si el almacén de series temporales tiene una caché de consultas. Especifique este valor como un valor numérico en segundos.
# Escritura de consultas de expresiones
****
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).
Las expresiones del lado del servidor permiten manipular los datos devueltos por las consultas mediante operaciones matemáticas y de otro tipo. Las expresiones crean datos nuevos y no manipulan los datos devueltos por los orígenes de datos.
## Acerca de las expresiones
Las expresiones del lado del servidor permiten manipular los datos devueltos por las consultas mediante operaciones matemáticas y de otro tipo. Las expresiones crean datos nuevos y no manipulan los datos devueltos por los orígenes de datos, aparte de llevar a cabo una pequeña reestructuración de los datos para convertirlos en una entrada aceptable para las expresiones.
**Uso de expresiones**
Las expresiones son las más utilizadas por [Grafana Alerting](v10-alerts.md). El procesamiento se efectúa en el servidor, por lo que las expresiones pueden funcionar sin una sesión de navegador. Sin embargo, las expresiones también se pueden usar con visualizaciones y orígenes de datos de backend.
**nota**
Las expresiones no funcionan con las alertas de los paneles antiguos.
Las expresiones están diseñadas para aumentar los orígenes de datos, ya que permiten combinar consultas de diferentes orígenes de datos o proporcionan operaciones que no están disponibles en un origen de datos.
**nota**
Siempre que sea posible, debe procesar los datos dentro del origen de datos. Copiar datos del almacenamiento al servidor de Grafana para su procesamiento es ineficiente, por lo que las expresiones están destinadas a un procesamiento de datos ligero.
Las expresiones funcionan con consultas de orígenes de datos que devuelven series temporales o datos numéricos. También funcionan con [datos multidimensionales](getting-started-grafanaui.md#time-series-dimensions). Por ejemplo, una consulta que devuelve varias series, donde cada serie se identifica mediante etiquetas.
Una expresión individual toma una o más consultas u otras expresiones como entrada y agrega datos al resultado. Cada expresión o consulta individual se representa mediante una variable que es un identificador denominado RefID (por ejemplo, la letra `A` o `B` por defecto).
Para hacer referencia al resultado de una expresión individual o a una consulta de origen de datos en otra expresión, este identificador se utiliza como variable.
**Tipos de expresiones**
Las expresiones funcionan con dos tipos de datos.
+ Una colección de series temporales.
+ Una colección de números, donde cada número es un elemento.
Cada colección se devuelve a partir de una única consulta o expresión de origen de datos y se representa mediante el RefID. Cada colección es un conjunto, en el que cada elemento del conjunto se identifica de forma única por sus dimensiones, que se almacenan como [etiquetas](getting-started-grafanaui.md#labels) o pares clave-valor.
**Consultas al origen de datos**
Las expresiones del lado del servidor solo admiten consultas de orígenes de datos para orígenes de datos de backend. Por lo general, se supone que los datos están etiquetados como datos de serie temporal.
Las consultas al origen de datos, cuando se utilizan con expresiones, las ejecuta el motor de expresiones. Cuando lo hace, reestructura los datos para que sean una serie temporal o un número por marco de datos. Por ejemplo, si utiliza un origen de datos que devuelve varias series en un fotograma en la vista de tabla, puede que observe un aspecto diferente cuando se ejecuta con expresiones.
Actualmente, el único formato que no es de serie temporal (número) que se admite cuando se utilizan marcos de datos es si se tiene una respuesta de tabla que devuelve un marco de datos sin hora, columnas de cadenas y una columna numérica:
La siguiente tabla de ejemplo produce un número que funciona con expresiones. Las columnas de cadenas se convierten en etiquetas y la columna numérica en el valor correspondiente. Por ejemplo, `{"Loc": "MIA", "Host": "A"}` con un valor de 1.
| Loc | Host | Avg\$1CPU |
| --- | --- | --- |
| MIA | A | 1 |
| NYC | B | 2 |
**Operaciones**
Puede usar las siguientes operaciones en las expresiones: matemática, reducción y remuestreo.
**Matemático**
Las matemáticas son para fórmulas matemáticas de formato libre sobre series temporales o datos numéricos. Las operaciones matemáticas toman números y series temporales como entrada y los cambian por números y series temporales diferentes.
Se hace referencia a los datos de otras consultas o expresiones con el prefijo RefID con un signo de dólar, por ejemplo, `$A`. Si el nombre de la variable tiene espacios, puede usar una sintaxis de corchetes similar a la siguiente: `${my variable}`.
Las constantes numéricas pueden estar en decimal (`2.24`), octal (con un cero a la izquierda, como `072`) o hexadecimales (con un 0x a la izquierda, como `0x2A`). También se admiten exponenciales y signos (por ejemplo, `-0.8e-2`).
**Operadores**
Se admiten los operadores aritméticos (`+`, binarios y unarios `-`, `*`, `/`, `%`, exponentes `**`), relacionales (`<`, `>`, `==`, `!=`, `>=`, `<=`) y lógicos (`&&`, `||` y unarios `!`).
El comportamiento de la operación con los datos depende de si se trata de datos numéricos o de serie temporal.
En las operaciones binarias, como `$A + $B` o `$A || $B`, el operador se aplica de las siguientes maneras según el tipo de datos:
+ Si `$A` y `$B` son números, la operación se lleva a cabo entre los dos números.
+ Si una variable es un número y la otra es una serie temporal, se lleva a cabo la operación entre el valor de cada punto de la serie temporal y el número.
+ Si `$A` y `$B` son datos de serie temporal, la operación entre cada valor de las dos series se lleva a cabo para cada marca temporal que exista en `$A` y `$B`. La operación `Resample` se puede utilizar para alinear las marcas de tiempo.
Resumen:
+ Número número = número
+ Número serie = serie
+ Serie serie = serie
Como las expresiones funcionan con varias series o números representados por una sola variable, las operaciones binarias también llevan a cabo una unión entre las dos variables. Esto se hace en función de las etiquetas de identificación asociadas a cada serie o número individual.
Por lo tanto, si tiene números con etiquetas como `{host=web01}` en `$A` y otro número en `$B` con las mismas etiquetas, la operación se lleva a cabo entre esos dos elementos dentro de cada variable y el resultado compartirá las mismas etiquetas. Las reglas para el comportamiento de esta unión son las siguientes:
+ Un elemento sin etiquetas se unirá a cualquier cosa.
+ Si `$A` y `$B` contienen solo un elemento (una serie o un número), se unirán.
+ Si las etiquetas coinciden exactamente, se unirán.
+ Si las etiquetas son un subconjunto de las demás, por ejemplo, si un elemento `$A` está etiquetado como `{host=A,dc=MIA}` y otro elemento `$B` está etiquetado como `{host=A}`, se unirán.
+ Si dentro de una variable, como `$A`, hay diferentes claves de etiqueta para cada elemento, el comportamiento de unión no está definido.
Los operadores lógicos y relacionales devuelven 0 si es falso y 1 si es verdadero.
**Funciones matemáticas**
Si bien la mayoría de las funciones se encuentran en las propias operaciones de expresión, la operación matemática tiene algunas funciones similares a los símbolos u operadores matemáticos. Cuando las funciones pueden tomar números o series, se devolverá el mismo tipo que el argumento. Cuando se trata de una serie, la operación se lleva a cabo para el valor de cada punto de la serie.
*abs*
abs devuelve el valor absoluto de su argumento, que puede ser un número o una serie. Por ejemplo, `abs(-1)` o `abs($A)`.
*is\$1inf*
is\$1inf toma un número o una serie y devuelve `1` para valores `Inf` (negativos o positivos) y `0` para otros valores. Por ejemplo, `is_inf($A)`.
**nota**
Si tiene que comprobar específicamente el infinito negativo, por ejemplo, puede hacer una comparación, como `$A == infn()`.
*is\$1nan*
is\$1nan toma un número o una serie y devuelve `1` para valores `NaN` y `0` para otros valores. Por ejemplo, `is_nan($A)`. Esta función es necesaria para esta comprobación porque `NaN` no es igual a `NaN`.
*is\$1null*
is\$1null toma un número o una serie y devuelve `1` para valores `null` y `0` para otros valores. Por ejemplo, `is_null($A)`.
*is\$1number*
is\$1number toma un número o una serie y devuelve `1` para todos los valores numéricos reales y `0` para los demás valores (que son `null`, `Inf+`, `Inf-` y `NaN`). Por ejemplo, `is_number($A)`.
*log*
Log devuelve el logaritmo natural de su argumento, que puede ser un número o una serie. Si el valor es inferior a 0, se devuelve `NaN`. Por ejemplo, `log(-1)` o `log($A)`.
*inf, infn, nan y null*
Todas las funciones inf, infn, nan y null devuelven un único valor del nombre. Existen principalmente para efectuar pruebas. Ejemplo: `null()`.
*round*
Redondear devuelve un valor entero redondeado. Por ejemplo, `round(3.123)` o `round($A)`.
*ceil*
Ceil redondea el número al valor entero más cercano. Por ejemplo, `ceil(3.123)` devuelve `4`.
*floor*
Floor redondea el número al valor entero más cercano. Por ejemplo, `floor(3.123` devuelve `3`.
**Reducir**
Reduce toma una o más series temporales devueltas por una consulta o expresión y convierte cada serie en un único número. Las etiquetas de la serie temporal se mantienen como etiquetas en cada número reducido generado.
*Campos:*
+ **Función**: la función de reducción que se va a utilizar.
+ **Entrada**: la variable (refID, como `A`) que se va a volver a muestrear.
+ **Modo**: permite controlar el comportamiento de la función de reducción cuando una serie contiene valores no numéricos (nulo, NaN, \$1-Inf).
**Funciones de reducción**
*Recuento*
El recuento devuelve el número de puntos de cada serie.
*Mean*
La media devuelve el total de todos los valores de cada serie dividido por el número de puntos de esa serie. En el modo `strict`, si algún valor de la serie es nulo o NaN, o si la serie está vacía, se devuelve NaN.
*Min y Max*
Min y Max devuelven el valor más pequeño o más alto de la serie, respectivamente. En el modo `strict`, si algún valor de la serie es nulo o NaN, o si la serie está vacía, se devuelve NaN.
*Sum (Suma)*
La suma devuelve el total de todos los valores de la serie. Si la serie tiene una longitud cero, la suma será 0. En el modo `strict`, si algún valor de la serie es NaN o nulo, se devuelve NaN.
*Último*
Last devuelve el último número de la serie. Si la serie no tiene valores, devuelve NaN.
**Modos de reducción**
*Estricto*
En el modo estricto, la serie de entrada se procesa tal cual. Si algún valor de la serie no es numérico (null, NaN o \$1-Inf), se devuelve NaN.
*Eliminación de los valores no numéricos*
En este modo, todos los valores no numéricos (nulo, NaN o \$1-Inf) de la serie de entrada se filtran antes de ejecutar la función de reducción.
*Sustitución de los valores no numéricos*
En este modo, todos los valores no numéricos se sustituyen por un valor predefinido.
**Remuestreo**
Remuestreo cambia las marcas de tiempo de cada serie temporal para tener un intervalo de tiempo coherente. El caso de uso principal es volver a muestrear series temporales que no comparten las mismas marcas temporales para poder llevar a cabo operaciones matemáticas entre ellas. Para hacerlo, puede volver a muestrear cada una de las dos series y, a continuación, mediante una operación matemática que haga referencia a las variables remuestreadas.
*Campos:*
+ **Entrada**: la variable de los datos de serie temporal (refID, como `A`) que se va a volver a muestrear.
+ **Remuestreo** a: el tiempo que se va a volver a muestrear, por ejemplo, `10s`. Las unidades pueden ser `s` para segundos, `m` para minutos, `h` para horas, `d` para días, `w` para semanas y `y` para años.
+ **Reducción de muestreo**: función de reducción que se utiliza cuando hay más de un punto de datos por muestra de ventana. Consulte la operación de reducción para obtener detalles sobre el comportamiento.
+ **Aumento de muestreo**: el método que se utiliza para rellenar una muestra de ventana que no tiene puntos de datos.
+ **pad** se rellena con el último valor conocido.
+ **backfill** con el siguiente valor conocido.
+ **fillna** para llenar las ventanas de muestra vacías con NaNs
## Escritura de una expresión
Si el origen de datos las admite, Grafana muestra el botón **Expresión** y muestra todas las expresiones existentes en la lista del editor de consultas.
**Escritura de una expresión**
1. Abra el panel.
1. Debajo de la consulta, seleccione **Expresión**.
1. En el campo **Operación**, seleccione el tipo de expresión que desee escribir.
1. Escriba la expresión.
1. Seleccione **Aplicar**.
## Casos especiales
Cuando un origen de datos consultado no devuelve series ni números, el motor de expresiones devuelve `NoData`. Por ejemplo, si una solicitud contiene dos consultas de origen de datos que se combinan mediante una expresión, si `NoData` devuelve al menos una de las consultas de origen de datos, el resultado devuelto para toda la consulta es `NoData`. Para obtener más información sobre cómo Grafana Alerting procesa los resultados de `NoData`, consulte [Configuración de las reglas de alertas administradas por Grafana](v10-alerting-configure-grafanamanaged.md).
En el caso de utilizar una expresión en varias consultas, el motor de expresiones requiere que todas las consultas devuelvan una marca de tiempo idéntica. Por ejemplo, si se utilizan las matemáticas para combinar el resultado de varias consultas SQL que utilizan `SELECT NOW() AS "time"`, la expresión solo funcionará si todas las consultas dan como resultado `NOW()` para una marca de tiempo idéntica, lo que no siempre ocurre. Para resolver este problema, puede sustituir `NOW()` por una hora arbitraria, como `SELECT 1 AS "time"`, o por cualquier otra marca de tiempo válida de UNIX.
# Uso compartido de los resultados de las consultas con otro panel
****
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).
Grafana le permite usar el resultado de la consulta de un panel para cualquier otro panel del panel de control. Al compartir los resultados de las consultas en todos los paneles, se reduce la cantidad de consultas que se hacen al origen de datos, lo que puede mejorar el rendimiento del panel.
El origen de datos del *panel de control* le permite seleccionar un panel del panel de control que contenga las consultas con las que desea compartir los resultados. En lugar de enviar una consulta independiente para cada panel, Grafana envía una consulta y los demás paneles utilizan los resultados de la consulta para crear visualizaciones.
Esta estrategia puede reducir drásticamente la cantidad de consultas que se hacen cuando, por ejemplo, hay varios paneles que visualizan los mismos datos.
**Uso compartido de los resultados de las consultas**
1. [Cree un panel de control](v10-dash-creating.md).
1. Cambie el título a `Source panel`. Utilizará este panel como origen para los demás paneles.
1. Defina la consulta o consultas que desee compartir.
Si no tiene un origen de datos disponible, utilice el origen de datos de **Grafana**, que devuelve una serie temporal aleatoria que puede utilizar para hacer pruebas.
1. Agregue un segundo panel y seleccione el origen de datos del **panel de control** en el editor de consultas.
1. En **Usar los resultados de la lista de paneles**, seleccione el primer panel que haya creado.
Todas las consultas definidas en el panel de origen están ahora disponibles en el nuevo panel. Las consultas hechas en el panel de origen se pueden compartir en varios paneles.
Puede hacer clic en cualquiera de las consultas para ir al panel donde están definidas.
# Transformación de datos
****
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).
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 hacer lo siguiente:
+ Cambiar el nombre de un campo
+ Unir datos de serie temporal
+ Ejecutar operaciones matemáticas en las consultas
+ Uso de la salida de una transformación como entrada para otra transformación
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 la salida de una transformación como entrada para otra transformación, lo que se traduce en un aumento del rendimiento.
**nota**
A veces, el sistema no puede convertir en gráficos los datos transformados. Cuando eso suceda, haga clic en el conmutador **Vista de tabla** situado encima de la visualización para cambiar a una vista de tabla de los datos. Esto puede ayudarlo a entender el resultado final de sus transformaciones.
## Tipos de transformación
Grafana proporciona varias formas de transformar los datos. A continuación, encontrará una lista completa de las funciones de transformación.
## Orden de las transformaciones
Cuando existen varias transformaciones, Grafana las aplica en el orden en que aparecen en la lista. Cada transformación crea un conjunto de resultados que pasa a la siguiente transformación de la canalización de procesamiento.
El orden en que Grafana aplica las transformaciones afecta directamente a los resultados. Por ejemplo, si usa una transformación de Reducción para condensar todos los resultados de una columna en un único valor, después solo podrá aplicar las transformaciones a ese único valor.
## Adición de una función de transformación a los datos
Los siguientes pasos sirven de guía para agregar una transformación a los datos. Esta documentación no incluye los pasos para cada tipo de transformación.
**Adición de una transformación a un panel**
1. Vaya al panel en el que desea agregar una o más transformaciones.
1. Pase el ratón sobre cualquier parte del panel para mostrar el menú de acciones en la esquina superior derecha.
1. En el menú de acciones, elija **Editar**.
1. Seleccione la pestaña **Transformar**.
1. Seleccione una transformación. Aparece una fila de transformaciones en la que puede configurar las opciones de transformación.
1. Para aplicar otra transformación, elija **Agregar transformación**. Esta transformación actúa sobre el conjunto de resultados devuelto por la transformación anterior.
## Depuración de una transformación
Para ver los conjuntos de resultados de entrada y salida de la transformación, elija el icono de depuración (bicho) situado en la parte derecha de la fila de la transformación. Esto mostrará los datos de entrada y el resultado de la transformación como salida.
Los conjuntos de resultados de entrada y salida pueden ayudar a depurar una transformación.
## Deshabilitación de una transformación
Para deshabilitar u ocultar una transformación, seleccione el icono de mostrar (ojo) en la parte superior derecha de la fila de transformación. Esto desactiva las acciones aplicadas a esa transformación específica y puede ayudar a identificar problemas al cambiar varias transformaciones una tras otra.
## Filtrado de una transformación
Si la transformación usa más de una consulta, puede filtrarlas y aplicar la transformación seleccionada solo a una de ellas. Para hacerlo, elija el icono de filtro en la parte superior derecha de la fila de transformación. Se abrirá un menú desplegable con una lista de las consultas utilizadas en el panel. Desde aquí, puede seleccionar la consulta que quiere transformar.
También puede filtrar por anotaciones (incluidos los ejemplares) para aplicarles transformaciones. Al hacerlo, la lista de campos cambia para reflejar los que aparecen en la ayuda contextual de la anotación o del ejemplar.
El icono de filtro se muestra siempre si el panel tiene más de una consulta u origen de datos (es decir, datos de panel o anotación), pero es posible que no funcione si se aplican transformaciones anteriores para combinar los resultados de las consultas. Esto se debe a que cada transformación toma la salida de la anterior.
## Eliminación de 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 de control que se basan en la transformación e informe a los usuarios afectados.
**Eliminación de una transformación**
1. Abra un panel para editarlo.
1. Seleccione la pestaña **Transformar**.
1. Elija el icono de papelera situado al lado de la transformación que quiere eliminar.
# Funciones de transformación
****
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).
Puede llevar a cabo las siguientes transformaciones en sus datos.
## Adición de un campo a partir de un cálculo
Use esta transformación para agregar un campo nuevo calculado a partir de otros dos campos. Cada transformación le permite agregar un campo nuevo.
+ **Modo**: seleccione un modo.
+ **Reducir fila**: aplique el cálculo seleccionado en cada fila de campos seleccionados de forma independiente.
+ **Operación binaria**: permite aplicar operaciones binarias básicas (por ejemplo, sumar o multiplicar) a los valores de una sola fila de dos campos seleccionados.
+ **Operación unaria**: permite aplicar operaciones unarias básicas a los valores de una sola fila de un campo seleccionado. Las opciones disponibles son:
+ **Valor absoluto (abs)**: devuelve el valor absoluto de una expresión dada. Representa la distancia desde cero en forma de número positivo.
+ **Exponencial natural (exp)**: devuelve *e* elevado a la potencia de una expresión dada.
+ **Logaritmo natural (ln)**: devuelve el logaritmo natural de una expresión dada.
+ **Piso (floor)**: devuelve el número entero más grande menor o igual a una expresión dada.
+ **Techo (ceil)**: devuelve el número entero más pequeño mayor o igual que una expresión dada.
+ **Funciones acumulativas**: aplique funciones a la fila actual y a todas las filas anteriores.
+ **Total**: calcula el total acumulado hasta la fila actual, inclusive.
+ **Media**: calcula la media hasta la fila actual, incluida.
+ **Funciones de ventana**: permite aplicar funciones de ventana. La ventana puede estar *al final* o *centrada*. Cuando la ventana está al final, la fila actual será la última fila de la ventana. Cuando la ventana está centrada, la ventana se centrará en la fila actual. Cuando los tamaños sean homogéneos, la ventana se centrará entre la fila actual y la anterior.
+ **Media**: calcula la media variable o la media móvil.
+ ****: calcula la desviación estándar variable.
+ **Varianza**: calcula la varianza móvil.
+ **Índice de filas**: permite insertar un campo con el índice de filas.
+ **Nombre del campo**: permite seleccionar los nombres de los campos que quiera utilizar en el cálculo del nuevo campo.
+ **Cálculo**: si selecciona el modo **Reducir fila**, aparece el campo **Cálculo**. Seleccione el campo para ver una lista de las opciones de cálculo que puede utilizar para crear el nuevo campo. Para obtener información sobre los cálculos disponibles, consulte [Tipos de cálculo](v10-panels-calculation-types.md).
+ **Operación**: si selecciona **Operación binaria** o el modo de **Operación unaria**, aparecen los campos de **Operación**. Estos campos permiten llevar a cabo operaciones matemáticas básicas con los valores de una sola fila a partir de dos campos seleccionados. También puede utilizar valores numéricos para operaciones binarias.
+ **Como percentil**: si selecciona el modo **Índice de filas**, aparece el conmutador **Como percentil**. Este conmutador le permite transformar el índice de filas en un porcentaje del número total de filas.
+ **Alias**: (opcional) ingrese el nombre del nuevo campo. Si deja este campo en blanco, se le asignará un nombre que se corresponda con el cálculo.
+ **Reemplazar todos los campos**: (opcional) seleccione esta opción si quiere ocultar los demás campos y mostrar solo el campo calculado en la visualización.
**nota**
Actualmente, **Funciones acumulativas** y **Funciones de ventana** están en versión preliminar pública. Grafana Labs ofrece un soporte limitado y es posible que se produzcan cambios importantes antes de que la característica esté disponible para el público en general.
## Concatenación de campos
**Concatenar campos**
Utilice esta transformación para combinar todos los campos de todos los marcos en un solo resultado.
Por ejemplo, si tiene consultas independientes que recuperan datos de temperatura y tiempo de actividad (consulta A) e información sobre el índice de calidad del aire y los errores (consulta B), al aplicar la transformación concatenada se obtiene un marco de datos consolidado con toda la información relevante en una sola vista.
A continuación se muestra un ejemplo.
*Consulta A:*
| Temp | Tiempo de actividad |
| --- | --- |
| 15,4 | 1230233 |
*Consulta B:*
| ICA | Errores |
| --- | --- |
| 3.2 | 5 |
Tras concatenar los campos, el marco de datos sería:
| Temp | Tiempo de actividad | ICA | Errores |
| --- | --- | --- | --- |
| 15.4 | 1230233 | 3.2 | 5 |
Esta transformación simplifica el proceso de combinar datos de diferentes orígenes y proporciona una visión integral para el análisis y la visualización.
## Configuración a partir de los resultados de la consulta
**Configuración a partir de los resultados de la consulta**
Utilice esta transformación para seleccionar una consulta y extraer las opciones estándar, como **Mínimo**, **Máximo**, **Unidad** y **Umbrales**, y aplicarlas a otros resultados de consultas. Esto permite configurar una visualización dinámica, basada en los datos devueltos por una consulta específica.
**Opciones**
+ **Consulta de configuración**: seleccione la consulta que devuelva los datos que quiera usar como configuración.
+ **Aplicar a**: seleccione los campos o series a los que se debe aplicar la configuración.
+ **Opciones de Aplicar a**: especifique un tipo de campo o utilice una expresión regular para el nombre del campo, según lo que haya seleccionado en **Aplicar a**.
**Tabla de asignación de campos**
Debajo de las opciones de configuración, encontrará la tabla de asignación de campos. Esta tabla muestra todos los campos que se encontraron en los datos devueltos por la consulta de configuración, junto con las opciones **Usar como** y **Seleccionar**. Permite controlar la asignación de campos a propiedades de configuración y, en el caso de varias filas, permite elegir el valor que se va a seleccionar.
El siguiente ejemplo muestra una consulta de entrada y una consulta utilizada como configuración de campo.
*Consulta de entrada*
| Time | Valor |
| --- | --- |
| 1626178119127 | 10 |
| 1626178119129 | 30 |
*Consulta de configuración*
| Time | Valor |
| --- | --- |
| 1626178119127 | 100 |
| 1626178119129 | 100 |
*Consulta de salida (igual que la de entrada, pero ahora con la configuración en el campo de valor)*
| Time | Valor (configuración: Max=100) |
| --- | --- |
| 1626178119127 | 10 |
| 1626178119129 | 30 |
Cada campo tiene ahora un conjunto de opciones de configuración máxima. Las opciones, como **Mínimo**, **Máximo**, **Unidad** y **Umbrales**, forman parte de la configuración del campo. Si están configuradas, la visualización las utiliza en lugar de las opciones configuradas manualmente en el panel de opciones del editor de paneles.
**Asignaciones de valores**
También puede transformar el resultado de una consulta en asignaciones de valores. Con esta opción, cada fila del resultado de la consulta de configuración define una sola fila de asignación de valores. Consulte el siguiente ejemplo.
*Resultado de la consulta de configuración*
| Valor | Texto | Color |
| --- | --- | --- |
| L | Bajo | azul |
| M | Medio | green |
| H | Alto | red |
*En la asignación de campos, especifique:*
| Campo | Usar como | Select |
| --- | --- | --- |
| Valor | Asignaciones de valores/Valor | Todos los valores |
| Texto | Asignaciones de valores/Texto | Todos los valores |
| Color | Asignaciones de valores/Color | Todos los valores |
Grafana crea asignaciones de valores a partir del resultado de la consulta y los aplica a los resultados de la consulta de datos reales. Debería ver los valores asignados y coloreados de acuerdo con los resultados de la consulta de configuración.
## Conversión del tipo de campo
Utilice esta transformación para modificar el tipo del campo especificado.
Esta transformación tiene las siguientes opciones:
+ **Campo**: seleccione uno de los campos disponibles.
+ **as** — Seleccione la opción a la FieldType que desea convertir.
+ **Numérico**: intenta convertir los valores en números.
+ **Cadena**: convertirá los valores en cadenas.
+ **Tiempo**: intenta analizar los valores como tiempo.
+ Mostrará una opción para especificar una entrada DateFormat como entrada mediante una cadena, como `yyyy-mm-dd` o`DD MM YYYY hh:mm:ss`.
+ **Booleano**: hará que los valores sean booleanos.
+ **Enum**: convertirá los valores en enumeraciones.
+ Mostrará una tabla para administrar las enumeraciones.
+ **Otro**: intenta analizar los valores como JSON.
Por ejemplo, observe la siguiente consulta, que podría modificarse si se selecciona el campo de tiempo como **Tiempo** y el formato de fecha como `YYYY`.
| Time | Marca | Valor |
| --- | --- | --- |
| 2017-07-01 | encima | 25 |
| 2018-08-02 | debajo | 22 |
| 2019-09-02 | debajo | 29 |
| 2020-10-04 | encima | 22 |
Resultado:
| Time | Marca | Valor |
| --- | --- | --- |
| 2017-01-01 00:00:00 | encima | 25 |
| 2018-01-01 00:00:00 | debajo | 22 |
| 2019-01-01 00:00:00 | debajo | 29 |
| 2020-01-01 00:00:00 | encima | 22 |
Esta transformación le permite adaptar los tipos de datos de forma flexible, lo que garantiza la compatibilidad y la coherencia de las visualizaciones.
## Extracción de campos
Utilice esta transformación para seleccionar un origen de datos y extraer su contenido en diferentes formatos. Esta transformación tiene los siguientes campos:
+ **Origen**: seleccione el campo de origen de los datos.
+ **Formato**: elija una de las siguientes opciones.
+ **JSON**: permite analizar el contenido JSON del origen.
+ **Pares clave/valor**: analice el contenido en formato `a=b` o `c:d` del origen.
+ **Automático**: descubra los campos automáticamente.
+ **Reemplazar todos los campos**: (opcional) seleccione esta opción para ocultar los demás campos y mostrar solo el campo calculado en la visualización.
+ **Mantener el tiempo**: (opcional) solo está disponible si la opción **Reemplazar todos los campos** está configurada en Verdadero. Mantiene el campo de tiempo en la salida.
Observe el siguiente conjunto de datos:
**Conjunto de datos de ejemplo**
| Timestamp | json\$1data |
| --- | --- |
| 1636678740000000000 | \$1"value": 1\$1 |
| 1636678680000000000 | \$1"value": 5\$1 |
| 1636678620000000000 | \$1"value": 12\$1 |
Puede preparar los datos para que los utilice un [panel de series temporales](v10-panels-time-series.md) con esta configuración:
+ Origen: json\$1data
+ Formato: JSON
+ Campo: valor
+ Alias: my\$1value
+ Reemplazar todos los campos: verdadero
+ Mantener el tiempo: verdadero
Esto generará el siguiente resultado:
**Datos transformados**
| Timestamp | my\$1value |
| --- | --- |
| 1636678740000000000 | 1 |
| 1636678680000000000 | 5 |
| 1636678620000000000 | 12 |
Con esta transformación, puede extraer los datos y darles formato de varias maneras. Puede personalizar el formato de extracción en función de sus necesidades específicas respecto a los datos.
## Búsqueda de campos de recurso
Utilice esta transformación para enriquecer el valor de un campo mediante la búsqueda campos adicionales de un origen externo.
Esta transformación tiene los siguientes campos:
+ **Campo**: seleccione un campo de texto de su conjunto de datos.
+ **Búsqueda**: elija entre **Países**, **Estados de EE. UU.** y **Aeropuertos**.
**nota**
Esta transformación solo admite datos espaciales.
Por ejemplo, si tiene estos datos:
**Conjunto de datos de ejemplo**
| Ubicación | Valores |
| --- | --- |
| AL | 0 |
| AK | 10 |
| Arizona | 5 |
| Arkansas | 1 |
| Algún lugar | 5 |
Con esta configuración:
+ Campo: ubicación
+ Búsqueda: estados de EE. UU.
Obtendrá el siguiente resultado:
**Datos transformados**
| Ubicación | ID | Name | Lng | Lat | Valores |
| --- | --- | --- | --- | --- | --- |
| AL | AL | Alabama | -80,891064 | 12,448457 | 0 |
| AK | AK | Arkansas | -100,891064 | 24,448457 | 10 |
| Arizona | | | | | 5 |
| Arkansas | | | | | 1 |
| Algún lugar | | | | | 5 |
Esta transformación le permite aumentar sus datos al obtener información adicional de orígenes externos, de este modo logra un conjunto de datos más completo para el análisis y la visualización.
## Filtrado de datos por RefID de consulta
Utilice esta transformación para ocultar una o varias consultas en los paneles que tienen varias consultas.
Grafana muestra las letras de identificación de la consulta en texto gris oscuro. Elija un identificador de consulta para activar o desactivar el filtrado. Si la letra de la consulta es blanca, se muestran los resultados. Si la letra de la consulta es oscura, se ocultan los resultados.
**nota**
Esta transformación no está disponible para Graphite porque este origen de datos no admite la correlación de los datos devueltos con las consultas.
## Filtrado de datos por valores
Utilice esta transformación para filtrar selectivamente los puntos de datos directamente dentro de la visualización. Esta transformación ofrece opciones para incluir o excluir datos en función de una o varias condiciones aplicadas a un campo seleccionado.
Esta transformación es muy útil si el origen de datos no filtra por valores de forma nativa. También puede usar esta opción para restringir los valores que se muestran si utiliza una consulta compartida.
Las condiciones disponibles para todos los campos son:
+ **Expresión regular**: busque coincidencias con una expresión regular.
+ **Es nulo**: aplique coincidencias si el valor es nulo.
+ **No es nulo**: aplique coincidencias si el valor no es nulo.
+ **Igual**: aplique coincidencias si el valor es igual al valor especificado.
+ **Diferente**: aplique coincidencias si el valor es diferente al valor especificado.
Las condiciones adicionales disponibles para los campos numéricos son:
+ **Mayor**: aplique coincidencias si el valor es mayor que el valor especificado.
+ **Menor**: aplique coincidencias si el valor es menor que el valor especificado.
+ **Mayor o igual**: aplique coincidencias si el valor es mayor o igual.
+ **Menor o igual**: aplique coincidencias si el valor es menor o igual.
+ **Intervalo**: busque coincidencias dentro de un rango entre un mínimo y un máximo especificados, ambos incluidos.
Observe el siguiente conjunto de datos:
| Time | Temperatura | Altitud |
| --- | --- | --- |
| 2020-07-07 11:34:23 | 32 | 101 |
| 2020-07-07 11:34:22 | 28 | 125 |
| 2020-07-07 11:34:21 | 26 | 110 |
| 2020-07-07 11:34:20 | 23 | 98 |
| 2020-07-07 10:32:24 | 31 | 95 |
| 2020-07-07 10:31:22 | 20 | 85 |
| 2020-07-07 09:30:57 | 19 | 101 |
Si **incluye** los puntos de datos que tienen una temperatura inferior a 30 °C, la configuración tendrá el siguiente aspecto:
+ Tipo de filtro: “Incluir”
+ Condición: filas en las que la palabra “Temperatura” coincida con “Inferior a” “30”
Y obtendrá el siguiente resultado, donde solo se incluyen las temperaturas por debajo de 30 °C:
**Datos transformados**
| Time | Temperatura | Altitud |
| --- | --- | --- |
| 2020-07-07 11:34:22 | 28 | 125 |
| 2020-07-07 11:34:21 | 26 | 110 |
| 2020-07-07 11:34:20 | 23 | 98 |
| 2020-07-07 10:31:22 | 20 | 85 |
| 2020-07-07 09:30:57 | 19 | 101 |
Puede agregar más de una condición al filtro. Por ejemplo, quizás quiera incluir los datos solo si la altitud es superior a 100. Para ello, agregue esa condición a la siguiente configuración:
+ Tipo de filtro: “Incluir” filas que coincidan con todas las condiciones
+ Condición 1: filas en las que la “Temperatura” coincida con “Inferior a” “30”
+ Condición 2: filas en las que la “Altitud” coincida con “Superior a” “100”
Si tiene más de una condición, puede elegir si quiere que la acción (incluir o excluir) se aplique en las filas que **coincidan con todas** las condiciones o que **coincidan con cualquiera** de las condiciones que haya agregado.
En el ejemplo anterior, elegimos **Coincidir con todo** porque queríamos incluir las filas que tienen una temperatura inferior a 30 °C *Y* una altitud superior a 100. Si, en su lugar, quisiéramos incluir las filas que tienen una temperatura inferior a 30 °C *O* una altitud superior a 100, seleccionaríamos **Coincidir con cualquiera**. 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 sí 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.
Esta versátil transformación del filtrado de datos le permite incluir o excluir puntos de datos de forma selectiva en función de condiciones específicas. Personalice los criterios para adaptar la presentación de los datos a sus necesidades analíticas específicas.
## Filtrado de campos por nombre
Use esta transformación para eliminar partes de los resultados de su consulta. Hay tres formas de filtrar los nombres de los campos:
+ Ingresar una expresión regular.
+ Seleccionar manualmente los campos incluidos.
+ Usar una variable de panel.
*Uso de una expresión regular*
Al filtrar mediante una expresión regular, se incluyen los nombres de los campos que coinciden con ella. Por ejemplo, si se usara la expresión regular `'prod.*'`, solo se devolverían los campos que comiencen por `prod`.
La expresión regular puede incluir una variable de panel interpolada mediante la sintaxis `${variableName}`.
*Seleccionar manualmente los campos incluidos*
Seleccione o deseleccione los nombres de los campos para eliminarlos del resultado. Si también se incluye una expresión regular, se incluyen los campos que coincidan con la expresión, aunque no estén marcados.
*Uso de una variable de panel*
Seleccione **Desde variable** para poder seleccionar una variable de panel que se utilice para incluir campos. Al configurar una variable de panel con varias opciones, los mismos campos se pueden mostrar en varias visualizaciones.
Esta transformación proporciona flexibilidad a la hora de personalizar los resultados de las consultas para centrarse en los campos específicos que necesita para que el análisis y la visualización sean eficaces.
## Formateo de la cadena
Use esta transformación para personalizar la salida de un campo de cadena. Esta transformación tiene los siguientes campos:
+ **Mayúsculas**: formatea toda la cadena en mayúsculas.
+ **Minúsculas**: formatea toda la cadena en minúsculas.
+ **Mayúsculas de frase**: formatea el primer carácter de la cadena en mayúsculas.
+ **Mayúsculas de título**: formatea el primer carácter de cada palabra de la cadena en mayúsculas.
+ **Mayúsculas tipo Pascal**: formatea el primer carácter de cada palabra de la cadena en mayúsculas y no incluye espacios entre las palabras.
+ **Mayúsculas tipo Pascal**: formatea el primer carácter de cada palabra de la cadena en mayúsculas, excepto la primera palabra, y no incluye espacios entre las palabras.
+ **Minúsculas con guiones bajos**: formatea todos los caracteres de la cadena en minúsculas y utiliza guiones bajos en lugar de espacios entre las palabras.
+ **Minúsculas con guiones**: formatea todos los caracteres de la cadena en minúsculas y utiliza guiones en lugar de espacios entre las palabras.
+ **Recortar**: elimina todos los espacios iniciales y finales de la cadena.
+ **Subcadena**: devuelve una subcadena de la cadena, utilizando las posiciones inicial y final especificadas.
Esta transformación proporciona una forma cómoda de estandarizar y personalizar la presentación de los datos de las cadenas para mejorar la visualización y el análisis.
**nota**
Esta transformación se encuentra actualmente en versión preliminar pública. Grafana Labs ofrece un soporte limitado y es posible que se produzcan cambios importantes antes de que la característica esté disponible para el público en general.
## Formateo del tiempo
Use esta transformación para personalizar la salida de un campo de tiempo. La salida se puede formatear mediante [cadenas de formato Moment.js](https://momentjs.com/docs/#/displaying/). Por ejemplo, si quiere mostrar solo el año de un campo de tiempo, puede usar la cadena de formato “AAAA” para mostrar el año natural (por ejemplo, 1999 o 2012).
**Antes de la transformación:**
| Timestamp | Event |
| --- | --- |
| 1636678740000000000 | Inicio del sistema |
| 1636678680000000000 | Inicio de sesión de usuario |
| 1636678620000000000 | Actualización de datos |
**Tras aplicar «HH:mm:SS»: YYYY-MM-DD **
| Timestamp | Event |
| --- | --- |
| 2021-11-12 14:25:40 | Inicio del sistema |
| 2021-11-12 14:24:40 | Inicio de sesión de usuario |
| 2021-11-12 14:23:40 | Actualización de datos |
Esta transformación le permite personalizar la representación temporal de sus visualizaciones para ofrecerle flexibilidad y precisión al de mostrar los datos temporales.
**nota**
Esta transformación está disponible en espacios de trabajo compatibles con Grafana v10 como característica alfa.
## Agrupación por
Esta transformación agrupa los datos por un valor de campo (columna) específico y procesa los cálculos de cada grupo. Seleccione esta opción para ver una lista de opciones de cálculo.
A continuación se muestra un ejemplo de datos originales.
| Time | ID del servidor | Temperatura de la CPU | Estado del servidor |
| --- | --- | --- | --- |
| 7/7/2020 11:34:20 H | Servidor 1 | 80 | Apagado |
| 7/7/2020 11:34:20 H | Servidor 3 | 62 | OK |
| 7/7/2020 10:32:20 H | Servidor 2 | 90 | Sobrecarga |
| 7/7/2020 10:31:22 H | Servidor 3 | 55 | OK |
| 7/7/2020 9:30:57 A.M. | Servidor 3 | 62 | Rebooting |
| 7/7/2020 9:30:05 A.M. | Servidor 2 | 88 | OK |
| 7/7/2020 9:28:06 A.M. | Servidor 1 | 80 | OK |
| 7/7/2020 9:25:05 A.M. | Servidor 2 | 88 | OK |
| 7/7/2020 9:23:07 H | Servidor 1 | 86 | OK |
Esta transformación se efectúa 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:
| Time | ID del servidor | Temperatura de la CPU | Estado del servidor |
| --- | --- | --- | --- |
| 7/7/2020 11:34:20 A.M. | Servidor 1 | 80 | Apagado |
| 7/7/2020 9:28:06 A.M. | Servidor 1 | 80 | OK |
| 7/7/2020 9:23:07 H | Servidor 1 | 86 | OK |
| 7/7/2020 10:32:20 A.M. | Servidor 2 | 90 | Sobrecarga |
| 7/7/2020 9:30:05 A.M. | Servidor 2 | 88 | OK |
| 7/7/2020 9:25:05 A.M. | Servidor 2 | 88 | OK |
| 7/7/2020 11:34:20 H | Servidor 3 | 62 | OK |
| 7/7/2020 10:31:22 H | Servidor 3 | 55 | OK |
| 7/7/2020 9:30:57 A.M. | Servidor 3 | 62 | Rebooting |
Se agrupan todas las filas con el mismo valor de ID del servidor.
Tras elegir el campo por el que quiere agrupar los datos, puede agregar 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. Así que podemos agregar el cálculo de la *media* aplicado al campo Temperatura de la CPU para obtener lo siguiente:
| ID del servidor | Temperatura de la CPU (media) |
| --- | --- |
| Servidor 1 | 82 |
| Servidor 2 | 8.6 |
| Servidor 3 | 59,6 |
Y podemos agregar más de un cálculo. Por ejemplo:
+ Para el campo Hora, podemos calcular el valor *Último* para saber cuándo se recibió el último punto de datos de cada servidor.
+ Para el campo Estado del servidor, podemos calcular el valor *Último* para saber cuál es el último valor de estado de cada servidor.
+ Para el campo Temperatura, también podemos calcular el valor *Último* para saber cuál es la última temperatura monitoreada para cada servidor.
Entonces obtendríamos:
| ID del servidor | Temperatura de la CPU (media) | Temperatura de la CPU (última) | Hora (última) | Estado del servidor (último) |
| --- | --- | --- | --- | --- |
| Servidor 1 | 82 | 80 | 7/7/2020 11:34:20 A.M. | Apagado |
| Servidor 2 | 8.6 | 90 | 7/7/2020 10:32:20 A.M. | Sobrecarga |
| Servidor 3 | 59.6 | 62 | 7/7/2020 11:34:20 A.M. | OK |
Esta transformación le permite extraer información clave de sus series temporales y mostrarla en un formato cómodo.
## Agrupación en matriz
Use esta transformación para combinar tres campos (que se utilizan como entrada para los campos **Columna**, **Fila** y **Valor de la celda** del resultado de la consulta) y generar una matriz. La matriz se calcula del siguiente modo:
**Datos originales**
| ID del servidor | Temperatura de la CPU | Estado del servidor |
| --- | --- | --- |
| Servidor 1 | 82 | OK |
| Servidor 2 | 8.6 | OK |
| Servidor 3 | 59,6 | Apagado |
Podemos generar una matriz usando los valores de `Server Status` como nombres de columnas, los valores de `Server ID` como nombres de filas y la `CPU Temperature` como contenido de cada celda. Se mostrará el contenido de cada celda para la combinación de columnas (`Server Status`) y filas (`Server ID`) existentes. Para el resto de las celdas, puede seleccionar el valor que se mostrará de entre: **Nulo**, **Verdadero**, **Falso** o **Vacío**.
**Salida**
| Estado del servidor IDServer | OK | Apagado |
| --- | --- | --- |
| Servidor 1 | 82 | |
| Servidor 2 | 88.6 | |
| Servidor 3 | | 59,6 |
Para usar esta transformación a fin de crear una matriz, especifique los campos de los resultados de la consulta. El resultado de la matriz refleja las relaciones entre los valores únicos de estos campos. Esto ayuda a presentar relaciones complejas en un formato de matriz claro y estructurado.
## Agrupación en una tabla anidada
Use esta transformación para agrupar los datos por un valor de campo (columna) específico y procesar los cálculos de cada grupo. Se generan registros que comparten el mismo valor de campo agrupado y se muestran en una tabla anidada.
Para calcular una estadística de un campo, seleccione la casilla situada junto al campo y elija la opción **Calcular**. Esto agregará otro cuadro de selección con las estadísticas que se van a seleccionar.
En la siguiente tabla se muestran los resultados de ejemplo.
| Time | ID del servidor | Temperatura de la CPU | Estado del servidor |
| --- | --- | --- | --- |
| 7/7/2020 11:34:20 A.M. | Servidor 1 | 80 | Apagado |
| 7/7/2020 11:34:20 H | Servidor 3 | 62 | OK |
| 7/7/2020 10:32:20 H | Servidor 2 | 90 | Sobrecarga |
| 7/7/2020 10:31:22 H | Servidor 3 | 55 | OK |
| 7/7/2020 9:30:57 A.M. | Servidor 3 | 62 | Rebooting |
| 7/7/2020 9:30:05 A.M. | Servidor 2 | 88 | OK |
| 7/7/2020 9:28:06 A.M. | Servidor 1 | 80 | OK |
| 7/7/2020 9:25:05 A.M. | Servidor 2 | 88 | OK |
| 7/7/2020 9:23:07 H | Servidor 1 | 86 | OK |
Esta transformación consta de dos pasos. En primer lugar, especifique uno o varios campos por los que agrupar los datos. Esto agrupa los mismos valores de esos campos, como si los ordenara. Por ejemplo, si agrupa por el campo `Server ID`, Grafana agrupa los datos de esta manera:
| ID del servidor | Datos |
| --- | --- |
| Time | Temperatura de la CPU | Estado del servidor |
| --- | --- | --- |
| Time | Temperatura de la CPU | Estado del servidor |
| --- | --- | --- |
| Time | Temperatura de la CPU | Estado del servidor |
| --- | --- | --- |
| Servidor 1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/v10-panels-xform-functions.html) |
| Servidor 2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/v10-panels-xform-functions.html) |
| Servidor 3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/v10-panels-xform-functions.html) |
| 7/7/2020 11:34:20 A.M. | 80 | Apagado |
| 7/7/2020 9:28:06 A.M. | 80 | OK |
| 7/7/2020 9:23:07 H | 86 | OK |
| 7/7/2020 10:32:20 A.M. | 90 | Sobrecarga |
| 7/7/2020 9:30:05 A.M. | 88 | OK |
| 7/7/2020 9:25:05 A.M. | 88 | OK |
| 7/7/2020 11:34:20 H | 62 | OK |
| 7/7/2020 10:31:22 H | 55 | OK |
| 7/7/2020 9:30:57 A.M. | 62 | Rebooting |
Tras elegir el campo por el que quiere agrupar los datos, puede agregar varios cálculos en los demás campos y aplicar el cálculo a cada grupo de filas. Por ejemplo, podría querer calcular la temperatura media de la CPU para cada uno de esos servidores. Para ello, agregue el cálculo de la media aplicado al campo de Temperatura de la CPU para obtener el siguiente resultado:
| ID del servidor | Temperatura de la CPU (media) | |
| --- | --- | --- |
| Time | Estado del servidor |
| --- | --- |
| Time | Estado del servidor |
| --- | --- |
| Time | Estado del servidor |
| --- | --- |
| Servidor 1 | 82 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/v10-panels-xform-functions.html) |
| Servidor 2 | 8.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/v10-panels-xform-functions.html) |
| Servidor 3 | 59,6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/v10-panels-xform-functions.html) |
| 7/7/2020 11:34:20 H | Apagado |
| 7/7/2020 9:28:06 A.M. | OK |
| 7/7/2020 9:23:07 H | OK |
| 7/7/2020 10:32:20 A.M. | Sobrecarga |
| 7/7/2020 9:30:05 A.M. | OK |
| 7/7/2020 9:25:05 A.M. | OK |
| 7/7/2020 11:34:20 A.M. | OK |
| 7/7/2020 10:31:22 H | OK |
| 7/7/2020 9:30:57 A.M. | Rebooting |
## Creación de un mapa de calor
Utilice esta transformación para preparar los datos del histograma y visualizar las tendencias a lo largo del tiempo. Al igual que en la visualización del mapa de calor, esta transformación convierte las métricas del histograma en buckets temporales.
**Bucket X**
Esta configuración determina cómo se divide en buckets el eje X.
+ **Tamaño**: especifique un intervalo de tiempo en el campo de entrada. Por ejemplo, un intervalo de tiempo de `1h` crea celdas de una hora de ancho en el eje X.
+ **Recuento**: en el caso de las non-time-related series, utilice esta opción para definir el número de elementos de un cubo.
**Bucket Y**
Esta configuración determina cómo se divide en buckets el eje Y.
+ **Linear (Lineal)**
+ **Logarítmico**: elija entre el logaritmo de base 2 o el logaritmo de base 10.
+ **Symlog**: usa una escala logarítmica simétrica. Elija entre el logaritmo de base 2 o el logaritmo de base 10 y permita los valores negativos.
Suponga que tiene el siguiente conjunto de datos:
| Timestamp | Valor |
| --- | --- |
| 2023-01-01 12:00:00 | 5 |
| 2023-01-01 12:15:00 | 10 |
| 2023-01-01 12:30:00 | 15 |
| 2023-01-01 12:45:00 | 8 |
+ Con el Bucket X configurado en `Size: 15m` y el Bucket Y como `Linear`, el histograma organiza los valores en intervalos de tiempo de 15 minutos en el eje X y de forma lineal en el eje Y.
+ Si se configura el Bucket X como `Count: 2` y el Bucket Y como `Logarithmic (base 10)`, el histograma agrupa los valores en grupos de dos en el eje X y utiliza una escala logarítmica en el eje Y.
## Histograma
Utilice esta transformación para generar un histograma basado en los datos de entrada, que le permitirá visualizar la distribución de los valores.
+ **Tamaño del bucket**: el rango entre los elementos mayores y menores de un bucket (de xMin a xMax).
+ Desfase de los **cubos: el desfase de los cubos**. non-zero-based
+ **Combinar series**: cree un histograma unificado con todas las series disponibles.
**Datos originales**
Serie 1:
| A | B | C |
| --- | --- | --- |
| 1 | 3 | 5 |
| 2 | 4 | 6 |
| 3 | 5 | 7 |
| 4 | 6 | 8 |
| 5 | 7 | 9 |
Serie 2:
| C |
| --- |
| 5 |
| 6 |
| 7 |
| 8 |
| 9 |
**Salida**
| xMin | xMax | A | B | C | C |
| --- | --- | --- | --- | --- | --- |
| 1 | 2 | 1 | 0 | 0 | 0 |
| 2 | 3 | 1 | 0 | 0 | 0 |
| 3 | 4 | 1 | 1 | 0 | 0 |
| 4 | 5 | 1 | 1 | 0 | 0 |
| 5 | 6 | 1 | 1 | 1 | 1 |
| 6 | 7 | 0 | 1 | 1 | 1 |
| 7 | 8 | 0 | 1 | 1 | 1 |
| 8 | 9 | 0 | 0 | 1 | 1 |
| 9 | 10 | 0 | 0 | 1 | 1 |
Con el histograma generado puede visualizar la distribución de los valores y obtener información sobre la dispersión y la densidad de los datos.
## Unión por campo
Use esta transformación para combinar varios resultados en una sola tabla, lo que permite consolidar los datos de distintas consultas.
Resulta especialmente útil para convertir los resultados de varias series temporales en una sola tabla ancha con un campo de tiempo compartido.
**Unión interna**
La unión interna combina los datos de varias tablas que comparten el mismo valor del campo seleccionado. Este tipo de unión excluye los datos cuyos valores no coinciden en todos los resultados.
Use esta transformación para combinar los resultados de varias consultas (mediante la combinación en un campo de unión aprobado o en la primera columna de tiempo) en un solo resultado y elimine las filas en las que no se pueda llevar a cabo una unión correcta.
En el ejemplo siguiente, 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:
| Time | Trabajo | Tiempo de actividad |
| --- | --- | --- |
| 7/7/2020 11:34:20 A.M. | nodo | 25260122 |
| 7/7/2020 11:24:20 A.M. | postgre | 123001233 |
| 7/7/2020 11:14:20 H | postgre | 345001233 |
Consulta B:
| Time | Server | Errores |
| --- | --- | --- |
| 7/7/2020 11:34:20 H | Servidor 1 | 15 |
| 7/7/2020 11:24:20 H | Servidor 2 | 5 |
| 7/7/2020 11:04:20 H | Servidor 3 | 10 |
El resultado tras aplicar la transformación de unión interna es similar al siguiente:
| Time | Trabajo | Tiempo de actividad | Server | Errores |
| --- | --- | --- | --- | --- |
| 7/7/2020 11:34:20 H | nodo | 25260122 | Servidor 1 | 15 |
| 7/7/2020 11:24:20 A.M. | postgre | 123001233 | Servidor 2 | 5 |
*Unión externa*
La 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 unión interna une la Consulta A y la Consulta B en el campo de tiempo, la unión externa incluye todas las filas que no coinciden en el campo de tiempo.
En el ejemplo siguiente, dos consultas devuelven datos de la tabla. Se visualiza como dos tablas antes de aplicar la transformación de unión externa.
Consulta A:
| Time | Trabajo | Tiempo de actividad |
| --- | --- | --- |
| 7/7/2020 11:34:20 H | nodo | 25260122 |
| 7/7/2020 11:24:20 A.M. | postgre | 123001233 |
| 7/7/2020 11:14:20 H | postgre | 345001233 |
Consulta B:
| Time | Server | Errores |
| --- | --- | --- |
| 7/7/2020 11:34:20 H | Servidor 1 | 15 |
| 7/7/2020 11:24:20 H | Servidor 2 | 5 |
| 7/7/2020 11:04:20 H | Servidor 3 | 10 |
El resultado después de aplicar la transformación de unión externa es similar al siguiente:
| Time | Trabajo | Tiempo de actividad | Server | Errores |
| --- | --- | --- | --- | --- |
| 7/7/2020 11:04:20 H | | | Servidor 3 | 10 |
| 7/7/2020 11:14:20 H | postgre | 345001233 | | |
| 7/7/2020 11:34:20 H | nodo | 25260122 | Servidor 1 | 15 |
| 7/7/2020 11:24:20 A.M. | postgre | 123001233 | Servidor 2 | 5 |
## Unión por etiquetas
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 **Etiqueta** compartido.
+ **Unir**: seleccione la etiqueta que desee usar para la unión entre las etiquetas disponibles o comunes en todas las series temporales.
+ **Valor**: el nombre del resultado de salida.
**Ejemplo**
Entrada 1: `series1{what='Temp', cluster='A', job='J1'}`
| Time | Valor |
| --- | --- |
| 1 | 10 |
| 2 | 200 |
Entrada 2: `series2{what='Temp', cluster='B', job='J1'}`
| Time | Valor |
| --- | --- |
| 1 | 10 |
| 2 | 200 |
Entrada 3: `series3{what='Speed', cluster='B', job='J1'}`
| Time | Valor |
| --- | --- |
| 22 | 22 |
| 28 | 77 |
Config:
```
value: 'what'
```
Salida:
| clúster | job | Temp | Velocidad |
| --- | --- | --- | --- |
| A | J1 | 10 | |
| A | J1 | 200 | |
| B | J1 | 10 | 22 |
| B | J1 | 200 | 77 |
Combine y organice los datos de serie temporal de forma eficaz con esta transformación para obtener información completa.
## Etiquetas para campos
Use esta transformación para convertir los resultados de series temporales con etiquetas en una tabla, incluyendo las claves y los valores de cada etiqueta en el resultado. Muestre las etiquetas como columnas o valores de fila para mejorar la visualización de los datos.
Si tenemos el siguiente resultado de una consulta de dos series temporales:
+ Serie 1: etiquetas `Server=Server A`, `Datacenter=EU`
+ Serie 2: etiquetas `Server=Server B`, `Datacenter=EU`
En el modo **Columnas**, el resultado es el siguiente:
| Time | Server | Centro de datos | Valor |
| --- | --- | --- | --- |
| 7/7/2020 11:34:20 A.M. | Servidor A | UE | 1 |
| 7/7/2020 11:34:20 H | Servidor B | UE | 2 |
En el modo “Filas”, el resultado tiene una tabla para cada serie y muestra cada valor de etiqueta de la siguiente manera:
| etiqueta | valor |
| --- | --- |
| Server | Servidor A |
| Centro de datos | UE |
| etiqueta | valor |
| --- | --- |
| Server | Servidor B |
| Centro de datos | UE |
**Nombre del campo de valor**
Si ha seleccionado Servidor como **Nombre del campo de valor**, obtendrá un campo por cada valor de la etiqueta del servidor.
| Time | Centro de datos | Servidor A | Servidor B |
| --- | --- | --- | --- |
| 7/7/2020 11:34:20 H | UE | 1 | 2 |
**Comportamiento de combinación**
El transformador de etiquetas a campos consta internamente de 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 necesario 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.
+ Serie 1: etiquetas `Server=ServerA`
+ Serie 2: etiquetas `Datacenter=EU`
En primer lugar, se obtendrán estas dos tablas:
| Time | Server | Valor |
| --- | --- | --- |
| 7/7/2020 11:34:20 H | ServidorA | 10 |
| Time | Centro de datos | Valor |
| --- | --- | --- |
| 7/7/2020 11:34:20 H | UE | 20 |
Después de la combinación:
| Time | Server | Valor | Centro de datos |
| --- | --- | --- | --- |
| 7/7/2020 11:34:20 H | ServidorA | 10 | |
| 7/7/2020 11:34:20 H | | 20 | UE |
## Límite
Utilice esta transformación para restringir el número de filas que se muestran y ofrecer una vista más precisa de los datos. Resulta muy útil cuando se trata de conjuntos de datos grandes.
A continuación, se ofrece un ejemplo que ilustra el impacto de la transformación **Limitar** en la respuesta de un origen de datos:
| Time | Métrica | Valor |
| --- | --- | --- |
| 7/7/2020 11:34:20 H | Temperatura | 25 |
| 7/7/2020 11:34:20 H | Humedad | 22 |
| 7/7/2020 10:32:20 H | Humedad | 29 |
| 7/7/2020 10:31:22 H | Temperatura | 22 |
| 7/7/2020 9:30:57 H | Humedad | 33 |
| 7/7/2020 9:30:05 A.M. | Temperatura | 19 |
Este es el resultado después de agregar una transformación Limitar con un valor de “3”:
| Time | Métrica | Valor |
| --- | --- | --- |
| 7/7/2020 11:34:20 H | Temperatura | 25 |
| 7/7/2020 11:34:20 H | Humedad | 22 |
| 7/7/2020 10:32:20 H | Humedad | 29 |
Esta transformación ayuda a personalizar la presentación visual de sus datos para centrarse en los más relevantes.
## Combinación de series o tablas
Utilice esta transformación para combinar el resultado de varias consultas en uno solo, lo cual resulta especialmente útil cuando se utiliza la visualización del panel de tablas. La transformación combina los valores en la misma fila si los campos compartidos contienen los mismos datos.
Este ejemplo ilustra el impacto de la transformación **Combinar series o tablas** en dos consultas que devuelven datos de tablas:
*Consulta A:*
| Time | Trabajo | Tiempo de actividad |
| --- | --- | --- |
| 7/7/2020 11:34:20 H | nodo | 25260122 |
| 7/7/2020 11:24:20 A.M. | postgre | 123001233 |
Consulta B:
| Time | Trabajo | Errores |
| --- | --- | --- |
| 7/7/2020 11:34:20 H | nodo | 15 |
| 7/7/2020 11:24:20 H | postgre | 5 |
Este es el resultado después de aplicar la transformación Combinar:
| Time | Trabajo | Errores | Tiempo de actividad |
| --- | --- | --- | --- |
| 7/7/2020 11:34:20 H | nodo | 15 | 25260122 |
| 7/7/2020 11:24:20 A.M. | postgre | 5 | 123001233 |
Esta transformación combina los valores de la consulta A y la consulta B en una tabla unificada; de este modo, se mejora la presentación de la información.
## Organización de campos por nombre
Use esta transformación para cambiar el nombre, reordenar u ocultar los campos devueltos por una sola consulta de su panel. Esta transformación solo funciona en paneles con una única consulta. Si su panel tiene varias consultas, debe aplicar una transformación de *Unión externa* o eliminar las consultas adicionales.
**Transformación de campos**
Grafana muestra una lista de los campos devueltos por la consulta. Puede:
+ **Cambiar orden de los campos**: arrastre un campo a una nueva ubicación de la lista.
+ **Ocultar o mostrar un campo**: utilice el icono en forma de ojo situado junto al nombre del campo para cambiar la visibilidad del campo.
+ **Cambiar el nombre de un campo**: escriba un nombre nuevo en el cuadro **Cambiar nombre**.
**Ejemplo**
Con este resultado de consulta inicial:
| Time | 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 |
Puede aplicar una anulación del cambio de nombre del campo para crear:
| Time | Sensor | Lectura |
| --- | --- | --- |
| 2020-07-07 11:34:20 | Temperatura | 25 |
| 2020-07-07 11:34:20 | Humedad | 22 |
| 2020-07-07 10:32:20 | Humedad | 29 |
Esta transformación le permite personalizar la visualización de los resultados de las consultas, lo cual garantiza una representación clara y detallada de sus datos en Grafana.
## Partición por valores
Use esta transformación para agilizar el proceso de representación gráfica de varias series sin necesidad de efectuar varias consultas con cláusulas `WHERE` diferentes.
**nota**
Esta función está disponible en espacios de trabajo compatibles con la versión 9 de Grafana y posteriores.
Resulta especialmente útil cuando se utiliza una tabla SQL de métricas, como en este ejemplo:
| Time | Region | Valor |
| --- | --- | --- |
| 20/10/2022 12:00:00 P.M. | EE. UU. | 1520 |
| 20/10/2022 12:00:00 P.M. | UE | 2936 |
| 20/10/2022 01:00:00 A. M. | EE. UU. | 1327 |
| 20/10/2022 13:00:00 | UE | 912 |
Con el transformador *Particionar por valores*, puede emitir una sola consulta y dividir los resultados por valores únicos en una o varias columnas (campos) de su elección. El siguiente ejemplo utiliza `Region`.
```
SELECT Time, Region, Value FROM metrics WHERE Time > '2022-10-20'
```
| Time | Region | Valor |
| --- | --- | --- |
| 20/10/2022 12:00:00 P.M. | EE. UU. | 1520 |
| 20/10/2022 01:00:00 A. M. | EE. UU. | 1327 |
| Time | Region | Valor |
| --- | --- | --- |
| 20/10/2022 12:00:00 P.M. | UE | 2936 |
| 20/10/2022 01:00:00 A. M. | UE | 912 |
Esta transformación simplifica el proceso y mejora la flexibilidad al visualizar varias series dentro de la misma visualización de series temporales.
## Preparación de series temporales
Use esta transformación para solucionar los problemas que surgen cuando un origen de datos devuelve datos de serie temporal en un formato que no es compatible con la visualización deseada. Esta transformación le permite convertir datos de serie temporal entre formatos anchos y largos.
**Series temporales de varios marcos**
Use esta opción para transformar el marco de datos de serie temporal del formato ancho al formato largo. Esto resulta especialmente útil cuando el origen de datos proporciona información de series temporales en un formato que debe modificarse para lograr una compatibilidad óptima con la visualización.
*Ejemplo*
Esta entrada:
| Timestamp | Value1 | Value2 |
| --- | --- | --- |
| 2023-01-01 00:00:00 | 10 | 20 |
| 2023-01-01 01:00:00 | 15 | 25 |
Podría transformarse en:
| Timestamp | Variable | Valor |
| --- | --- | --- |
| 2023-01-01 00:00:00 | Value1 | 10 |
| 2023-01-01 00:00:00 | Value2 | 20 |
| 2023-01-01 01:00:00 | Value1 | 15 |
| 2023-01-01 01:00:00 | Value2 | 25 |
**Series temporales anchas**
Use esta opción para transformar el marco de datos de serie temporal del formato largo al formato ancho. Esto resulta especialmente útil cuando el origen de datos entrega datos de serie temporal en un formato largo y la visualización requiere un formato ancho.
*Ejemplo*
Esta entrada:
| Timestamp | Variable | Valor |
| --- | --- | --- |
| 2023-01-01 00:00:00 | Value1 | 10 |
| 2023-01-01 00:00:00 | Value2 | 20 |
| 2023-01-01 01:00:00 | Value1 | 15 |
| 2023-01-01 01:00:00 | Value2 | 25 |
Podría transformarse en:
| Timestamp | Value1 | Value2 |
| --- | --- | --- |
| 2023-01-01 00:00:00 | 10 | 20 |
| 2023-01-01 01:00:00 | 15 | 25 |
## Reducción
Al utilizar esta transformación, se aplica un cálculo a cada campo del marco de datos y se devuelve un único valor. Esta transformación resulta particularmente útil para consolidar varios datos de serie temporal en un formato resumido más compacto. Al aplicar esta transformación, se eliminan los campos de tiempo.
Pongamos por ejemplo la entrada:
Consulta A:
| Time | Temp | Tiempo de actividad |
| --- | --- | --- |
| 2020-07-07 11:34:20 | 12.3 | 256122 |
| 2020-07-07 11:24:20 | 15,4 | 1230233 |
Consulta B:
| Time | ICA | Errores |
| --- | --- | --- |
| 2020-07-07 11:34:20 | 6.5 | 15 |
| 2020-07-07 11:24:20 | 3.2 | 5 |
El transformador Reducir tiene dos modos:
+ **De series a filas**: crea una fila para cada campo y una columna para cada cálculo.
+ **Reducir campos**: mantiene la estructura del marco existente, pero contrae los campos en un único valor.
Por ejemplo, si utilizó el cálculo **Primero** y **Último** con una transformación **De series a filas**, el resultado sería:
| Campo | Primero | Último |
| --- | --- | --- |
| Temp | 12.3 | 15,4 |
| Tiempo de actividad | 256122 | 1230233 |
| ICA | 6.5 | 3.2 |
| Errores | 15 | 5 |
Al **reducir los campos** con el cálculo **último**, se obtienen dos marcos, cada uno con una fila:
Consulta A:
| Temp | Tiempo de actividad |
| --- | --- |
| 15.4 | 1230233 |
Consulta B:
| ICA | Errores |
| --- | --- |
| 3.2 | 5 |
## Cambio de nombre por expresión regular
Use 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ía establecer la expresión regular en `([^\.]+)\..+` y el patrón de reemplazo en `$1`, `web-01.example.com` se convertiría en `web-01`.
Esta transformación le permite personalizar sus datos para adaptarlos a sus necesidades de visualización, lo que hace que sus paneles sean más informativos y fáciles de usar.
## Filas a campos
Utilice esta transformación para convertir las filas en campos separados. Puede resultar útil porque los campos se pueden diseñar y configurar de forma individual. También puede usar campos adicionales como orígenes 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 como**). También puede elegir qué valor seleccionar si hay varias filas en los datos devueltos.
Esta transformación requiere:
+ Un campo que se usará como origen de los nombres de campo.
De forma predeterminada, la transformación usa el primer campo de cadena como origen. Para anular esta configuración predeterminada, seleccione **Nombre del campo** en la columna **Usar como** para el campo que desee usar en su lugar.
+ Un campo que se usará como origen de los valores.
De forma predeterminada, la transformación usa el primer numérico como origen. Sin embargo, puede anular esta configuración predeterminada si selecciona **Valor del campo** en la columna **Usar como** para el campo que desee usar en su lugar.
Resulta útil cuando se visualizan datos de:
+ Calibre
+ Estadística
+ Gráfico circular
**Asignación de campos adicionales a etiquetas**
Si un campo no se asigna a la propiedad de configuración, Grafana lo usará automáticamente como origen de una etiqueta en el campo de salida.
Ejemplo:
| Name | DataCenter | Valor |
| --- | --- | --- |
| ServidorA | EE. UU. | 100 |
| ServidorB | UE | 200 |
Salida:
| Servera (etiquetas: DataCenter EE. UU.) | ServerB (etiquetas DataCenter: UE) |
| --- | --- |
| 100 | 200 |
Las etiquetas adicionales ahora se pueden usar en el nombre para mostrar 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 transformación *Configuración a partir de los resultados de la consulta*.
**Ejemplo**
Input:
| Name | Valor | Máximo |
| --- | --- | --- |
| ServidorA | 10 | 100 |
| ServidorB | 20 | 200 |
| ServidorC | 30 | 300 |
Salida:
| ServidorA (config: max=100) | ServidorB (config: max=200) | ServidorC (config: max=300) |
| --- | --- | --- |
| 10 | 20 | 30 |
Como puede ver, cada fila de los datos de origen se convierte en un campo independiente. Cada campo tiene ahora 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.
Esta transformación permite convertir filas en campos individuales, facilita la configuración dinámica de los campos y asigna campos adicionales a las etiquetas.
## De series a filas
Use esta transformación para combinar el resultado de varias consultas de datos de serie temporal en un único resultado. Resulta útil cuando se usa 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 desde qué consulta se origina la métrica. Para personalizar este valor, defina Etiqueta en la consulta de origen.
En el siguiente ejemplo, tenemos dos consultas que devuelven datos de serie temporal. Se visualiza como dos tablas independientes antes de aplicar la transformación.
*Consulta A:*
| Time | Temperatura |
| --- | --- |
| 2020-07-07 11:34:20 | 25 |
| 2020-07-07 10:31:22 | 22 |
| 2020-07-07 09:30:05 | 19 |
*Consulta B:*
| Time | Humedad |
| --- | --- |
| 2020-07-07 11:34:20 | 24 |
| 2020-07-07 10:32:20 | 29 |
| 2020-07-07 09:30:57 | 33 |
Este es el resultado después de aplicar la transformación De series a filas.
| Time | 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 |
Esta transformación facilita la consolidación de los resultados de múltiples consultas de series temporales, ya que proporciona un conjunto de datos simplificado y unificado para un análisis y una visualización eficientes en formato de tabla.
## Ordenar por
Use esta transformación para ordenar cada marco del resultado de una consulta en función de un campo específico, lo que facilita la comprensión y el análisis de los datos. Al configurar el campo deseado para la ordenación, puede controlar el orden en que se presentan los datos en la tabla o visualización.
Use el conmutador **Invertir** para ordenar inversamente los valores dentro del campo especificado. Esta funcionalidad resulta especialmente útil cuando se quiere cambiar rápidamente entre el orden ascendente y el descendente para adaptarlo a sus necesidades de análisis.
Por ejemplo, en un escenario en el que los datos de series temporales se recuperan de un origen de datos, se puede aplicar la transformación **Ordenar por** para organizar los marcos de datos en función de la marca de tiempo, ya sea en orden ascendente o descendente, según los requisitos de análisis. Esta funcionalidad garantiza que pueda navegar e interpretar fácilmente los datos de series temporales, lo que le permitirá obtener información valiosa a partir de una presentación organizada y visualmente coherente.
## Spatial
Utilice esta transformación para aplicar operaciones espaciales a los resultados de las consultas.
+ **Acción**: seleccione una acción:
+ **Preparar un campo espacial**: establezca un campo geométrico en función de los resultados de otros campos.
+ **Modo de ubicación**: seleccione un modo de ubicación (estas opciones las comparten los modos **Calcular valor** y **Transformar**):
+ **Automático**: identifica automáticamente los datos de ubicación en función de los nombres de campo predeterminados.
+ **Coordenadas**: especifique los campos de latitud y longitud.
+ **Geohash**: especifique un campo de geohash.
+ **Búsqueda**: especifique los campos de ubicación del nomenclátor.
+ **Calcular valor**: utilice la geometría para definir un nuevo campo (). heading/distance/area
+ **Función**: elija una operación matemática para aplicarla a la geometría:
+ **Rumbo**: calcule el rumbo (dirección) entre dos puntos.
+ **Área**: calcule el área encerrada por un polígono definido por la geometría.
+ **Distancia**: calcule la distancia entre dos puntos.
+ **Transformar**: aplique operaciones espaciales a la geometría.
+ **Operación**: elija una operación para aplicarla a la geometría:
+ **Como línea**: cree una característica de línea única con un vértice en cada fila.
+ **Creador de líneas**: cree una línea entre dos puntos.
Esta transformación le permite manipular y analizar datos geoespaciales, lo cual le permite llevar a cabo operaciones como crear líneas entre puntos, calcular propiedades espaciales, etc.
## Transformación de series temporales a tablas
Use esta transformación para convertir los resultados de las series temporales en una tabla mediante una transformación de un marco de datos de serie temporal en un campo **Tendencia**. A continuación, el campo **Tendencia** se puede renderizar utilizando el [tipo de celda minigráfico](v10-panels-table.md#v10-panels-table-cell-type), que genera un minigráfico insertado para cada fila de la tabla. Si hay varias consultas de series temporales, cada una dará como resultado un marco de datos de tabla independiente. Se pueden unir mediante transformaciones de unión o combinación para generar una única tabla con varios minigráficos por fila.
Para cada valor de campo de **Tendencia** generado, se puede seleccionar una función de cálculo. El valor predeterminado es **Último valor no nulo**. Este valor se muestra junto al minigráfico y se utiliza para ordenar las filas de la tabla.
## Análisis de regresión
Use esta transformación para crear un nuevo marco de datos que contenga los valores previstos por un modelo estadístico. Resulta útil para encontrar una tendencia en datos caóticos. Funciona ajustando una función matemática a los datos, mediante regresión lineal o polinomial. A continuación, el marco de datos se puede usar en una visualización para mostrar una línea de tendencia.
Existen dos modelos distintos:
+ **Regresión lineal**: ajusta una función lineal a los datos.
+ **Regresión polinomial**: ajusta una función polinomial a los datos.
**nota**
Esta transformación se encuentra actualmente en versión preliminar pública. Grafana Labs ofrece un soporte limitado y es posible que se produzcan cambios importantes antes de que la característica esté disponible para el público en general.
# Solución de problemas de consultas
****
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).
En esta página se proporciona información para resolver los problemas más comunes del panel de control.
**Obtengo resultados diferentes cuando reorganizo mis funciones**
El orden de las funciones es muy importante. Al igual que en matemáticas, el orden en el que coloques las funciones puede afectar al resultado.
**Inspección de la solicitud y la respuesta a la consulta**
Los problemas más comunes están relacionados con la consulta y la respuesta del origen de datos. Incluso si parece un error o un problema de visualización en Grafana, casi siempre es un problema con la consulta o la respuesta del origen de datos. Comience por inspeccionar la consulta y la respuesta del panel.
Para obtener más información, consulte [Inspect request and response data](v10-panels-panel-inspector.md).
**Mi consulta va lenta**
¿Cuántos puntos de datos devuelve su consulta? Una consulta que devuelva muchos puntos de datos será lenta. Pruebe esto:
+ En **Opciones de consulta**, limite el **Máximo de puntos de datos** devueltos.
+ En **Opciones de consulta**, aumente el tiempo de **Intervalo mínimo**.
+ En la consulta, utilice una función `group by`.
# Tipos de cálculo
****
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).
La siguiente tabla contiene una lista de cálculos que se pueden hacer en Grafana. Puede encontrar estos cálculos en la pestaña **Transformar** y en los indicadores de barras, indicadores y visualizaciones de las estadísticas.
| Cálculo | Description (Descripción) |
| --- | --- |
| Todos nulos | Verdadero cuando todos los valores son nulos |
| Todos los valores | Matriz con todos los valores |
| Todos los valores únicos | Matriz con todos los valores únicos |
| Todos ceros | Verdadero cuando todos los valores son 0 |
| Recuento de cambios | Número de veces que cambia el valor del campo |
| Recuento | Número de valores de un campo |
| Delta | El cambio de valor acumulado solo cuenta los incrementos |
| Diferencia | Diferencia entre el primer y el último valor de un campo |
| Diferencia de porcentaje | Cambio porcentual entre el primer y el último valor de un campo |
| Recuento de valores distintos | Número de valores únicos de un campo |
| Primero | Primer valor de un campo |
| Primero\$1 (no nulo) | En primer lugar, no es un valor nulo en un campo (también se excluye NaNs) |
| Último | Último valor de un campo |
| Último\$1 (no nulo) | Por último, el valor de un campo no es nulo (también se excluye NaNs) |
| Máximo | Valor máximo de un campo |
| Media | Valor medio de todos los valores de un campo |
| Varianza | Diferencia de todos los valores de un campo |
| StdDev | Desviación estándar de todos los valores de un campo |
| Mínimo | Valor mínimo de un campo |
| Mín. (por encima de cero) | Valor mínimo positivo de un campo |
| Range | Diferencia entre los valores máximo y mínimo de un campo |
| Paso | Intervalo mínimo entre los valores de un campo |
| Total | Suma de todos los valores de un campo |
# Configuración de opciones del panel
****
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).
Un panel de Grafana es una representación visual de los datos que puede personalizar mediante la definición de una consulta de origen de datos, la transformación y el formato de los datos y la configuración de los ajustes de visualización.
Un editor de paneles incluye un generador de consultas y una serie de opciones que puede usar para transformar datos y agregar información a los paneles.
En este tema, se describe cómo llevar a cabo las siguientes acciones:
+ Abrir un panel para editarlo
+ Agregar un título de panel y una descripción
+ Visualización de un modelo JSON de panel
+ Configuración de filas y paneles que se repiten
## Edición de un panel
Después de agregar un panel a un panel de control, puede abrirlo en cualquier momento para cambiar o actualizar las consultas, agregar transformaciones de datos y cambiar la configuración de visualización.
**Edición de un panel**
1. Abra el panel de control que contiene el panel que desee editar.
1. Pase el ratón sobre cualquier parte del panel para mostrar el menú de acciones en la esquina superior derecha.
1. Seleccione el enlace y elija **Editar**.
Para usar un método abreviado de teclado para abrir el panel, pase el cursor sobre el panel y pulse `e`.
El panel se abre en modo de edición.
## Adición de un título de panel y una descripción
Agregue un título y una descripción a un panel para compartir con los usuarios cualquier información importante sobre la visualización. Por ejemplo, utilice la descripción para documentar el propósito de la visualización.
1. Edite un panel.
1. En el panel de opciones de visualización del panel, localice la sección **Opciones del panel**.
1. Ingrese un **título**.
El texto ingresado en este campo aparece en una información sobre herramientas en el editor del panel y en el panel de control.
1. Escriba una descripción del panel y de los datos que va a mostrar.
El texto ingresado en este campo se muestra en la información sobre herramientas en la esquina superior izquierda del panel.
Puede usar [variables que haya definido](v10-dash-variables.md) en los campos **Título** y **Descripción**, pero no [variables globales](v10-dash-variable-add.md#v10-dash-variable-add-global).
## Visualización de un modelo JSON de panel
Explore y exporte modelos JSON de paneles, datos de paneles y marcos de datos.
**Visualización de un modelo JSON de panel**
1. Abra el panel de control que contiene el panel.
1. Pase el ratón sobre cualquier parte del panel para mostrar el menú de acciones en la esquina superior derecha.
1. En el menú, seleccione **Inspeccionar > JSON del panel**.
1. En el campo **Seleccionar origen**, elija una de las siguientes opciones:
+ **JSON del panel**: muestra un objeto JSON que representa el panel.
+ **Datos del panel**: muestra un objeto JSON que representa los datos que se pasaron al panel.
+ **DataFrame estructura**: muestra la estructura de datos del panel, incluidas las transformaciones, configuraciones de campo y configuraciones de anulación que se hayan aplicado.
1. Para explorar el JSON, elija **>** para expandir o contraer partes del modelo JSON.
## Configuración de paneles que se repiten
Puede configurar Grafana para agregar dinámicamente paneles o filas a un panel de control. Un panel dinámico es un panel que el sistema crea en función del valor de una variable. Las variables cambian las consultas de forma dinámica en todos los paneles de un panel de control. Para obtener más información acerca de la repetición de paneles, consulte [Creación de paneles de control](v10-dash-creating.md).
**nota**
Los paneles que se repiten requieren que las variables tengan uno o más elementos seleccionados; no puede repetir un panel cero veces para ocultarlo.
*Requisitos previos*
+ Asegúrese de que la consulta incluya una variable con varios valores.
**Configuración de paneles que se repiten**
1. Edite el panel que desee repetir.
1. En el panel de opciones de visualización, seleccione **Opciones de panel > Opciones de repetición**.
1. Seleccione una **dirección**.
+ Elija **horizontal** para organizar los paneles. side-by-side Grafana ajusta el ancho de un panel repetido. No se pueden combinar otros paneles de una fila con un panel repetido.
+ Elija **vertical** para organizar los paneles en una columna. El ancho de los paneles repetidos es el mismo que el del panel original repetido.
1. Para propagar los cambios a todos los paneles, vuelva a cargar el panel de control.
# Configuración de opciones estándar
****
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).
El modelo de datos utilizado en Grafana es una estructura de tabla orientada a columnas que unifica las series temporales y los resultados de las consultas de tablas. Cada columna de esta estructura se denomina *campo*. Un campo puede representar una sola columna de serie temporal o tabla.
Las opciones de campo le permiten cambiar la forma en que se muestran los datos en las visualizaciones. Las opciones y anulaciones que aplique no cambian los datos, sino que cambian la forma en que Grafana muestra los datos. Cuando cambia una opción, se aplica a todos los campos, es decir, a todas las series o columnas. Por ejemplo, si cambia la unidad a porcentaje, todos los campos con valores numéricos se mostrarán en porcentajes.
Después en este tema se incluye una lista completa de las opciones de formato de campo.
**nota**
Puede aplicar opciones estándar a la mayoría de los paneles integrados de Grafana. A algunos paneles antiguos y paneles comunitarios que no se hayan actualizado al nuevo panel y modelo de datos les faltarán todas o algunas de estas opciones de campo.
**Configuración de opciones estándar**
1. Abra un panel de control. Pase el ratón sobre cualquier parte del panel para mostrar el menú de acciones en la esquina superior derecha del panel de control.
1. En el menú de acciones, elija **Editar**.
1. En el panel de opciones de visualización del panel, localice la sección **Opciones estándar**.
1. Seleccione las opciones estándar que desee aplicar.
1. Para obtener una vista previa del cambio, seleccione fuera del cuadro de opciones del campo que está editando o pulse **Intro**.
**Definiciones de opciones estándar**
En esta sección se explican todas las opciones estándar disponibles.
Puede aplicar opciones estándar a la mayoría de los paneles integrados de Grafana. A algunos paneles antiguos y paneles comunitarios que no se hayan actualizado al nuevo panel y modelo de datos les faltarán todas o algunas de estas opciones de campo.
La mayoría de las opciones de campo no afectarán a la visualización hasta que haga clic fuera del cuadro de opciones de campo que esté editando o pulse **Intro**.
**nota**
Grafana Labs trabaja constantemente para agregar y ampliar opciones para todas las visualizaciones, por lo que es posible que no todas las opciones estén disponibles para todas las visualizaciones.
## Unidad
Le permite elegir qué unidad debe usar un campo. Elija el campo **Unidad** y, a continuación, profundice hasta encontrar la unidad que desee. La unidad que seleccione se aplicará a todos los campos excepto al de tiempo.
### Unidades personalizadas
También puede utilizar la lista desplegable de unidades para especificar unidades personalizadas, prefijos o sufijos y formatos de fecha y hora personalizados.
Para seleccionar una unidad personalizada, ingrésela y seleccione la última opción **Personalizar: xxx** de la lista desplegable.
+ **sufijo: ** para una unidad personalizada que debe ir después del valor.
+ **prefijo: ** para una unidad personalizada que debe ir antes del valor.
+ **hora: ** para formatos de fecha y hora personalizados, escriba, por ejemplo, `time:YYYY-MM-DD`. Consulte el [formato](https://momentjs.com/docs/#/displaying/) en la *documentación de Moment.js* para ver la sintaxis y las opciones del formato.
+ **si: ** para unidades SI personalizadas. Por ejemplo: `si: mF`. Esta opción es un poco más avanzada porque puede especificar tanto una unidad como la escala de datos de origen. Por lo que, si los datos de origen se representan como unidades de milésimas (miles), agregue a la unidad el carácter de la escala SI como prefijo.
+ **recuento: ** para una unidad de recuento personalizada.
+ **divisa: ** para personalizar una unidad monetaria.
También puede pegar un emoji nativo en el selector de unidades y seleccionarlo como unidad personalizada.
### Unidades de cadena
Grafana a veces puede ser demasiado agresiva al analizar cadenas y mostrarlas como números. Para que Grafana muestre la cadena original, cree una anulación de campo y agregue una propiedad de unidad con la unidad **Cadena**.
### Unidades de escala
De forma predeterminada, Grafana escala la unidad de forma automática en función del tamaño del valor. Por ejemplo, si tiene un valor de 0,14 kW, Grafana lo mostrará como 140 W. Otro ejemplo es que 3000 kW se mostrará como 3 MW. Si quiere desactivar este comportamiento, puede desactivar el interruptor de **unidades de escala**.
## Mínimo
Esta opción le permite establecer el valor mínimo utilizado en los cálculos del umbral porcentual. Déjelo en blanco para calcular automáticamente el mínimo.
## Máximo
Esta opción le permite establecer el valor máximo utilizado en los cálculos del umbral porcentual. Déjelo en blanco para calcular automáticamente el máximo.
## Mínimo y máximo de campo
De forma predeterminada, el mínimo y el máximo calculados se basarán en el mínimo y el máximo en todas las series y campos. Al activar min/max el campo, se calculará el mínimo o el máximo de cada campo de forma individual, en función del mínimo o el máximo de ese campo.
## Decimales
Especifique el número de decimales que Grafana incluye en el valor renderizado. Si se deja este campo en blanco, Grafana trunca automáticamente el número de decimales en función del valor. Por ejemplo, 1,1234 se mostrará como 1,12 y 100,456 se mostrará como 100.
Para mostrar todos los decimales, defina la unidad en **Cadena**.
## Display name (Nombre de visualización)
Permite establecer el título para mostrar de todos los campos. Puede utilizar [variables](v10-dash-variables.md) en el título del campo.
Cuando se muestran varias estadísticas, campos o series, este campo controla el título de cada estadística. Puede usar expresiones como **\$1\$1\$1\$1field.name\$1** para usar solo el nombre de la serie o el nombre del campo en el título.
Dado un campo con el nombre `Temp` y las etiquetas `{"Loc"="PBI", "Sensor"="3"}`:
| Sintaxis de expresiones | Ejemplo | Se renderiza en | Explicación |
| --- | --- | --- | --- |
| \$1\$1\$1\$1field.displayName\$1 | Igual que la sintaxis | Temp \$1Loc="PBI", Sensor="3"\$1 | Muestra el nombre del campo y las etiquetas en \$1\$1 en caso de que estén presentes. Si solo hay una clave de etiqueta en la respuesta, para la parte de la etiqueta, Grafana muestra el valor de la etiqueta sin los corchetes adjuntos. |
| \$1\$1\$1\$1field.name\$1 | Igual que la sintaxis | Temp | Muestra el nombre del campo (sin etiquetas). |
| \$1\$1\$1\$1field.labels\$1 | Igual que la sintaxis | Loc="PBI", Sensor="3" | Muestra las etiquetas sin el nombre. |
| \$1\$1\$1\$1field.labels.X\$1 | \$1\$1\$1\$1field.labels.Loc\$1 | PBI | Muestra el valor de la clave de etiqueta especificada. |
| \$1\$1\$1\$1field.labels.\$1\$1values\$1 | Igual que la sintaxis | PBI, 3 | Muestra los valores de las etiquetas separados por una coma (sin claves de etiqueta). |
Si el valor es una cadena vacía después de representar la expresión de un campo concreto, se utiliza el método de visualización predeterminado.
## Combinación de colores
Las opciones de color y su efecto en la visualización dependen de la visualización con la que esté trabajando. Algunas visualizaciones tienen diferentes opciones de color.
Puede especificar un solo color o seleccionar un esquema de color continuo (degradado) en función de un valor. El color continuo interpola un color con el porcentaje de un valor en relación con el mínimo y el máximo.
Seleccione una de las siguientes paletas:
| Modo de color | Description (Descripción) |
| --- | --- |
| Color único | Especifique un solo color, útil en una regla de anulación. |
| Sombras de un color | Selecciona tonos de un solo color, lo que resulta útil en una regla de anulación. |
| A partir de umbrales | Indica a Grafana que tome el color del umbral correspondiente. |
| Paleta clásica | Grafana asignará el color mediante la búsqueda de un color en una paleta por índice de series. Útil para gráficos y diagramas circulares y otras visualizaciones de datos categóricos. |
| Paleta clásica (por nombre de serie) | Grafana asignará el color en función del nombre de la serie. Es útil cuando los nombres de las series que se van a visualizar dependen de los datos disponibles. |
| Green-Yellow-Red (por valor) | Combinación de colores continuos |
| Red-Yellow-Green (por valor) | Combinación de colores continuos |
| Blue-Yellow-Red (por valor) | Combinación de colores continuos |
| Amarillo-rojo (por valor) | Combinación de colores continuos |
| Azul-morado (por valor) | Combinación de colores continuos |
| Amarillo-azul (por valor) | Combinación de colores continuos |
| Azules (por valor) | Combinación de colores continuos (fondo del panel a azul) |
| Rojos (por valor) | Combinación de colores continuos (color de fondo del panel a rojo) |
| Verdes (por valor) | Combinación de colores continuos (color de fondo del panel a verde) |
| Morado (por valor) | Combinación de colores continuos (color de fondo del panel a morado) |
## Sin valores
Ingrese lo que Grafana debe mostrar si el valor del campo está vacío o es nulo. El valor por defecto es un guion (-).
# Configuración de una leyenda
****
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).
Un panel incluye una leyenda que puede usar para interpretar los datos que se muestran en una visualización. Cada opción de leyenda agrega contexto y claridad a los datos ilustrados en una visualización.
Las leyendas son compatibles con las siguientes visualizaciones:
+ [Gráfico de barras](v10-panels-bar-chart.md)
+ [Velas](v10-panels-candlestick.md)
+ [Histograma](v10-panels-histogram.md)
+ [Gráfico circular](v10-panels-piechart.md)
+ [Línea temporal de estado](v10-panels-state-timeline.md)
+ [Historial de estado](v10-panels-status-history.md)
+ [Serie temporal](v10-panels-time-series.md)
+ [Tendencia](v10-panels-trend.md)
Los [geomapas](v10-panels-geomap.md) y los [mapas de calor](v10-panels-heatmap.md) también tienen leyendas, pero solo ofrecen la opción de mostrar o no mostrar una leyenda y no admiten otras opciones de leyenda.
## Opciones de leyenda
Encontrará las siguientes opciones en la sección **Leyenda** del panel de edición del panel.
**nota**
No todas las opciones de la lista se aplican a todas las visualizaciones con leyendas.
**Visibilidad**
Defina si la leyenda se mostrará o no. Use el conmutador para activar o desactivar la leyenda.
**Mode (Modo)**
Defina el formato en que se mostrará la leyenda. Elija entre:
+ **Lista**
+ **Tabla**
Al formatear una leyenda como una tabla, es posible que también se muestre otra información sobre la leyenda, como los valores asociados o su ubicación en la visualización.
**Ubicación**
Defina en qué parte de la visualización se mostrará una leyenda. Elija entre:
+ **Bottom**
+ **Right**
**Width (Ancho)**
Si establece la ubicación de la leyenda en la **derecha**, estará disponible la opción **Ancho**. Deje el campo vacío para que Grafana pueda establecer automáticamente el ancho de la leyenda o introducir un valor en el campo.
**Valores**
Para agregar más contexto a una visualización, agregue [cálculos](v10-panels-calculation-types.md) o valores de datos de serie a una leyenda. Puede agregar tantos valores como necesite. Tras aplicar los cambios, puede desplazarse por la leyenda para ver todos los valores.
## Cambio del color de una serie
De forma predeterminada, Grafana establece el color de los datos de la serie, pero puede cambiarlos a través de la leyenda del panel.
**Cambio del color de una serie**
1. Vaya al panel que desee actualizar.
1. En la leyenda, seleccione la barra de colores asociada a la serie.
1. Seleccione un color preestablecido en la pestaña **Colores** o defina un color personalizado en la pestaña **Personalizado** mediante el selector o los valores RGB.
1. Guarde el panel de control.
## Aislamiento de los datos de la serie en una visualización
A menudo, las visualizaciones pueden ser visualmente complejas e incluir muchas series de datos. Para simplificar la vista, elimine los datos de la serie de la visualización mediante la leyenda, que aísla los datos que desea ver. Al hacerlo, Grafana crea automáticamente una nueva anulación en la pestaña **Anulación**.
**Aislamiento de los datos de la serie en una visualización**
1. Vaya al panel que desee actualizar.
1. En la leyenda, seleccione la etiqueta de la serie que quiere aislar.
El sistema elimina de la vista todos los demás datos de la serie.
1. Para volver a agregar datos de serie a una serie aislada de forma incremental, pulse la tecla **Ctrl** o **Comando** y seleccione la etiqueta de la serie que desee agregar.
1. Para guardar los cambios de forma que aparezcan en todos los espectadores del panel, guarde el panel de control.
Para volver a la vista predeterminada que incluye todos los datos, haga clic dos veces en cualquier etiqueta de la serie.
## Ordenación de las series
Al formatear una leyenda como una tabla y agregarle valores, puede ordenar las series de la tabla por esos valores.
**Ordenación de las series**
1. Vaya al panel que desee actualizar.
1. Pase el ratón sobre cualquier parte del panel en el que quiera trabajar para mostrar el menú de acción en la esquina superior derecha del panel.
1. En el menú, elija **Editar**.
1. Desplácese hasta la sección **Leyenda** del panel de edición del panel.
1. En **Valores**, seleccione el valor o el cálculo que desee mostrar.
La leyenda ahora muestra los valores.
1. Elija el encabezado del nombre del cálculo en la tabla de leyendas para ordenar los valores de la tabla en orden ascendente o descendente.
**nota**
Esta característica solo se admite en estos paneles: gráfico de barras, histograma y serie temporal.
# Configuración de enlaces de datos
****
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).
Los enlaces de datos le permiten proporcionar un contexto más detallado a sus enlaces. Puede crear enlaces que incluyan el nombre de la serie o incluso el valor que aparece debajo del cursor. Por ejemplo, si la visualización muestra cuatro servidores, puede agregar un enlace de datos a uno o dos de ellos. También puede enlazar paneles mediante enlaces de datos.
El enlace en sí es accesible de diferentes formas en función de la visualización. Para la visualización de series temporales, por ejemplo, se elige un punto o una línea de datos. Para visualizaciones de áreas grandes, como estadísticas, indicadores o indicadores de barras, puede elegir cualquier parte de la visualización para abrir el menú contextual.
Si solo hay un enlace de datos en la visualización, al seleccionar cualquier parte de la visualización se abre el enlace en lugar del menú contextual.
**Visualizaciones compatibles**
+ Gráfico de barras
+ Indicador de barras
+ Velas
+ Canvas
+ Calibre
+ Geomapa
+ Mapa de calor
+ Histograma
+ Gráfico circular
+ Estadística
+ Línea temporal de estado
+ Historial de estado
+ Tabla
+ Serie temporal
+ Tendencia
## Variables de enlace de datos
Las variables de los enlaces de datos permiten enviar a las personas a un panel de control detallado con filtros de datos conservados. Por ejemplo, puede usar una variable para especificar una etiqueta, un intervalo de tiempo, una serie o una selección de variables.
Para ver una lista de las variables disponibles, escriba `$` en el campo **URL** del enlace de datos.
También puede utilizar variables de plantilla en sus enlaces de datos URLs, consulte[Variables](v10-dash-variables.md).
### Variables de panel de intervalo de tiempo
Estas variables le permiten incluir el intervalo de tiempo actual en la URL del enlace de datos.
+ `__url_time_range`: intervalo de tiempo del panel de control actual (es decir, `?from=now-6h&to=now`).
+ `$__from`: para obtener más información, consulte [Variables globales](v10-dash-variable-add.md#v10-dash-variable-add-global).
+ `$__to`: para obtener más información, consulte [Variables globales](v10-dash-variable-add.md#v10-dash-variable-add-global).
### Variables de serie
Las variables específicas de la serie están disponibles en el espacio de nombres `__series`:
+ `__series.name`: nombre de la serie para la URL.
### Variables de campo
Las variables específicas del campo están disponibles en el espacio de nombres `__field`:
+ `__field.name`: nombre del campo.
+ `__field.labels.