

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 de control en la versión 9 de Grafana
<a name="v9-dashboards"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.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 control es un conjunto de uno o más [paneles](v9-panels.md) organizados y dispuestos en una o más filas. Grafana incluye una variedad de paneles que facilitan la creación de las consultas correctas y la personalización de la visualización para que pueda crear el panel de control perfecto según sus necesidades. Cada panel puede interactuar con los datos de cualquier [Conexión con orígenes de datos](AMG-data-sources.md) configurado.

Las instantáneas del panel de control son estáticas. Las consultas y expresiones no se pueden volver a ejecutar desde las instantáneas. Como resultado, si actualiza alguna variable de la consulta o expresión, no se modificarán los datos del panel de control.

**Topics**
+ [Uso de paneles](v9-dash-using-dashboards.md)
+ [Creación de paneles de control](v9-dash-building-dashboards.md)
+ [Administración de paneles de control](v9-dash-managing-dashboards.md)
+ [Uso compartido de paneles de control y paneles](v9-dash-sharing.md)
+ [Administración de listas de reproducción](v9-dash-managing-playlists.md)
+ [Adición y administración de variables de panel de control](v9-dash-variables.md)
+ [Evaluación del uso del panel de control](v9-dash-assess-dashboard-usage.md)
+ [Búsqueda de paneles de control en la versión 9 de Grafana](v9-search.md)

# Uso de paneles
<a name="v9-dash-using-dashboards"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.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 este tema se ofrece información general de las características y atajos del panel de control y se describe cómo utilizar la búsqueda del panel de control.

## Características
<a name="v9-dash-features"></a>

Puede usar los paneles de control para personalizar la presentación de los datos de los siguientes modos.


|  Característica  |  Description (Descripción)  | 
| --- | --- | 
| **1. Inicio** | Haga clic en el icono de inicio de Grafana para redirigirlo a la página de inicio configurada en la instancia de Grafana. | 
| **2. Title (Título)** | Al hacer clic en el título del panel de control, puede buscar los paneles de control que se incluyen en la carpeta actual. | 
| **3. Uso compartido de un panel de control** | Utilice esta opción para compartir el panel de control actual mediante un enlace o una instantánea. También puede exportar la definición del panel de control desde el modo de compartir. | 
| **4. Adición de un nuevo panel** | Utilice esta opción para agregar un panel, una fila del panel de control o un panel de biblioteca al panel de control actual. | 
| **5. Configuración del panel de control** | Utilice esta opción para cambiar el nombre, la carpeta o las etiquetas del panel de control y administrar las variables y las consultas de anotación. Para obtener más información acerca de la configuración del panel de control, consulte [Modificación de la configuración del panel de control](v9-dash-modify-settings.md). | 
| **6. Menú desplegable del selector de tiempo** |  Haga clic para seleccionar opciones de intervalo de tiempo relativo y establecer intervalos de tiempo absolutos personalizados. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/v9-dash-using-dashboards.html)  | 
| **7. Reducción del intervalo de tiempo**  | Haga clic para reducir el intervalo de tiempo. Para obtener más información sobre cómo usar los controles de intervalo de tiempo, consulte [Configuración del intervalo de tiempo del panel de control](#v9-dash-setting-dashboard-time-range).  | 
| **8. Actualización del panel de control** | Haga clic para activar inmediatamente las consultas y actualizar los datos del panel de control. | 
| **9. Actualización del intervalo de tiempo del panel de control** | Haga clic para seleccionar un intervalo de tiempo de actualización automática del panel de control. | 
| **10. Modo de visualización**  | Haga clic para mostrar el panel de control en una pantalla grande, como un televisor o un quiosco. El modo de visualización oculta información irrelevante, como los menús de navegación.  | 
| **11. Panel del panel de control** |  El componente principal de un panel de control es el panel. Para agregar un nuevo panel, fila del panel de control o panel de biblioteca, seleccione **Agregar panel**. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/v9-dash-using-dashboards.html)  | 
| **12. Leyenda gráfica** | Cambie los colores de las series, el eje Y y la visibilidad de las series directamente desde la leyenda. | 
| **13. Búsqueda de paneles de control** | Haga clic en **Buscar** para buscar los paneles por nombre o título del panel. | 
| **14. Fila del panel de control** | Una fila del panel de control es un separador lógico dentro de un panel de control que agrupa los paneles. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/v9-dash-using-dashboards.html)  | 

## Métodos abreviados de teclado
<a name="v9-dash-keyboard-shortcuts"></a>

Grafana tiene varios atajos de teclado disponibles. Para ver todos los atajos de teclado disponibles, pulse **?** o **h** en el teclado.
+ `Ctrl+S` guarda el panel de control actual. 
+ `f` abre el buscador del panel de control. 
+  `d+k` activa el modo quiosco (oculta el menú). 
+ `d+e` expande todas las filas. 
+ `d+s` abre la configuración del panel de control. 
+ `Ctrl+K` abre la paleta de comandos.
+ `Esc` sale del panel cuando está en modo de edición o vista de pantalla completa. También le devuelve al panel de control desde la configuración del panel de control.

**Panel enfocado**

Para usar atajos dirigidos a un panel específico, pase el cursor sobre un panel.
+ `e` cambia la vista de edición del panel. 
+ `v` cambia la vista de pantalla completa del panel. 
+ `ps` abre la característica de compartir paneles. 
+ `pd` duplica el panel. 
+ `pr` elimina el panel. 
+ `pl` cambia la leyenda del panel. 

## Configuración del intervalo de tiempo del panel de control
<a name="v9-dash-setting-dashboard-time-range"></a>

Grafana proporciona varias formas de administrar los intervalos de tiempo de los datos que se visualizan para el panel de control, los paneles y también las alertas.

En esta sección, se describen las unidades de tiempo y los intervalos relativos compatibles, los controles de tiempo habituales, los ajustes de tiempo de todo el panel de control y los ajustes de tiempo específicos del panel.

**Unidades de tiempo e intervalos relativos**

Grafana admite las siguientes unidades de tiempo: `s (seconds)`, `m (minutes)`, `h (hours)`, `d (days)`, `w (weeks)`, `M (months)`, `Q (quarters)` y `y (years)`. 

El operador menos le permite ir atrás en el tiempo en relación con el momento actual. Si desea mostrar el periodo completo de la unidad (día, semana o mes), agregue `/<time unit>` al final. Para ver los periodos fiscales, utilice `fQ (fiscal quarter)` y las unidades de tiempo `fy (fiscal year)`.

El operador más le permite avanzar en el tiempo en relación con el momento actual. Por ejemplo, puede usar esta característica para ver los datos pronosticados en el futuro.

La siguiente tabla muestra ejemplos de intervalos relativos.


| Ejemplo de intervalo relativo | De | Para | 
| --- | --- | --- | 
| Últimos 5 minutos |  `now-5m`  |  `now`  | 
| El día hasta ahora |  `now/d`  |  `now`  | 
| Esta semana |  `now/w`  |  `now/w`  | 
| Esta semana hasta ahora |  `now/w`  |  `now`  | 
| Este mes |  `now/M`  |  `now/M`  | 
| Este mes hasta ahora |  `now/M`  |  `now`  | 
| Mes anterior |  `now-1M/M`  |  `now-1M/M`  | 
| Este año hasta ahora |  `now/Y`  |  `now`  | 
| Este año |  `now/Y`  |  `now/Y`  | 
| Año fiscal anterior |  `now-1y/fy`  |  `now-1y/fy`  | 

**nota**  
 Grafana Alerting no admite `now+n` para marcas de tiempo futuras ni `now-1n/n` para las marcas de tiempo *inicio de n hasta el final de n*. 

**Controles de intervalo de tiempo comunes**

El panel de control y los controles de tiempo del panel tienen una interfaz de usuario común. A continuación se describen los controles de intervalo de tiempo comunes.
+ El intervalo de tiempo actual, también denominado *selector de tiempo*, muestra el intervalo de tiempo que se muestra actualmente en el panel de control o panel que está viendo. Pase el cursor sobre el campo para ver las marcas de tiempo exactas del intervalo y su origen (por ejemplo, la hora del navegador local). Haga clic en el *intervalo de tiempo actual* para cambiarlo. Para cambiar la hora actual, utilice un *intervalo de tiempo relativo*, como los últimos 15 minutos, o un intervalo de tiempo absoluto, como de `2020-05-14 00:00:00` a `2020-05-15 23:59:59`.
+ El **intervalo de tiempo relativo** se puede seleccionar en la lista **Intervalos de tiempo relativos**. Puede filtrar la lista mediante el campo de entrada de la parte superior. Algunos ejemplos de intervalos de tiempo son: *Últimos 30 minutos*, *Últimas 12 horas*, *Últimos 7 días*, *Últimos 2 años*, *Ayer*, *Anteayer*, *Este día la semana pasada*, *Hoy hasta ahora*, *Esta semana hasta ahora* y *Este mes hasta ahora*.
+ El **intervalo de tiempo absoluto** se puede configurar de dos maneras: escribiendo valores de tiempo exactos o valores de tiempo relativos en los campos **Desde** y **Hasta** y haciendo clic en **Aplicar intervalo de tiempo**, o haciendo clic en una fecha o intervalo de fechas del calendario que se muestra al hacer clic en el campo **Desde** o **Hasta**. Para aplicar las selecciones, haga clic en **Aplicar intervalo de tiempo**.

*Otras características del intervalo de tiempo*

1. Para reducirlo, haga clic en **Cmd \$1 Z** o **Ctrl \$1 Z**. Haga clic en el icono para ver un intervalo de tiempo más amplio en el panel o en la visualización del panel.

1. Para utilizar la característica de zoom, haga clic y arrastre para seleccionar el intervalo de tiempo de la visualización que desee ver.

**nota**  
La ampliación solo se aplica a las visualizaciones de gráficos. 

*Actualizar paneles de control*

Haga clic en el icono **Actualizar panel de control** para ejecutar inmediatamente todas las consultas del panel de control y actualizar las visualizaciones. Grafana cancela cualquier solicitud pendiente cuando activa una actualización.

De forma predeterminada, Grafana no actualiza automáticamente el panel de control. Las consultas se ejecutan según su propio horario de acuerdo con la configuración del panel. Sin embargo, si desea actualizar el panel de control con regularidad, haga clic en la flecha hacia abajo situada junto al icono **Actualizar panel de control** y, a continuación, seleccione un intervalo de actualización.

**Control del intervalo de tiempo mediante una URL**

Para controlar el intervalo de tiempo de un panel de control, proporcione los siguientes parámetros de consulta en la URL del panel de control.
+ `from` define el límite inferior del intervalo de tiempo, especificado en ms epoch, o el [tiempo relativo](#v9-dash-setting-dashboard-time-range).
+ `to` define el límite superior del intervalo de tiempo, especificado en ms epoch, o el tiempo relativo.
+ `time` y `time.window` definen un intervalo de tiempo de `time-time.window/2` a `time+time.window/2`. Ambos parámetros deben especificarse en ms. Por ejemplo, `?time=1500000000000&time.window=10000` dará como resultado un intervalo de tiempo de 10 segundos entre 1499999995000 y 1500000005000.

# Creación de paneles de control
<a name="v9-dash-building-dashboards"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.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).

Después de crear un espacio de trabajo de Grafana e iniciar sesión, puede crear paneles de control y modificar la configuración para adaptarla a sus necesidades. 

**Topics**
+ [Creación de paneles de control](v9-dash-creating.md)
+ [Adición o edición de paneles](v9-dash-edit-panels.md)
+ [Modificación de la configuración del panel de control](v9-dash-modify-settings.md)
+ [Variables de URL de panel de control](v9-dash-dashboard-url-variables.md)
+ [Adición de un panel de biblioteca a su panel de control](v9-dash-manage-library-panels.md)
+ [Administración del historial de versiones del panel de control](v9-dash-manage-version-history.md)
+ [Administración de los enlaces de panel de control](v9-dash-manage-dashboard-links.md)
+ [Modelo JSON del panel de control](v9-dash-dashboard-json-model.md)

# Creación de paneles de control
<a name="v9-dash-creating"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.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).

**Creación de un panel de control**

Los paneles de control y los paneles le permiten mostrar los datos de forma visual con Grafana. Cada panel necesita al menos una consulta para mostrar una visualización. Complete los siguientes requisitos previos antes de comenzar.
+ Asegúrese de que disponga de los permisos necesarios. Para obtener más información sobre los permisos, consulte [Usuarios, equipos y permisos](Grafana-administration-authorization.md).
+ Identifique el panel de control al que desea agregar el panel.
+ Comprenda el lenguaje de consulta del origen de datos de destino.
+ Asegúrese de que se haya agregado el origen de datos para el que está escribiendo una consulta.

 Creación de un panel de control:

1. Inicie sesión en Grafana, coloque el cursor sobre el **panel de control** y haga clic en **\$1 Nuevo panel**.

1. Haga clic en **Agregar un panel nuevo**.

1. En la primera línea de la pestaña **Consulta**, haga clic en la lista desplegable y seleccione un origen de datos.

1. Escriba o cree una consulta en el lenguaje de consulta del origen de datos.

1. En la lista **Visualizaciones**, seleccione un tipo de visualización. Grafana muestra una vista previa de los resultados de la consulta con esa visualización aplicada. Para obtener más información, consulte [Visualizations options](v9-panels-viz.md).

1. Ajuste la configuración del panel de las siguientes formas.
   + [Configuración de asignaciones de valores](v9-panels-configure-value-mappings.md)
   + [Opciones específicas de visualización](v9-panels-viz.md)
   + [Anulación de los valores de los campos](v9-panels-configure-overrides.md)
   + [Configuración de umbrales](v9-panels-configure-thresholds.md)
   + [Configuración de opciones estándar](v9-panels-configure-standard-options.md)
**nota**  
La mayoría de las visualizaciones necesitan algunos ajustes antes de mostrar correctamente la información que necesita.

1. Agregue una nota para describir la visualización (o describir los cambios) y, a continuación, haga clic en **Guardar** en la esquina superior derecha de la página.
**nota**  
Las notas son útiles si necesita revertir el panel de control a una versión anterior.

**Configuración de filas que se repiten**

Puede configurar Grafana para agregar dinámicamente paneles o filas a un panel de control en función del valor de una variable. Las variables cambian las consultas de forma dinámica en todas las filas de un panel de control. Para obtener más información sobre los paneles de repetición, consulte [Configuración de paneles de repetición]().

También puede repetir filas si tiene variables definidas con las opciones `Multi-value` o `Include all values` seleccionadas.

Antes de empezar, asegúrese de que la consulta incluya una variable con varios valores y, a continuación, complete los siguientes pasos.

1. En la página de inicio del panel, haga clic en **Agregar panel**.

1. En el cuadro de diálogo **Agregar un panel**, haga clic en **Agregar una nueva fila**.

1. Pase el ratón sobre el título de la fila y haga clic en el icono del engranaje.

1. En el cuadro de diálogo **Opciones de fila**, agregue un título y seleccione la variable para la que desee agregar filas repetidas.
**nota**  
 Para proporcionar contexto a los usuarios del panel de control, agregue la variable al título de la fila. 

**Desplazamiento de un panel**

1. Abra el panel de .

1. Haga clic en el título del panel y arrástrelo a la nueva ubicación. Puede colocar un panel en un panel de control en cualquier ubicación.

**Cambio de tamaño de un panel**

1. Abra el panel de .

1. Para ajustar el tamaño del panel, seleccione y arrastre la esquina inferior derecha del panel. Puede ajustar el tamaño de un panel del panel de control a sus necesidades.

# Adición o edición de paneles
<a name="v9-dash-edit-panels"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.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).

Una vez que haya creado un panel de control, puede agregar, editar o eliminar los paneles en cualquier momento.
+ **Ver panel**: para ver un panel de control, en el menú **Inicio**, seleccione **Paneles** y, a continuación, elija el que desee ver. Puede que tenga que expandir la carpeta que contiene el panel.
+ **Agregar panel**: para agregar un panel a un panel de control, seleccione el icono de **Agregar panel** en la barra de menú situada cerca de la parte superior de la página.
+ **Editar panel**Para editar un panel existente en un panel de control, elija el icono de menú que aparece al pasar el ratón sobre él y, a continuación, seleccione **Editar**.
+ **Eliminar panel**Para eliminar un panel existente en un panel de control, elija el icono de menú que aparece al pasar el ratón sobre él y, a continuación, seleccione **Eliminar**.

# Modificación de la configuración del panel de control
<a name="v9-dash-modify-settings"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.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 página de configuración del panel de control le permite:
+ Editar las propiedades generales del panel de control, incluida la configuración de hora.
+ Agregue consultas de anotación.
+ Agregue variables de panel de control.
+ Agregue enlaces.
+ Visualización del modelo JSON de panel de control

Acceso a la página de configuración del panel de control:

1. Abra un panel de control en modo de edición.

1. Haga clic en **Configuración del panel** (icono de engranaje) en la parte superior de la página.

**Modificación de la configuración de hora del panel de control**

Ajuste la configuración de hora del panel de control cuando desee cambiar la zona horaria del panel de control o la hora del navegador local y especifique los intervalos de tiempo de actualización automática.

**Modificación de la configuración de hora del panel de control**

1. En la página **Configuración del panel**, seleccione **General**.

1. Vaya a la sección **Opciones de tiempo**.

1. Especifique la configuración de hora de acuerdo con las descripciones siguientes.

1. La zona horaria especifica la zona horaria local del servicio o sistema que está supervisando. Esto puede resultar útil cuando se supervisa un sistema o servicio que funciona en varias zonas horarias.
   + Grafana usa la zona horaria seleccionada *por defecto* para el perfil del usuario, el equipo o la organización. Si no se especifica una zona horaria para el perfil del usuario, el equipo del que es miembro el usuario o la organización, Grafana utiliza la hora local del navegador.
   + Se usa la zona horaria configurada para el navegador del usuario que lo visualiza, la *hora local del navegador*. Suele ser la misma zona horaria que la configurada en el equipo.
   + Utilice las [zonas horarias estándar ISO 8601](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones), incluida la UTC.
+ **Actualización automática** personaliza las opciones que se muestran para una hora relativa y las opciones de actualización automática. Las entradas están separadas por comas y aceptan cualquier unidad de tiempo válida.
+ **Retraso ahora** anula el tiempo `now`, ingrese un retraso. Utilice esta opción para adaptarse a los retrasos conocidos en la agregación de datos y evitar valores nulos.
+ **Ocultar el selector de tiempo** elimina la pantalla del selector de tiempo de Grafana.

**nota**  
Para tener controles de tiempo, los datos deben incluir una columna de tiempo. Consulte la documentación de su [origen de datos](AMG-data-sources.md) específico para obtener más información sobre cómo incluir una columna de tiempo.

**Adición de una consulta de anotación**

Una consulta de anotación es una consulta que busca eventos. Estos eventos se pueden visualizar en gráficos a lo largo del panel de control en forma de líneas verticales junto con un pequeño icono sobre el que puede pasar el ratón para ver la información del evento.

**Adición de una consulta de anotación**

1. En la página **Configuración del panel**, seleccione **Anotaciones**.

1. Seleccione **Agregar consulta de anotación**. 

1. Ingrese un nombre y seleccione un origen de datos.

1. Rellene el resto del formulario para crear una consulta y una anotación.

La interfaz de usuario del editor de consultas cambia en función del origen de datos que seleccione. Consulte la documentación del [origen de datos](AMG-data-sources.md) para obtener más información sobre cómo crear una consulta.

**Adición de una variable**

Las variables le permiten crear paneles de control más interactivos y dinámicos. En lugar de codificar de forma rígida elementos como los nombres de servidores, aplicaciones y sensores en las consultas de métricas, puede utilizar variables en su lugar. Las variables se muestran como listas desplegables en la parte superior del panel de control. Estos menús desplegables facilitan el cambio de datos que se muestran en el panel de control.

Para obtener más información acerca de las variables, consulte [Variables](v9-dash-variables.md).

1. En la página **Configuración del panel**, haga clic en **Variable** en el menú de la sección de la izquierda y, a continuación, en el botón **Agregar variable**.

1. En la sección **General**, agregue el nombre de la variable. Este es el nombre que se utilizará más adelante en las consultas.

1. Seleccione un **tipo** de variable.
**nota**  
El tipo de variable que seleccione afectará a los campos que rellene en la página.

1. Defina la variable y haga clic en **Actualizar**.

**Adición de un enlace**

Los enlaces de panel de control le permiten colocar enlaces a otros paneles de control y sitios web directamente debajo del encabezado del panel de control. Los enlaces facilitan la navegación a otros paneles de control y contenidos relacionados. 

1.  En la página **Configuración del panel**, haga clic en **Enlaces** en el menú de la sección izquierda y, a continuación, pulse el botón **Agregar enlace**. 

1.  Ingrese el título y, en el campo **Tipo**, seleccione **Panel** o **Enlace**. 

1.  Para agregar un enlace de panel de control, agregue una etiqueta opcional, seleccione cualquiera de las opciones del enlace de panel de control y haga clic en **Aplicar**. 
**nota**  
Las etiquetas son útiles para crear un menú desplegable dinámico de paneles de control, todos los cuales tienen una etiqueta específica. 

1.  Para agregar un enlace, agregue una URL y un texto de información sobre herramientas que aparezca cuando el usuario pase el ratón sobre el enlace, seleccione un icono que aparezca junto al enlace y seleccione cualquiera de las opciones de enlace de panel de control. 

**Visualización del modelo JSON de panel de control ** 

Un panel de control en Grafana está representado por un objeto JSON, que almacena los metadatos de su panel de control. Los metadatos del panel de control incluyen sus propiedades, los metadatos de los paneles, las variables de plantilla, las consultas del panel, etc. 

Para ver un modelo JSON de un panel de control, en la página **Configuración del panel**, haga clic en **JSON**.

Para obtener más información acerca de los campos JSON, consulte [Campos JSON](v9-dash-dashboard-json-model.md).

# Variables de URL de panel de control
<a name="v9-dash-dashboard-url-variables"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.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 puede aplicar los valores variables pasados como parámetros de consulta en el panel de control. URLs Para obtener más información, consulte [Manage dashboard links](v9-dash-manage-dashboard-links.md) y [Templates and variables](v9-dash-variables.md).

**Pasar variables como parámetros de consulta**

Grafana interpreta los parámetros de la cadena de consulta con el prefijo `var-` como variables en el panel de control dado.

Por ejemplo, en esta URL: 

```
https://${your-domain}/path/to/your/dashboard?var-example=value
```

El parámetro de consulta `var-example=value` representa el ejemplo de la variable del panel de control con un valor de `value`.

**Pasar varios valores a una variable**

Para pasar varios valores, repita el parámetro de la variable una vez para cada valor.

```
https://${your-domain}/path/to/your/dashboard?var-example=value1&var-example=value2
```

Grafana interpreta `var-example=value1&var-example=value2` como el ejemplo de la variable del panel de control con dos valores: `value1` y `value2`.

**Adición de variables a los enlaces de panel de control**

Grafana puede agregar variables a los enlaces de panel de control cuando las genera a partir de la configuración de un panel de control. Para obtener más información, consulte [Manage dashboard links](v9-dash-manage-dashboard-links.md).

**Pasar filtros ad hoc**

Los filtros ad hoc aplican filtros de clave o valor a todas las consultas de métricas que utilizan un origen de datos específico. Para obtener más información, consulte [Filtros ad hoc]().

Para pasar un filtro ad hoc como parámetro de consulta, utilice la sintaxis de la variable para pasar la variable de filtro ad hoc y proporcione también la clave, el operador como valor y el valor como una lista separada por canalizaciones.

Por ejemplo, en esta URL:

`https://${your-domain}/path/to/your/dashboard?var-adhoc=example_key|=|example_value` 

El parámetro de consulta `var-adhoc=key|=|value` aplica el filtro ad hoc configurado como variable de panel de control ad hoc mediante la clave `example_key`, el operador `=` y el valor `example_value`.

**nota**  
Cuando URLs compartas con filtros ad hoc, recuerda codificar la URL. En el ejemplo anterior, sustituya las canalizaciones `(|)` por `%7C` y el operador de igualdad `(=)` por ` %3D`.

**Control del intervalo de tiempo mediante una URL**

Para establecer el intervalo de tiempo de un panel de control, utilice los parámetros de consulta `from`, `to`, `time` y `time.window`. Como no son variables, no requieren el prefijo `var-`.

# Adición de un panel de biblioteca a su panel de control
<a name="v9-dash-manage-library-panels"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.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 biblioteca es un panel reutilizable que puede usar en cualquier panel de control. Al cambiar un panel de biblioteca, el cambio se propaga a todas las instancias en las que se utilice el panel. Los paneles de biblioteca agilizan la reutilización de los paneles en varios paneles de control.

Puede guardar un panel de biblioteca en una carpeta junto con los paneles de control guardados.

**Creación de un panel de biblioteca**

Al crear un panel de biblioteca, el panel del panel de control de origen también se convierte en un panel de biblioteca. Deberá guardar el panel de control original una vez que se haya convertido el panel.

1. Abra un panel en modo de edición.

1. En las opciones de visualización del panel, haga clic en la opción de flecha hacia abajo para ingresar cambios en la visualización.

1. Para abrir el cuadro de diálogo **Crear**, haga clic en la opción **Paneles de biblioteca** y, a continuación, haga clic en **Crear panel de biblioteca**.

1. En **Nombre del panel de biblioteca**, ingrese el nombre.

1. En **Guardar en carpeta**, seleccione la carpeta en la que se guardará el panel de biblioteca.

1. Para guardar los cambios, haga clic en **Crear panel de biblioteca**.

1. Para guardar el panel de control, haga clic en **Guardar**.

Una vez creado el panel de biblioteca, puede modificar el panel desde cualquier panel de control en el que aparezca. Una vez guardados los cambios, todas las instancias del panel de biblioteca reflejarán estas modificaciones.

**Adición de un panel de biblioteca a un panel de control**

Agregue un panel de biblioteca de Grafana a un panel cuando desee proporcionar visualizaciones a otros usuarios del panel de control.

1. Coloque el cursor sobre la opción **Paneles** en el menú de la izquierda y, a continuación, seleccione **Nuevo panel** en las opciones desplegables. Se abrirá el cuadro de diálogo **Agregar panel**.

1. Haga clic en la opción **Agregar un panel** de la biblioteca de paneles. Verá una lista de los paneles de biblioteca.

1. Filtre la lista o busque el panel que desea agregar.

1. Haga clic en un panel para agregarlo al panel de control.

**Desvincular un panel de biblioteca**

Desvincule un panel de biblioteca cuando desee hacer un cambio en el panel y no afectar a otras instancias del panel de biblioteca.

1. Pase el ratón sobre el **Panel de control** en el menú de la izquierda y, a continuación, haga clic en **Paneles de biblioteca**.

1. Seleccione un panel de biblioteca que se utilice en distintos paneles de control.

1. Seleccione el panel que desea desvincular.

1. Haga clic en el título del panel y, a continuación, en **Editar**. El panel se abre en modo de edición.

1. En la esquina superior derecha de la página, haga clic en **Desvincular**.

**Visualización de una lista de paneles de biblioteca**

Desvincule un panel de biblioteca cuando desee hacer un cambio en el panel y no afectar a otras instancias del panel de biblioteca.

1. Pase el ratón sobre la opción **Panel de control** del menú de la izquierda y, a continuación, haga clic en **Paneles de biblioteca**. Puede ver una lista de paneles de biblioteca previamente definidos.

1. Busque un panel de biblioteca específico si conoce su nombre. También puede filtrar los paneles por carpeta o tipo.

**Eliminación de un panel de biblioteca**

Elimine un panel de biblioteca cuando ya no lo necesite.

1. Pase el ratón sobre el **Panel de control** en el menú de la izquierda y, a continuación, seleccione **Paneles de biblioteca**.

1. Seleccione el panel que desea eliminar.

1. Haga clic en el icono de eliminación junto al nombre de la biblioteca.

# Administración del historial de versiones del panel de control
<a name="v9-dash-manage-version-history"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.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).

Siempre que guarde una versión del panel de control, se guardará una copia de esa versión para que nunca se pierdan las versiones anteriores. Para obtener una lista de estas versiones, ingrese la configuración del panel de control y, a continuación, seleccione **Versiones** en el menú de la izquierda.

La característica de historial de versiones del panel de control le permite comparar y restaurar versiones del panel de control guardadas anteriormente.

**Comparación de dos versiones del panel de control**

Para comparar dos versiones del panel de control, seleccione las dos versiones de la lista que desee comparar. Haga clic en **Comparar versiones** para ver las diferencias entre las dos versiones.

Al hacer clic en el botón, accederá a la vista de diferencias. De forma predeterminada, verá un resumen textual de los cambios.

Para ver la diferencia del JSON sin procesar que representa su panel de control, puede hacer eso y también hacer clic en el botón **Ver diferencias de JSON** en la parte inferior.

Si quiere restaurar la versión con la que está comparando las diferencias, puede hacerlo si pulsa el botón **Restaurar a la versión <x>** en la parte superior derecha.

**Restauración a una versión del panel de control guardada anteriormente**

Si necesita restaurar una versión del panel de control guardada anteriormente, puede hacer clic en el botón **Restaurar** situado a la derecha de una fila de la lista de versiones del panel de control o hacer clic en el botón **Restaurar a la versión <x>** en la vista de diferencias. Al hacer clic en el botón, aparecerá la siguiente ventana emergente en la que se le pedirá que confirme la restauración.

Tras la restauración a una versión anterior, se creará una nueva versión con los mismos datos exactos que la versión anterior, solo que con un número de versión diferente. Esto se indica en la **columna Notas** de la fila de la nueva versión del panel de control. Esto se hace simplemente para garantizar que las versiones anteriores del panel de control no se vean afectadas por el cambio.

# Administración de los enlaces de panel de control
<a name="v9-dash-manage-dashboard-links"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.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 usar los enlaces para navegar entre los paneles de control más utilizados o para conectar otros con sus visualizaciones. Los enlaces le permiten crear accesos directos a otros paneles de control e incluso a sitios web externos.

Grafana admite enlaces de panel de control, enlaces de panel y enlaces de datos. Los enlaces de panel de control se muestran en la parte superior del panel de control. Para acceder a enlaces de paneles, haga clic en un icono situado en la esquina superior izquierda del panel.

**Elección del enlace que se va a utilizar**

Comience por averiguar cómo navega actualmente entre los paneles de control. Si suele pasar de un conjunto de paneles de control a otro y tiene dificultades para encontrar el mismo contexto en cada uno de ellos, los enlaces pueden ayudarle a optimizar el flujo de trabajo.

El siguiente paso es determinar qué tipo de enlace es el adecuado para el flujo de trabajo. Aunque todos los tipos de enlaces de Grafana se utilizan para crear atajos a otros paneles de control o sitios web externos, funcionan en diferentes contextos.
+ Si el enlace se refiere a la mayoría de los paneles (si no a todos) del panel de control, utilice los enlaces de panel de control.
+ Si desea obtener más detalles de paneles específicos, utilice los enlaces de los paneles.
+ Si quiere crear un enlace a un sitio externo, puede usar un enlace de panel de control o un enlace de panel.
+ Si desea obtener más detalles de una serie específica, o incluso de una sola medición, utilice los enlaces de datos.

**Control del intervalo de tiempo mediante una URL**

Para controlar el intervalo de tiempo de un panel o panel de control, puede proporcionar los parámetros de consulta en la URL del panel de control:
+ `from` define el límite inferior del intervalo de tiempo, especificado en ms epoch.
+ `to` define el límite superior del intervalo de tiempo, especificado en ms epoch.
+ `time` y `time.window` definen un intervalo de tiempo de `time-time.window/2` a `time+time.window/2`. Ambos parámetros deben especificarse en ms. Por ejemplo, `?time=1500000000000&time.window=10000` dará como resultado un intervalo de tiempo de 10 segundos entre 1499999995000 y 1500000005000.

**Enlaces de panel de control**

Al crear un enlace de panel de control, puede incluir el intervalo de tiempo y las variables de la plantilla actual para pasar directamente al mismo contexto en otro panel de control. De esta forma, no tendrá que preocuparse de si la persona a la que le envía el enlace está viendo los datos correctos. Para ver otros tipos de enlaces, consulte [Variables de enlace de datos]().

Los enlaces del panel de control también se pueden usar como accesos directos a sistemas externos, por ejemplo, para enviar [un GitHub problema con el nombre del panel actual](https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests).

Después de agregar un enlace de panel de control, aparece en la esquina superior derecha del panel de control.

**Adición de enlaces a paneles de control**

Agregue enlaces a otros paneles de control en la parte superior del panel de control actual.

1. Mientras ve el panel al que desea crear un enlace, haga clic en el icono de engranaje ubicado en la parte superior de la pantalla para abrir **Configuración del panel**.

1. Haga clic en **Enlaces** y, a continuación, seleccione **Agregar enlace de panel de control** o **Nuevo**.

1. En **Tipo**, seleccione **paneles de control**.

1. Seleccione entre las opciones de enlace siguientes.
   + **Con etiquetas**: ingrese etiquetas para limitar los paneles de control enlazados a solo aquellos con las etiquetas que haya ingresado. De lo contrario, Grafana incluye enlaces a todos los demás paneles de control.
   + **Como menú desplegable**: seleccione esta opción si va a enlazar varios paneles y agregue un título opcional a la lista desplegable. De lo contrario, Grafana muestra los enlaces del panel de control en paralelo en la parte superior del panel.
   + **Intervalo de tiempo**: seleccione esta opción para incluir el intervalo de tiempo del panel de control en el enlace. Cuando el usuario hace clic en el enlace, el panel de control enlazado se abre con el intervalo de tiempo indicado ya establecido.
   + **Valores variables**: seleccione esta opción para incluir en el enlace las variables de plantilla que se utilizan actualmente como parámetros de consulta. Cuando el usuario hace clic en el enlace, todas las plantillas coincidentes del panel de control vinculado se configuran con los valores del enlace. Para obtener más información, consulte [Variables de URL de panel de control](v9-dash-dashboard-url-variables.md).
   + **Abrir en una pestaña nueva**: seleccione esta opción para abrir el enlace de panel de control en una nueva pestaña o ventana.

1. Haga clic en **Add (Añadir)**.

**Adición de un enlace URL a un panel de control**

Agregue un enlace a una URL en la parte superior del panel de control actual. Puede vincularlo a cualquier URL disponible, incluidos los paneles de control, los paneles o los sitios externos. Incluso puede controlar el intervalo de tiempo para garantizar que el usuario amplíe los datos correctos en Grafana.

1. Mientras ve el panel al que desea crear un enlace, haga clic en el icono de engranaje ubicado en la parte superior de la pantalla para abrir **Configuración del panel**.

1. Haga clic en **Enlaces** y, a continuación, seleccione **Agregar enlace de panel de control** o **Nuevo**.

1. En Tipo, seleccione **Enlace**.

1. Seleccione entre las opciones de enlace siguientes.
   + **URL**: ingrese la URL a la que quiere vincular. Según el destino, es posible que desee incluir valores de campo. Para obtener más información, consulte este [ejemplo de GitHub](https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests).
   + **Título**: ingrese el título que desee que muestre el enlace.
   + **Información sobre herramientas**: ingrese la información sobre herramientas que desee que muestre el enlace.
   + **Icono**: elija el icono que desee que aparezca junto con el enlace.
   + **Intervalo de tiempo**: seleccione esta opción para incluir el intervalo de tiempo del panel de control en el enlace. Cuando el usuario hace clic en el enlace, el panel de control enlazado se abre con el intervalo de tiempo indicado establecido.
     + `from` define el límite inferior del intervalo de tiempo, especificado en ms epoch.
     + `to` define el límite superior del intervalo de tiempo, especificado en ms epoch.
     + `time` y `time.window` definen un intervalo de tiempo de `time-time.window/2` a `time+time.window/2`. Ambos parámetros deben especificarse en ms. Por ejemplo, `?time=1500000000000&time.window=10000` dará como resultado un intervalo de tiempo de 10 segundos entre 1499999995000 y 1500000005000.
   + **Valores variables**: seleccione esta opción para incluir en el enlace las variables de plantilla que se utilizan actualmente como parámetros de consulta. Cuando el usuario hace clic en el enlace, todas las plantillas coincidentes del panel de control vinculado se configuran con los valores del enlace. 

     El formato de la variable es el siguiente: 

     `https://${you-domain}/path/to/your/dashboard?var-${template-varable1}=value1&var-{template-variable2}=value2`
   + **Abrir en una pestaña nueva**: seleccione esta opción para abrir el enlace de panel de control en una nueva pestaña o ventana.

1. Haga clic en **Add (Añadir)**.

**Actualización de un enlace de panel de control**

Para cambiar o actualizar un enlace de panel de control existente, use este procedimiento.

1. En **Configuración del panel**, en la pestaña **Enlaces**, haga clic en el enlace existente que desee editar.

1. Cambie la configuración y, a continuación, haga clic en **Actualizar**.

**Duplicación de un enlace de panel de control**

Para duplicar un enlace de panel de control existente, haga clic en el icono de duplicado situado junto al enlace existente que desee duplicar.

**Eliminación de un enlace de panel de control**

Para eliminar un enlace de panel de control existente, haga clic en el icono de la papelera del enlace que desea eliminar.

**Enlaces de panel**

Cada panel puede tener su propio conjunto de enlaces que se muestran en la esquina superior izquierda del panel. Puede vincularlo a cualquier URL disponible, incluidos los paneles de control, los paneles o los sitios externos. Incluso puede controlar el intervalo de tiempo para garantizar que el usuario amplíe los datos correctos en Grafana.

Para ver los enlaces de los paneles disponibles, haga clic en el icono de la esquina superior izquierda de un panel.
+ **Adición de un enlace de panel**: cada panel puede tener su propio conjunto de enlaces que se muestran en la esquina superior izquierda del panel. Puede vincularlo a cualquier URL disponible, incluidos los paneles de control, los paneles o los sitios externos. Incluso puede controlar el intervalo de tiempo para garantizar que el usuario amplíe los datos correctos en Grafana. Haga clic en el icono de la esquina superior izquierda de un panel para ver los enlaces de panel disponibles.

  1. Pase el cursor del ratón sobre el panel en el que desee agregar un enlace y pulse `e`. O bien, haga clic en la flecha desplegable situada junto al título del panel y, a continuación, haga clic en **Editar**.

  1. En la pestaña **Panel**, desplácese hacia abajo hasta la sección **Enlaces**. 

  1. Expanda **Enlaces** y, a continuación, haga clic en **Agregar enlace**.

  1. Ingrese un **título**. **Título** es una etiqueta legible del enlace que se mostrará en la interfaz de usuario.

  1. Ingrese la **URL** a la que quiere enlazar. Incluso puede agregar una de las variables de plantilla que se hayan definido en el panel de control. Pulse `Ctrl+Space` o `Cmd+Space` y haga clic en el campo de la URL para ver las variables disponibles. Al agregar variables de plantilla al enlace del panel, el enlace envía al usuario al contexto correcto, con las variables relevantes ya configuradas.

     También puede utilizar variables de tiempo.
     + `from` define el límite inferior del intervalo de tiempo, especificado en ms epoch.
     + `to` define el límite superior del intervalo de tiempo, especificado en ms epoch.
     + `time` y `time.window` definen un intervalo de tiempo de `time-time.window/2` a `time+time.window/2`. Ambos parámetros deben especificarse en ms. Por ejemplo, `?time=1500000000000&time.window=10000` dará como resultado un intervalo de tiempo de 10 segundos entre 1499999995000 y 1500000005000.
+ **Actualización de un enlace de panel**

  1. En la pestaña **Panel**, busque el enlace en el que desea hacer cambios.

  1. Haga clic en el icono **Editar** (lápiz) para abrir la ventana Editar enlace.

  1. Realice los cambios necesarios.

  1. Haga clic en **Guardar** para guardar los cambios y cerrar la ventana.

  1. Haga clic en **Guardar** en la esquina superior derecha para guardar los cambios en el panel de control.
+ **Eliminación de un enlace de panel**

  1. En la pestaña **Panel**, busque el enlace en el que desea hacer cambios.

  1. Haga clic en el icono **X** situado al lado del enlace que desea eliminar.

  1. Haga clic en **Guardar** en la esquina superior derecha para guardar los cambios en el panel de control.

# Modelo JSON del panel de control
<a name="v9-dash-dashboard-json-model"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.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 control en Grafana está representado por un objeto JSON, que almacena los metadatos de su panel de control. Los metadatos del panel incluyen las propiedades del panel de control, los metadatos de los paneles, las variables de plantilla y las consultas del panel.

Para ver el JSON de un panel de control:

1. Vaya a un panel de control.

1. En el menú de navegación superior, haga clic en el icono de **Configuración del panel** (engranaje).

1. Haga clic en **Modelo JSON**.

**Campos JSON**

Cuando un usuario crea un panel de control nuevo, se inicializa un nuevo objeto JSON del panel de control con los siguientes campos.

**nota**  
En el siguiente JSON, el ID se muestra como null, que es el valor predeterminado que se le asigna hasta que se guarde un panel de control. Tras guardar un panel de control, se asigna un valor entero al campo `id`.

```
{
  "id": null,
  "uid": "cLV5GDCkz",
  "title": "New dashboard",
  "tags": [],
  "style": "dark",
  "timezone": "browser",
  "editable": true,
  "graphTooltip": 1,
  "panels": [],
  "time": {
    "from": "now-6h",
    "to": "now"
  },
  "timepicker": {
    "time_options": [],
    "refresh_intervals": []
  },
  "templating": {
    "list": []
  },
  "annotations": {
    "list": []
  },
  "refresh": "5s",
  "schemaVersion": 17,
  "version": 0,
  "links": []
}
```

A continuación, se describe cada campo del JSON del panel de control.


| Name | De uso | 
| --- | --- | 
| **id** | identificador numérico único del panel de control (generado por la base de datos). | 
| **uid** | identificador único del panel de control que cualquier persona puede generar. cadena (8-40). | 
| **title** | título actual del panel de control. | 
| **etiquetas** | etiquetas asociadas al panel de control, una matriz de cadenas. | 
| **estilo** | tema del panel de control, como *oscuro* o *claro*. | 
| **timezone** | zona horaria del panel de control, como *utc* o *navegador*. | 
| **editable** | si un panel de control es editable o no. | 
| **graphTooltip** | 0 si no se comparte el punto de mira o la información sobre herramientas (predeterminado), 1 si se comparte el punto de mira, 2 si se comparte el punto de mira o la información sobre herramientas compartida. | 
| **time** | intervalo de tiempo del panel de control, como *últimas 6 horas* o *últimos 7 días*. | 
| **timepicker** | metadatos del selector de tiempo; consulte la [sección del selector de tiempo](#v9-dash-dashboard-json-model) para obtener más información. | 
| **templating** | metadatos de plantillas; consulte la [sección de plantillas](#v9-dash-dashboard-json-model) para obtener más información. | 
| **annotations** | metadatos de anotaciones; consulte las [anotaciones](v9-panels-annotate-visualizations.md) para saber cómo agregarlos. | 
| **refresh** | intervalo de actualización automática. | 
| **schemaVersion** | versión del esquema JSON (entero), que se incrementa cada vez que una actualización de Grafana cambia a dicho esquema. | 
| **versión** | versión del panel de control (entero), que se incrementa cada vez que se actualiza el panel de control. | 
| **panels** | conjunto de paneles (consulte los detalles a continuación). | 

**Paneles**

Los paneles son los componentes básicos de un panel de control. Consiste en consultas de orígenes de datos, tipos de gráficos, alias, etc. El JSON del panel consta de una matriz de objetos JSON, cada uno de los cuales representa un panel diferente. La mayoría de los campos son comunes a todos los paneles, pero algunos campos dependen del tipo de panel. El siguiente es un ejemplo del JSON del panel de un panel de texto.

```
"panels": [
  {
    "type": "text",
    "title": "Panel Title",
    "gridPos": {
      "x": 0,
      "y": 0,
      "w": 12,
      "h": 9
    },
    "id": 4,
    "mode": "markdown",
    "content": "# title"
  }
```

**Tamaño y posición del panel**

La propiedad gridPos describe el tamaño y la posición del panel en las coordenadas de la cuadrícula.
+ `w`: de 1 a 24 (el ancho del panel de control se divide en 24 columnas).
+ `h`: cada unidad de altura de la tabla representa 30 píxeles.
+ `x`: la posición de x, en la misma unidad que `w`.
+ `y`: la posición de y, en la misma unidad que `h`.

La cuadrícula tiene una gravedad negativa que mueve los paneles hacia arriba si hay un espacio vacío por encima de un panel.

**Selector de tiempo**

```
"timepicker": {
    "collapse": false,
    "enable": true,
    "notice": false,
    "now": true,
    "refresh_intervals": [
      "5s",
      "10s",
      "30s",
      "1m",
      "5m",
      "15m",
      "30m",
      "1h",
      "2h",
      "1d"
    ],
    "status": "Stable",
    "type": "timepicker"
  }
```

**Plantillas **

El campo `templating` contiene un conjunto de variables de plantilla con los valores guardados junto con otros metadatos.

```
"templating": {
    "enable": true,
    "list": [
       {
        "allFormat": "wildcard",
        "current":  {
          "tags": [],
          "text": "prod",
          "value": "prod"
        },
        "datasource": null,
        "includeAll": true,
        "name": "env",
        "options": [
           {
            "selected": false,
            "text": "All",
            "value": "*"
          },
           {
            "selected": false,
            "text": "stage",
            "value": "stage"
          },
           {
            "selected": false,
            "text": "test",
            "value": "test"
          }
        ],
        "query": "tag_values(cpu.utilization.average,env)",
        "refresh": false,
        "type": "query"
      },
       {
        "allFormat": "wildcard",
        "current":  {
          "text": "apache",
          "value": "apache"
        },
        "datasource": null,
        "includeAll": false,
        "multi": false,
        "multiFormat": "glob",
        "name": "app",
        "options": [
           {
            "selected": true,
            "text": "tomcat",
            "value": "tomcat"
          },
           {
            "selected": false,
            "text": "cassandra",
            "value": "cassandra"
          }
        ],
        "query": "tag_values(cpu.utilization.average,app)",
        "refresh": false,
        "regex": "",
        "type": "query"
      }
    ]
  }
```

# Administración de paneles de control
<a name="v9-dash-managing-dashboards"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.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 control es un conjunto de uno o más [paneles](v9-panels.md) que presenta visualmente los datos en una o varias filas.

Para obtener más información sobre la creación de paneles, consulte [Add and organize panels]().

## Creación de carpetas de panel de control
<a name="v9-dash-create-dashboard-folder"></a>

Las carpetas ayudan a organizar y agrupar los paneles de control, lo que resulta útil cuando tiene varios paneles de control o varios equipos que utilizan la misma instancia de Grafana.

**Requisitos previos**

Asegúrese de tener permisos de administrador de Grafana. Para obtener más información acerca de los permisos de los paneles de control, consulte [Permisos del panel](Grafana-administration-authorization.md).

**Creación de una carpeta de panel de control**

1. Inicie sesión en Grafana y, en el menú lateral, haga clic en **Paneles > Nueva carpeta**.

1. Ingrese un nombre único y haga clic en **Crear**.

**nota**  
Al guardar un panel de control, puede seleccionar una carpeta para guardarlo o crear una nueva.

## Administración de paneles y carpetas
<a name="v9-dash-manage-dashboard-folder"></a>

En la página **Administrar paneles y carpetas**, puede:
+ Crear una carpeta
+ Creación de un panel
+ Mover los paneles de control a las carpetas
+ Eliminar varios paneles de control
+ Navegar a la página de una carpeta, donde puede asignar los permisos de la carpeta o del panel de control

**Página Carpeta de panel de control**

En la página **Carpeta del panel de control**, puede llevar a cabo las siguientes tareas:
+ Mover o eliminar los paneles de una carpeta.
+ Cambiar el nombre de una carpeta (disponible en la pestaña **Configuración**).
+ Asignar permisos a las carpetas (que los paneles de control de la carpeta heredan).

Para ir a la página de la carpeta del panel, haga clic en el icono de engranaje que aparece al pasar el ratón sobre una carpeta en la lista de resultados de búsqueda del panel o en la página **Administrar paneles y carpetas**.

**Permisos del panel**

Puede asignar permisos a una carpeta. Los permisos que le asigne son heredados por los paneles de control de la carpeta. Se utiliza una lista de control de acceso (ACL) donde se pueden asignar permisos a **Rol de la organización**, **Equipo** y **Usuario**.

Consulte [Permisos](Grafana-permissions.md) para obtener más información.

## Importación y exportación de paneles
<a name="v9-dash-export-import-dashboards"></a>

Puede usar la interfaz de usuario de Grafana o la API HTTP para exportar e importar paneles de control.

**Exportación de un panel de control**

La acción de exportación del panel de control crea un archivo JSON de Grafana que contiene todo lo que necesita, incluido el diseño, las variables, los estilos, los orígenes de datos, las consultas, etc., para que luego pueda importar el panel de control.

**nota**  
Grafana descarga un archivo JSON en la máquina local. 

1. Abra el panel que desee exportar.

1. Seleccione el icono de compartir.

1. Seleccione **Exportar**.

1. Elija **Guardar en el archivo**.

**Cómo hacer que un panel de control sea portátil**

Si quiere exportar un panel de control para que lo usen otros usuarios, puede agregar variables de plantilla para valores como un prefijo métrico (utilice una variable constante) y un nombre de servidor.

Una variable de plantilla del tipo `Constant` se ocultará automáticamente en el panel de control y también se agregará como entrada obligatoria cuando se importe el panel de control.

**Importación de un panel**

1. Seleccione **Paneles** en el menú lateral.

1. Seleccione **Nuevo** y elija **Importar** en el menú desplegable.

1. Lleve a cabo uno de los siguientes pasos.
   + Suba un archivo JSON del panel de control.
   + Pegue el URL del panel de control de [Grafana.com](https://grafana.com/).
   + Pegue el texto JSON del panel de control directamente en el área de texto.

   El proceso de importación le permite cambiar el nombre del panel de control, elegir el origen de datos que quiere que utilice el panel y especificar cualquier prefijo métrico (en el caso de que el panel lo use).

## Solución de problemas de paneles de control
<a name="v9-dash-troubleshooting"></a>

En esta sección se proporciona información útil para resolver los problemas más comunes del panel de control. 

**El panel de control funciona con lentitud**

Si el panel de control va lento, tenga en cuenta lo siguiente:
+ ¿Está intentando renderizar docenas (o cientos o miles) de series temporales en un gráfico? Esto puede provocar que el navegador se retrase. Intente usar funciones como highestMax (en Graphite) para reducir el número de series devueltas.
+ A veces, los nombres de las series pueden ser muy grandes. Esto provoca tamaños de respuesta más grandes. Intente usar alias para reducir el tamaño de los nombres de las series devueltas.
+ ¿Está consultando muchas series temporales o un intervalo de tiempo largo? Ambas condiciones pueden provocar que Grafana o el origen de datos extraigan una gran cantidad de datos, lo que puede ralentizarlos.
+ Podría haber una gran carga en la infraestructura de la red. Si la lentitud no es constante, este podría ser el problema.

**Problemas de la frecuencia de la actualización del panel de control**

De forma predeterminada, Grafana consulta el origen de datos cada 30 segundos. Establecer una frecuencia de actualización baja en los paneles de control supone un estrés innecesario para el backend. En muchos casos, no es necesario consultarlo con frecuencia porque los datos no se envían al sistema de forma que se puedan ver los cambios.

Si tiene este problema, se recomiendan las siguientes soluciones.
+ No habilite la actualización automática en los paneles de control, paneles o variables a menos que la necesite. Los usuarios pueden actualizar su navegador manualmente o puede configurar la frecuencia de actualización en un periodo de tiempo que tenga sentido (por ejemplo, cada 10 minutos o cada hora).
+ Si es necesario, establezca la frecuencia de actualización en una vez por minuto. Los usuarios pueden actualizar el panel de forma manual en cualquier momento.
+ Si el panel de control tiene configurado un periodo de tiempo más largo (por ejemplo, una semana), es posible que no sea necesaria la actualización automática.

**Gestión o renderización de datos nulos incorrecta o confusa**

Algunas aplicaciones publican datos de forma intermitente. Por ejemplo, solo publican una métrica cuando se produce un evento. De forma predeterminada, los gráficos de Grafana conectan líneas entre los puntos de datos.

# Uso compartido de paneles de control y paneles
<a name="v9-dash-sharing"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.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 compartir paneles de control y paneles con otros usuarios de una organización y, en determinadas situaciones, públicamente en la web. Puede compartir mediante:
+ Un enlace directo
+ Una instantánea
+ Un enlace de exportación (solo para paneles de control)

Debe tener un permiso de visualización autorizado para ver una imagen renderizada mediante un enlace directo.

También se requiere el mismo permiso para ver los enlaces incrustados, a menos que tenga habilitado el permiso de acceso anónimo para su instancia de Grafana.

Cuando comparte un panel o un panel de control como una instantánea, una instantánea (que es un panel o un panel de control en el momento en que toma la instantánea) está disponible públicamente en la web. Cualquier persona que tenga un enlace a él puede acceder a él. Como las instantáneas no requieren ninguna autorización para verlas, Grafana elimina la información relacionada con la cuenta de la que provienen, así como cualquier dato confidencial de la instantánea.

## Uso compartido de un panel de control
<a name="v9-dash-share-dashboard"></a>

Puede compartir un panel de control como un enlace directo o como una instantánea. También puede exportar un panel de control.

**nota**  
Si cambia un panel de control, asegúrese de guardar los cambios antes de compartirlo.

1. Vaya a la página de inicio de su instancia de Grafana.

1. Haga clic en el icono de compartir en la barra de navegación superior.

   Se abre el cuadro de diálogo para compartir y muestra la pestaña **Enlace**.

**Uso compartido de un enlace directo**

La pestaña **Enlace** muestra el intervalo de tiempo actual, las variables de la plantilla y el tema predeterminado. También puede compartir una URL abreviada.

1. Haga clic en **Copy**. Esta acción copia la URL predeterminada o abreviada en el portapapeles.

1. Envíe la URL copiada a un usuario de Grafana con autorización para ver el enlace.

**Publicación de una instantánea**

Una instantánea del panel de control comparte un panel de control interactivo de forma pública. Grafana elimina los datos confidenciales, como las consultas (métricas, plantillas y anotaciones) y los enlaces de los paneles para dejar solo los datos de métricas visibles y los nombres de las series incrustados en el panel de control. Cualquier persona que tenga el enlace puede acceder a las instantáneas del panel de control.

Puede publicar instantáneas en su instancia local.

1. Haga clic en **Instantánea local**.

1. Grafana genera un enlace de la instantánea. Copie el enlace de la instantánea y compártalo dentro de la organización o públicamente en la web.

**Exportación de un panel de control**

Los paneles de control de Grafana se pueden exportar e importar fácilmente. Para obtener más información, consulte [Export and import dashboards](v9-dash-managing-dashboards.md#v9-dash-export-import-dashboards).

## Uso compartido de un panel
<a name="v9-dash-share-panel"></a>

Puede compartir un panel como un enlace directo o como una instantánea. También puede crear paneles de biblioteca mediante la opción **Compartir** para cualquier panel.

1. Haga clic en el título de un panel para abrir el menú del panel.

1. Haga clic en **Compartir**. Se abre el cuadro de diálogo para compartir y muestra la pestaña **Enlace**.

**Uso de un enlace directo**

La pestaña **Enlace** muestra el intervalo de tiempo actual, las variables de la plantilla y el tema predeterminado. Si lo desea, puede habilitar una URL abreviada para compartir. 

1. Haga clic en **Copiar** para copiar la URL predeterminada o abreviada en el portapapeles. 

1. Envíe la URL copiada a un usuario de Grafana con autorización para ver el enlace.

1. También tiene la opción de clicar en la **imagen renderizada mediante enlace directo** para compartir una imagen del panel.

**Consulta de parámetros de cadena para imágenes renderizadas en el servidor**
+ **ancho**: ancho en píxeles. El valor predeterminado es 800.
+ **altura**: altura en píxeles. El valor predeterminado es 400.
+ **tz**: zona horaria en formato `UTC%2BHH%3AMM` donde HH y MM están desplazados en horas y minutos después de la UTC.
+ **tiempo de espera**: número de segundos. El tiempo de espera se puede aumentar si la consulta del panel necesita más de los 30 segundos de forma predeterminada.
+ **escala**: valor numérico para configurar el factor de escala del dispositivo. El valor predeterminado es 1. Utilice un valor más alto para producir imágenes más detalladas (DPI más alto). Compatible con Grafana v7.0 y posteriores.

**Publicación de una instantánea**

La instantánea de un panel comparte públicamente un panel interactivo. Grafana elimina los datos confidenciales para dejar solo los datos de métricas visibles y los nombres de las series incrustados en el panel de control. Cualquier persona que tenga el enlace puede acceder a las instantáneas del panel.

Puede publicar instantáneas en su instancia local.

1. En el cuadro de diálogo **Compartir panel**, haga clic en **Instantánea** para abrir la pestaña.

1. Haga clic en **Instantánea local**. Grafana genera el enlace de la instantánea.

1. Copie el enlace de la instantánea y compártalo dentro de la organización o públicamente en la web.

Si ha creado una instantánea por error, haga clic en **Eliminar instantánea** para eliminarla de la instancia de Grafana.

**Creación de un panel de biblioteca**

Creación de un panel de biblioteca desde el cuadro de diálogo **Compartir panel**.

1. Haga clic en **Panel de biblioteca**.

1. En **Nombre del panel de biblioteca**, ingrese el nombre.

1. En **Guardar en carpeta**, seleccione la carpeta en la que desee guardar el panel de biblioteca. De forma predeterminada, se selecciona la carpeta **General**.

1. Seleccione **Crear panel de biblioteca** para guardar los cambios.

1. Haga clic en **Guardar** para guardar el panel de control.

# Administración de listas de reproducción
<a name="v9-dash-managing-playlists"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.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).

Una *lista de reproducción* es una lista de paneles de control que se muestran en secuencia. Puede usar una lista de reproducción para crear conciencia situacional o para presentar sus métricas a su equipo o a los visitantes. Grafana escala automáticamente los paneles de control a cualquier resolución, lo que los hace perfectos para pantallas grandes. Puede acceder a la característica de lista de reproducción desde el menú lateral de Grafana, en el submenú **Paneles**.

## Acceso, uso compartido y control de una lista de reproducción
<a name="v9-dash-access-share-control-playlist"></a>

Utilice la información de esta sección para acceder a las listas de reproducción existentes. Inicie y controle la visualización de una lista de reproducción mediante uno de los cinco modos disponibles.

**Acceso a una lista de reproducción**

1. Pase el cursor del ratón sobre el menú lateral de Grafana.

1. Haga clic en **Listas de reproducción**.

   Verá una lista de las listas de reproducción existentes.

**Inicio de una lista de reproducción**

Puede iniciar una lista de reproducción en cinco modos de visualización diferentes. El modo de visualización determina cómo se muestran los menús y la barra de navegación en los paneles de control.

De forma predeterminada, cada panel se muestra durante el tiempo introducido en el campo **Intervalo**, que se puede configurar al crear o editar una lista de reproducción. Tras iniciar una lista de reproducción, puede controlarla mediante la barra de navegación situada en la parte superior de la página.

La lista de reproducción muestra cada panel durante el tiempo especificado en el campo `Interval`, establecido al crear o editar una lista de reproducción. Tras iniciar una lista de reproducción, puede controlarla mediante la barra de navegación situada en la parte superior de la pantalla.

1. Acceda a la página de listas de reproducción para ver una lista de las listas de reproducción existentes.

1. Busque la lista de reproducción que quiere iniciar y, a continuación, haga clic en **Iniciar lista de reproducción**.

   Se abrirá el cuadro de diálogo de inicio de la lista de reproducción.

1. Seleccione uno de los cinco modos de lista de reproducción disponibles según la información de la tabla siguiente.

1. Haga clic en Iniciar.


| Mode | Description (Descripción) | 
| --- | --- | 
| Modo normal |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 
| Modo TV |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 
| Modo TV (con paneles de ajuste automático) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 
| Modo quiosco |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 
| Modo quiosco (con paneles de ajuste automático) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 

**Control de una lista de reproducción**

Puede controlar una lista de reproducción en modo **Normal** o **TV** después de que se haya iniciado mediante la barra de navegación situada en la parte superior de la pantalla. Pulse la tecla `Esc` del teclado para detener la lista de reproducción.


| Button | Action | 
| --- | --- | 
| Siguiente (doble flecha hacia la derecha) | Avanza al siguiente panel de control. | 
| Atrás (flecha izquierda) | Vuelve al panel anterior. | 
| Parar (cuadrado) | Finaliza la lista de reproducción y sale al panel de control actual. | 
| Modo de visualización cíclica (icono del monitor) | Rota la visualización de los paneles a distintos modos de visualización. | 
| Intervalo de tiempo | Muestra los datos dentro de un intervalo de tiempo. Se puede configurar para que muestre los últimos 5 minutos hasta hace 5 años, o un intervalo de tiempo personalizado, mediante la flecha desplegable. | 
| Actualizar (flecha circular) | Recarga el panel para mostrar los datos actuales. Se puede configurar para que se recargue automáticamente, de cada 5 segundos a 1 día, mediante la flecha desplegable. | 

## Creación de una lista de reproducción
<a name="v9-dash-create-playlist"></a>

Una lista de reproducción presenta los paneles en una secuencia, con un orden establecido y un intervalo de tiempo entre los paneles.

1. Haga clic en **Nueva lista de reproducción** en la página de listas de reproducción.

1. Ingrese un nombre descriptivo en el cuadro de texto **Nombre**.

1. Ingrese un intervalo de tiempo en el cuadro de texto **Intervalo**.
**nota**  
Los paneles de control que agregue se muestran en orden secuencial.

1. En **Paneles**, agregue los paneles de control existentes a la lista de reproducción mediante las opciones desplegables **Agregar por título** y **Agregar por etiqueta**.

1. Opcionalmente:
   + Busque un panel por su nombre, una expresión regular o una etiqueta.
   + Filtre los resultados por estado destacado o por etiquetas.
   + Reorganice el orden de los paneles de control que ha agregado con el icono de flecha arriba y abajo.
   + Para eliminar un panel de control de la lista de reproducción, haga clic en el icono de **X** situado junto al panel.

1. Haga clic en **Save** para guardar sus cambios.

## Guardado de una lista de reproducción
<a name="v9-dash-save-playlist"></a>

Puede guardar una lista de reproducción para agregarla a su página de **Listas de reproducción**, donde podrá iniciarla.

**importante**  
Asegúrese de agregar todos los paneles que desee que aparezcan en la lista de reproducción al crear o editar la lista de reproducción antes de guardarla.

1. Para acceder a la característica de lista de reproducción, pase el cursor sobre el menú lateral de Grafana.

1. Haga clic en **Listas de reproducción** para ver las listas de reproducción disponibles.

1. Haga clic en la lista de reproducción que quiera.

1. Edite la lista de reproducción.

1. Compruebe que la lista de reproducción tenga un **nombre**, un **intervalo** y al menos un **panel de control**.

1. Haga clic en **Save** para guardar sus cambios.

## Edición o eliminación de una lista de reproducción
<a name="v9-dash-edit-delete-playlist"></a>

Para editar una lista de reproducción, actualice su nombre, el intervalo de tiempo y agregue, elimine y reorganice el orden de los paneles de control.

**Edición de una lista de reproducción**

1. Haga clic en **Editar lista de reproducción** en la página de listas de reproducción.

1. Actualice el nombre y el intervalo de tiempo y, a continuación, siga las instrucciones que aparecen más arriba en Creación de una lista de reproducción para agregar o eliminar paneles de control de la lista de reproducción.

1. Haga clic en **Save** para guardar sus cambios.

**Eliminación de una lista de reproducción**

1. Haga clic en **Listas de reproducción**.

1. Haga clic en **Eliminar** junto a la lista de reproducción que desea eliminar.

**Reorganización del orden del panel de control**

1. Junto al panel de control que desea mover, haga clic en la flecha hacia arriba o hacia abajo.

1. Haga clic en **Save** para guardar sus cambios.

**Eliminación de un panel de control**

1. Haga clic en **Eliminar** para eliminar un panel de control de la lista de reproducción.

1. Haga clic en **Save** para guardar sus cambios.

## Uso compartido de una lista de reproducción en modo de visualización
<a name="v9-dash-share-playlist-view-mode"></a>

Para compartir una lista de reproducción, puede copiar la dirección del enlace en el modo de visualización que desee y pegue la URL en su destino.

1. En el submenú **Paneles**, haga clic en **Listas de reproducción**.

1. Haga clic en **Iniciar lista de reproducción** junto a la lista de reproducción que desee iniciar.

1. En el menú desplegable, haga clic con el botón derecho en el modo de visualización que prefiera.

1. Haga clic en **Copiar dirección del enlace** para copiar la URL en el portapapeles.

1. Pegue la URL en el destino.

# Adición y administración de variables de panel de control
<a name="v9-dash-variables"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.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).

Una variable es un marcador de posición para un valor. Puede utilizar variables en las consultas de métricas y en los títulos de los paneles. Al cambiar el valor mediante la lista desplegable situada en la parte superior del panel de control, las consultas de métricas del panel reflejarán el nuevo valor.

Las variables le permiten crear paneles de control más interactivos y dinámicos. En lugar de codificar de forma rígida elementos como los nombres de servidores, aplicaciones y sensores en las consultas de métricas, puede utilizar variables en su lugar. Las variables se muestran como listas desplegables en la parte superior del panel de control. Estos menús desplegables facilitan el cambio de datos que se muestran en el panel de control.

Pueden resultar especialmente útiles para los administradores que quieren permitir a los visualizadores de Grafana ajustar las visualizaciones rápidamente, pero no quieren concederles permisos de edición completos. Los visualizadores de Grafana pueden utilizar variables.

Las variables y plantillas también le permiten gestionar paneles de control de un único origen. Si tiene varios orígenes de datos o servidores idénticos, puede crear un panel de control y utilizar variables para cambiar lo que está viendo. Esto simplifica considerablemente el mantenimiento y la conservación.

**Plantillas**

Una plantilla es cualquier consulta que contiene una variable. Por ejemplo, si administrara un panel de control para supervisar varios servidores, podría crear un panel de control para cada servidor o podría crear un panel de control y utilizar paneles con consultas de plantilla, como las siguientes.

```
wmi_system_threads{instance=~"$server"}
```

Los valores de las variables siempre se sincronizan con la URL mediante la sintaxis var-<varname>=value.

**Ejemplos**

Las variables se muestran en listas desplegables en la parte superior de la pantalla. Seleccione diferentes variables para ver cómo cambian las visualizaciones.

Para ver la configuración de las variables, vaya a **Configuración del panel > Variables**. Haga clic en una variable de la lista para ver su configuración. 

Las variables se pueden usar en los títulos, descripciones, paneles de texto y consultas. Las consultas cuyo texto comienza por `$` son plantillas. No todos los paneles tendrán consultas de plantilla.

**Prácticas recomendadas de variables**
+ Las listas desplegables de variables se muestran en el orden en que aparecen en la lista de variables de **Configuración del panel**.
+ Coloque las variables que cambiará con frecuencia en la parte superior, de modo que se muestren primero (en el extremo izquierdo del panel de control).

# Adición y administración de variables
<a name="v9-dash-variable-add"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.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 la siguiente tabla se muestran los tipos de variables que se envían con Grafana.


| Tipo de variable | Description (Descripción) | 
| --- | --- | 
|  Consultar  |  Lista de valores generada por consultas, como nombres de métricas, nombres de servidores, sensores IDs, centros de datos, etc. Agregue una variable de consulta.  | 
|  Personalizada  |  Define las opciones de la variable de forma manual mediante una lista separada por comas. Agregue una variable personalizada.  | 
|  Text box (Cuadro de texto)  |  Muestre un campo de entrada de texto libre con un valor predeterminado opcional. Agregue una variable de cuadro de texto.  | 
|  Constant  |  Define una constante oculta. Agregue una variable de constante.  | 
|  Origen de datos  |  Cambie rápidamente el origen de datos de un panel de control completo. Agregue una variable de origen de datos.  | 
|  Interval  |  Las variables de intervalo representan intervalos de tiempo. Agregue una variable de intervalo.  | 
|  Filtros ad hoc  |  Filtros de valores clave que se agregan automáticamente a todas las consultas de métricas de un origen de datos (solo Prometheus, Loki, InfluxDB y Elasticsearch). Agregue filtros ad hoc.  | 
|  Variables globales  |  Variables integradas que se pueden utilizar en expresiones del editor de consultas. Consulte Variables globales.  | 
|  Variables encadenadas  |  Las consultas de variables pueden contener otras variables. Consulte Variables encadenadas.  | 

## Introducción de opciones generales
<a name="v9-dash-variable-options"></a>

Debe ingresar opciones generales para cualquier tipo de variable que cree.

**Introducción de opciones generales**

1. Vaya al panel de control para el que desee crear una variable y seleccione el icono (de engranaje) **Configuración del panel** situado en la parte superior de la página.

1. En la pestaña **Variables**, seleccione **Nuevo**.

1. Ingrese un **Nombre** para la variable.

1. En la lista **Tipo**, seleccione **Consulta**.

1. (Opcional) En **Etiqueta**, ingrese el nombre de visualización del menú desplegable de variables.

   Si no ingresa ningún nombre de visualización, la etiqueta desplegable es el nombre de la variable.

1. Elija una opción de **Ocultar**:
   + **Sin selección (en blanco):** el menú desplegable de variables muestra el valor de **Nombre** o **Etiqueta** de la variable.
   + **Etiqueta**: el menú desplegable de variables solo muestra el valor de la variable seleccionada y una flecha hacia abajo.
   + **Variable**: no se muestra ningún menú desplegable de variables en el panel de control.

## Adición de una variable de consulta
<a name="v9-dash-variable-add-query"></a>

Las variables de consulta permiten escribir una consulta de origen de datos que puede devolver una lista de nombres de métricas, valores de etiquetas o claves. Por ejemplo, una variable de consulta puede devolver una lista de nombres de servidores IDs, sensores o centros de datos. Los valores de las variables cambian a medida que buscan opciones de forma dinámica con una consulta a un origen de datos.

Por lo general, las variables de consulta solo se admiten para cadenas. Si la consulta devuelve números o cualquier otro tipo de datos, es posible que deba convertirlos en cadenas para poder utilizarlos como variables. Para el origen de datos de Azure, por ejemplo, puede usar la función [tostring](https://docs.microsoft.com/en-us/azure/data-explorer/kusto/query/tostringfunction) para este propósito.

Las expresiones de consulta pueden contener referencias a otras variables y, de hecho, crear variables vinculadas. Grafana lo detecta y actualiza automáticamente una variable cuando cambia una de sus variables vinculadas.

**nota**  
Las expresiones de consulta son diferentes para cada origen de datos. Para obtener más información, consulte la documentación del [origen de datos](AMG-data-sources.md).

**Adición de una variable de consulta**

1. Ingrese las opciones generales, como se indica arriba.

1. En la lista **Origen de datos**, seleccione el origen de datos de destino para la consulta.

1. En la lista **Actualizar**, seleccione cuándo debe actualizar las opciones la variable.
   + **Al cargar el panel de control**: consulta el origen de datos cada vez que se carga el panel de control. Esto ralentiza la carga del panel de control, ya que la consulta de variables debe completarse antes de inicializar el panel de control.
   + **Al cambiar el intervalo de tiempo**: consulta el origen de datos cuando cambia el intervalo de tiempo del panel de control. Utilice esta opción únicamente si la consulta de opciones de variables contiene un filtro de intervalo de tiempo o depende del intervalo de tiempo del panel de control.

1. En el campo **Consulta**, ingrese una consulta.
   + El campo de consulta varía en función del origen de datos. Algunos orígenes de datos tienen editores de consultas personalizados.
   + Si necesita más espacio en un editor de consultas de un solo campo de entrada, coloque el cursor sobre las líneas de la esquina inferior derecha del campo y arrástrelo hacia abajo para ampliarlo.

1. (Opcional) En el campo **Expresión regular**, escriba una expresión regular para filtrar o capturar partes específicas de los nombres devueltos por la consulta del origen de datos. Para ver ejemplos, consulte [Filtrado de variables con expresiones regulares](#v9-dash-variable-add-filter).

1. En la lista **Ordenar**, seleccione el orden de clasificación de los valores que se mostrarán en la lista desplegable. La opción predeterminada, **Deshabilitado**, significa que se utilizará el orden de las opciones devuelto por la consulta del origen de datos.

1. (Opcional) Ingrese [Opciones de selección](#v9-dash-variable-add-selection).

1. En **Vista previa de valores**, Grafana muestra una lista de los valores de las variables actuales. Revíselos para asegurarse de que coincidan con lo que espera.

1. Seleccione **Agregar** para agregar la variable al panel de control.

## Adición de una variable personalizada
<a name="v9-dash-variable-add-custom"></a>

Utilice una variable *personalizada* para un valor que no cambie, como un número o una cadena.

Por ejemplo, si tiene nombres de servidores o nombres de regiones que nunca cambian, es posible que desee crearlos como variables personalizadas en lugar de como variables de consulta. Como no cambian, puede utilizarlos en [variables encadenadas](#v9-dash-variable-add-chained) en lugar de en otras variables de consulta. Eso reduciría la cantidad de consultas que Grafana debe enviar cuando se actualizan las variables encadenadas.

**Adición de una variable personalizada**

1. Ingrese las opciones generales, como se indica arriba.

1. En la 

   lista **Valores separados por comas**, ingrese los valores de esta variable en una lista separada por comas. Puede incluir números, cadenas o pares clave-valor separados por un espacio y dos puntos. Por ejemplo, `key1 : value1,key2 : value2`.

1. (Opcional) Ingrese [Opciones de selección](#v9-dash-variable-add-selection).

1. En **Vista previa de valores**, Grafana muestra una lista de los valores de las variables actuales. Revíselos para asegurarse de que coincidan con lo que espera.

1. Seleccione **Agregar** para agregar la variable al panel de control.

## Adición de una variable de cuadro de texto
<a name="v9-dash-variable-add-text"></a>

Las variables de *cuadro de texto* muestran un campo de entrada de texto libre con un valor predeterminado opcional. Es la variable más flexible, ya que puede ingresar cualquier valor. Utilice este tipo de variable si tiene métricas con una cardinalidad alta o si desea actualizar varios paneles de un panel de control al mismo tiempo.

**Adición de una variable de cuadro de texto**

1. Ingrese las opciones generales, como se indica arriba.

1. (Opcional) En el campo **Valor predeterminado**, seleccione el valor predeterminado de la variable. Si no ingresa nada en este campo, Grafana mostrará un cuadro de texto vacío para que los usuarios escriban texto.

1. En **Vista previa de valores**, Grafana muestra una lista de los valores de las variables actuales. Revíselos para asegurarse de que coincidan con lo que espera.

1. Seleccione **Agregar** para agregar la variable al panel de control.

## Adición de una variable constante
<a name="v9-dash-variable-add-constant"></a>

Las variables *constantes* permiten definir una constante oculta. Esto resulta útil para los prefijos de las rutas métricas de los paneles de control que desee compartir. Al exportar un panel de control, las variables constantes se convierten en opciones de importación.

Las variables constantes *no* son flexibles. Cada variable constante solo contiene un valor y no se puede actualizar a menos que actualice la configuración de la variable.

Las variables constantes son útiles cuando tiene valores complejos que debe incluir en las consultas, pero no desea volver a escribirlos en todas las consultas. Por ejemplo, si tuviera una ruta de servidor llamada `i-0b6a61efe2ab843gg`, podría reemplazarla por una variable llamada `$path_gg`.

**Adición de una variable constante**

1. Ingrese las opciones generales, como se indica arriba.

1. En el campo **Valor**, escriba el valor de la variable. Puede ingresar letras, números y símbolos. Incluso puede utilizar caracteres comodín si utiliza el [formato RAW](https://grafana.com/docs/grafana/latest/dashboards/variables/variable-syntax/#raw).

1. En **Vista previa de valores**, Grafana muestra una lista de los valores de las variables actuales. Revíselos para asegurarse de que coincidan con lo que espera.

1. Seleccione **Agregar** para agregar la variable al panel de control.

## Adición de una variable de origen de datos
<a name="v9-dash-variable-add-datasource"></a>

Las variables de *Origen de datos* le permiten cambiar rápidamente el origen de datos de un panel de control completo. Son útiles si tiene varias instancias de un origen de datos, quizás en entornos diferentes.

**Adición de una variable de origen de datos**

1. Ingrese las opciones generales, como se indica arriba.

1. En la lista **Tipo**, seleccione el origen de datos de destino para la variable.

1. (Opcional) En **Filtro de nombres de instancias**, ingrese un filtro de expresiones regulares para seleccionar las instancias del origen de datos en la lista desplegable de valores variables. Deje este campo vacío para mostrar todas las instancias.

1. (Opcional) Ingrese [Opciones de selección](#v9-dash-variable-add-selection).

1. En **Vista previa de valores**, Grafana muestra una lista de los valores de las variables actuales. Revíselos para asegurarse de que coincidan con lo que espera.

1. Seleccione **Agregar** para agregar la variable al panel de control.

## Adición de una variable de intervalo
<a name="v9-dash-variable-add-internal"></a>

Utilice una variable de *intervalo* para representar intervalos de tiempo, como `1m`, `1h` o `1d`. Puede considerarlos como un comando *agrupar por tiempo* que abarca todo el panel de control. Las variables de intervalo cambian la forma en que se agrupan los datos en la visualización. También puede utilizar la opción automática para devolver un número determinado de puntos de datos por intervalo de tiempo.

Puede usar una variable de intervalo como parámetro para agruparla por hora (para InfluxDB), intervalo de histograma de fecha (para Elasticsearch) o como parámetro de función de resumen (para Graphite).

**Adición de una variable de intervalo**

1. Ingrese las opciones generales, como se indica arriba.

1. En el campo **Valores**, ingrese los intervalos de periodo de tiempo que desee que aparezcan en la lista desplegable de variables. Se admiten las siguientes unidades de tiempo: `s (seconds)`, `m (minutes)`, `h (hours)`, `d (days)`, `w (weeks)`, `M (months)` y `y (years)`. También puede aceptar o editar los valores predeterminados: `1m,10m,30m,1h,6h,12h,1d,7d,14d,30d`.

1. (Opcional) Active la **opción automática** si desea agregar la opción `auto` a la lista. Esta opción le permite especificar cuántas veces debe dividirse el intervalo de tiempo actual para calcular el intervalo de tiempo `auto` actual. Si la activa, aparecerán dos opciones más:
   + **Recuento de pasos:** seleccione el número de veces que se dividirá el intervalo de tiempo actual para calcular el valor, de forma similar a la opción de consulta **Máximo de puntos de datos**. Por ejemplo, si el intervalo de tiempo visible actual es de 30 minutos, el intervalo `auto` agrupa los datos en 30 incrementos de un minuto. El valor predeterminado es 30 pasos.
   + **Intervalo mínimo**: el umbral mínimo por debajo del cual los intervalos del recuento de pasos no dividirán el tiempo. Para continuar con el ejemplo de 30 minutos, si el intervalo mínimo se establece en 2 min, Grafana agruparía los datos en 15 incrementos de dos minutos.

1. En **Vista previa de valores**, Grafana muestra una lista de los valores de las variables actuales. Revíselos para asegurarse de que coincidan con lo que espera.

1. Seleccione **Agregar** para agregar la variable al panel de control.

**Ejemplos de variables de intervalo**

En el ejemplo siguiente se muestra una variable de plantilla `myinterval` en una función de Graphite:

```
summarize($myinterval, sum, false)
```

## Adición de filtros ad hoc
<a name="v9-dash-variable-add-adhoc"></a>

Los *filtros ad hoc* permiten agregar filtros clave-valor que se agregan automáticamente a todas las consultas de métricas que utilizan el origen de datos especificado. A diferencia de otras variables, no se utilizan filtros ad hoc en las consultas. En su lugar, se utilizan filtros ad hoc para escribir filtros para las consultas existentes.

**nota**  
Las variables de filtro ad hoc solo funcionan con los orígenes de datos de Prometheus, Loki, InfluxDB y Elasticsearch.

1. Ingrese las opciones generales, como se indica arriba.

1. En la lista **Origen de datos**, seleccione el origen de datos de destino.

1. Seleccione **Agregar** para agregar la variable al panel de control.

**Creación de filtros ad hoc**

Los filtros ad hoc son una de las opciones de variables más complejas y flexibles disponibles. En lugar de una lista normal de opciones de variables, esta variable le permite crear una consulta ad hoc que abarque todo el panel de control. Los filtros que aplique de esta manera se aplican a todos los paneles del panel de control.

## Configuración de las opciones de selección de variables
<a name="v9-dash-variable-add-selection"></a>

**Opciones de selección** son una característica que puede utilizar para administrar las selecciones de opciones de variables. Todas las opciones de selección son opcionales y están desactivadas de forma predeterminada.

### Variables de varios valores
<a name="v9-dash-variable-add-selection-multi"></a>

Interpolar una variable con varios valores seleccionados es complicado, ya que no es fácil formatear los múltiples valores en una cadena que sea válida en el contexto dado en el que se usa la variable. Para intentar resolverlo, Grafana permite que cada complemento de origen de datos informe al motor de interpolación de plantillas qué formato usar para varios valores.

**nota**  
La opción **Valor Personalizar todo** de la variable debe estar en blanco para que Grafana formatee todos los valores en una sola cadena. Si se deja en blanco, Grafana concatena (suma) todos los valores de la consulta. Por ejemplo, `value1,value2,value3`. Si se utiliza un valor `all` personalizado, en su lugar el valor será `*` o `all`.

**Variables de valores múltiples con un origen de datos de Graphite**

Graphite usa expresiones globales. En este caso, una variable con varios valores se interpolaría como `{host1,host2,host3}` si el valor de la variable actual fuera *host1*, *host2* y *host3*.

**Variables de valores múltiples con un origen de datos de Prometheus o InfluxDB**

InfluxDB y Prometheus utilizan expresiones regulares, por lo que se interpolaría la misma variable que `(host1|host2|host3)`. También se aplicaría escape de expresiones regulares a cada valor. De lo contrario, un valor con un carácter de control de expresión regular rompería la expresión regular.

**Variables de varios valores con un origen de datos elástico**

Elasticsearch usa la sintaxis de consulta de Lucene, por lo que se formatearía la misma variable que `("host1" OR "host2" OR "host3")`. En este caso, se debe aplicar escape a todos los valores para que el valor solo contenga comillas y palabras de control de Lucene.

**Solución de problemas de las variables con varios valores**

El escape y el formateo automáticos pueden causar problemas y puede resultar complicado entender la lógica que hay detrás de esto. Especialmente para InfluxDB y Prometheus, donde el uso de la sintaxis de expresiones regulares requiere que la variable se use en el contexto del operador de expresiones regulares.

Si no desea que Grafana escape y formatee expresiones regulares de forma automática, debe llevar a cabo una de estas acciones:
+ Desactive las opciones **Varios valores** o **Incluir todo**.
+ Utilice el [formato de variable sin procesar](https://grafana.com/docs/grafana/latest/dashboards/variables/variable-syntax/#raw).

### Opción Incluir todo
<a name="v9-dash-variable-add-multi-all"></a>

Grafana agrega una opción `All` a la lista desplegable de variables. Si un usuario selecciona esta opción, se seleccionan todas las opciones de variables.

### Valor Personalizar todo
<a name="v9-dash-variable-add-multi-custom"></a>

Esta opción solo está visible si se selecciona **Opción Incluir todo**.

Ingrese la sintaxis de expresiones regulares, globales o Lucene en el campo **Valor Personalizar todo** para definir el valor de la opción `All`.

De forma predeterminada, el valor `All` incluye todas las opciones de una expresión combinada. Puede llegar a ser muy largo y provocar problemas de rendimiento. A veces puede ser mejor especificar un valor único personalizado, como una expresión regular comodín.

Para tener una sintaxis personalizada de expresiones regulares, globales o Lucene en la opción **Valor Personalizar todo**, nunca se escapa, por lo que tendrá que pensar en cuál es un valor válido para el origen de datos.

## Variables globales
<a name="v9-dash-variable-add-global"></a>

Grafana tiene variables integradas que se pueden utilizar en expresiones del editor de consultas. En este tema se enumeran en orden alfabético y se definen. Estas variables son útiles en consultas, enlaces de panel de control y enlaces de datos.

**\$1\$1\$1dashboard**

Esta variable es el nombre del panel de control actual.

**\$1\$1\$1from y \$1\$1\$1to**

Grafana tiene dos variables de intervalo de tiempo integradas: `$__from` y `$__to`. Actualmente, siempre se interpolan como milisegundos de Epoch de forma predeterminada, pero puede controlar el formato de la fecha.


| Sintaxis | Ejemplo de resultado | Description (Descripción) | 
| --- | --- | --- | 
|  `${__from}`  |  1594671549254  |  Epoch en milisegundos de Unix  | 
|  `${__from:date}`  |  2020-07-13T20:19:09.254Z  |  Sin argumentos, el valor predeterminado es ISO 8601/RFC 3339  | 
|  `${__from:date:iso}`  |  2020-07-13T20:19:09.254Z  |  ISO 8601/RFC 3339  | 
|  `${__from:date:seconds}`  |  1594671549  |  Epoch en segundos de Unix  | 
|  `${__from:date:YYYY-MM}`  |  2020-07  |  Cualquier formato de fecha personalizado que no incluya el carácter :  | 

La sintaxis anterior también funciona con `${__to}`.

**\$1\$1\$1interval**

Puede usar la variable `$__interval` como parámetro para agruparla por hora (para InfluxDB, MySQL, Postgres y MSSQL), intervalo de histograma de fecha (para Elasticsearch) o como parámetro de función de *resumen* (para Graphite).

Grafana calcula automáticamente un intervalo que se puede utilizar para agrupar por tiempo en las consultas. Cuando hay más puntos de datos de los que se pueden mostrar en un gráfico, las consultas se pueden hacer más eficientes al agruparlas por un intervalo mayor. Por ejemplo, si está viendo un gráfico de datos de 3 meses, es posible que no pueda ver los detalles a nivel de minutos. Agrupar por hora o día hace que la consulta sea más eficiente sin afectar a lo que muestra el gráfico. `$__interval` se calcula con el intervalo de tiempo y el ancho del gráfico (el número de píxeles).

Cálculo aproximado: `(to - from) / resolution`

Por ejemplo, si el intervalo de tiempo es de 1 hora y el gráfico está en pantalla completa, el intervalo podría calcularse en `2m`: los puntos se agrupan en intervalos de 2 minutos. Si el intervalo de tiempo es de 6 meses y el gráfico es de pantalla completa, el intervalo puede ser `1d` (1 día): los puntos se agrupan por día.

En el origen de datos de InfluxDB, la variable heredada `$interval` es la misma variable. `$__interval` debería usarse en su lugar.

Los orígenes de datos de InfluxDB y Elasticsearch tienen campos `Group by time interval` que se utilizan para hacer una codificación rígida del intervalo o para establecer el límite mínimo de la variable `$__interval` (mediante la sintaxis `>` -> `>10m`).

**\$1\$1\$1interval\$1ms**

Esta variable es la variable `$__interval` en milisegundos, no una cadena con formato de intervalo de tiempo. Por ejemplo, si `$__interval` es `20m`, `$__interval_ms` es `1200000`.

**\$1\$1\$1org**

Esta variable es el ID de la organización actual. `${__org.name}` es el nombre de la organización actual.

**\$1\$1\$1user**

`${__user.id}` es el ID del usuario actual. `${__user.login}` es el identificador de inicio de sesión del usuario actual. `${__user.email}` es el correo electrónico del usuario actual.

**\$1\$1\$1range**

Actualmente solo es compatible con los orígenes de datos de Prometheus y Loki. Esta variable representa el intervalo del panel de control actual. Se calcula mediante `to - from`. Tiene una representación de milisegundos y una segunda llamada `$__range_ms` y `$__range_s`.

**\$1\$1\$1rate\$1interval**

Actualmente solo es compatible con los orígenes de datos de Prometheus y Loki. La variable `$__rate_interval` está destinada a usarse en la función de tasa.

**\$1timeFilter o \$1\$1\$1timeFilter**

La variable `$timeFilter` devuelve el intervalo de tiempo seleccionado actualmente como una expresión. Por ejemplo, la expresión `Last 7 days` del intervalo de tiempo es `time > now() - 7d`.

Se usa en varios lugares, entre ellos:
+ La cláusula WHERE para el origen de datos de InfluxDB. Grafana la agrega automáticamente a las consultas de InfluxDB cuando está en el modo Editor de consultas. Puede agregarla manualmente en el modo Editor de texto: `WHERE $timeFilter`.
+ Registre las consultas de análisis en el origen de datos de Azure Monitor.
+ Consultas SQL en MySQL, Postgres y MSSQL.
+ La variable `$__timeFilter` se utiliza en el origen de datos de MySQL.

## Variables encadenadas
<a name="v9-dash-variable-add-chained"></a>

Las *variables encadenadas*, también denominadas *variables enlazadas* o *variables anidadas*, son variables de consulta con una o más variables adicionales en su consulta de variables. En esta sección se explica cómo funcionan las variables encadenadas y se proporcionan enlaces a ejemplos de paneles de control que las utilizan.

Las consultas de variables encadenadas son diferentes para cada origen de datos, pero la premisa es la misma para todas. Puede utilizar consultas de variables encadenadas en cualquier origen de datos que las permita.

Es posible utilizar paneles de control con plantillas vinculadas extremadamente complejos, de 5 o 10 niveles de profundidad. Técnicamente, no hay límite en cuanto a la profundidad o complejidad que pueda tener, pero cuantos más enlaces tenga, mayor será la carga de consultas.

**Prácticas recomendadas y consejos**

Las siguientes prácticas harán que los paneles de control y las variables sean más fáciles de usar.

**Creación de nuevas variables vinculadas**
+ El encadenamiento de variables crea dependencias. parent/child Puede imaginarlos como una escalera o un árbol.
+ La forma más sencilla de crear una nueva variable encadenada consiste en copiar la variable en la que desea basar la nueva. En la lista de variables, haga clic en el icono **Duplicar variable** situado a la derecha de la entrada de la variable para crear una copia. A continuación, puede agregar a la consulta la variable principal.
+ Las variables nuevas creadas de esta forma aparecen al final de la lista. Puede que tenga que arrastrarlas a una posición diferente de la lista para colocarlas en un orden lógico.

**Orden de las variables**

Para cambiar el orden de las variables en la lista de variables del panel de control, haga clic en las flechas arriba y abajo situadas a la derecha de cada entrada. Grafana muestra los menús desplegables de variables de izquierda a derecha según esta lista, con la variable de la parte superior en el extremo izquierdo.
+ Enumere las variables que no tienen dependencias en la parte superior, antes de sus variables secundarias.
+ Cada variable debe seguir a la variable de la que depende.
+ Recuerde que en la interfaz de usuario no se indica qué variables tienen relaciones de dependencia. Enumere las variables en un orden lógico para facilitar la tarea a otros usuarios (y a usted).

**Consideraciones sobre la complejidad**

Cuantos más niveles de dependencia haya en las variables, más tiempo tardará en actualizar los paneles de control después de cambiar las variables.

Por ejemplo, si tiene una serie de cuatro variables vinculadas (país, región, servidor y métrica) y cambia el valor de una variable raíz (país), Grafana debe ejecutar consultas para todas las variables dependientes antes de actualizar las visualizaciones en el panel de control.

## Administración de variables
<a name="v9-dash-variable-add-manage"></a>

La página de variables le permite [agregar](https://grafana.com/docs/grafana/latest/dashboards/variables/add-template-variables/) variables y administrar las variables existentes. También le permite [inspeccionar](https://grafana.com/docs/grafana/latest/dashboards/variables/inspect-variable/) las variables e identificar si una variable se utiliza o se hace referencia a ella en otras variables o en el panel de control.

**Mover**: para mover una variable hacia arriba o hacia abajo en la lista, arrástrela y suéltela.

**Clonar**: para clonar una variable, haga clic en el icono de clonación del conjunto de iconos de la derecha. Esto crea una copia de la variable con el nombre de la variable original con el prefijo `copy_of_`.

**Eliminar**: para eliminar una variable, haga clic en el icono de la papelera del conjunto de iconos de la derecha.

## Filtrado de variables con expresiones regulares
<a name="v9-dash-variable-add-filter"></a>

Con la opción Consulta de expresiones regulares, se filtra la lista de opciones devuelta por la consulta de variables o se modifican las opciones devueltas.

En esta página, se muestra cómo usar expresiones regulares para filter/modify los valores del menú desplegable de variables.

Con la opción Consulta de expresiones regulares, se filtra la lista de opciones devuelta por la consulta de variables o se modifican las opciones devueltas. Para obtener más información, consulte la guía de Mozilla sobre [expresiones regulares](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions).

Los siguientes ejemplos muestran el filtrado en la siguiente lista de opciones:

```
backend_01
backend_02
backend_03
backend_04
```

**Filtrado para que solo se devuelvan las opciones que terminan en `01` o `02`**

Expresión regular:

```
/
(
01|02 
) 
$/
```

Resultado:

```
backend_01
backend_02
```

**Filtrado y modificación de las opciones mediante un grupo de captura de expresiones regulares para devolver parte del texto**

Expresión regular:

```
/.* 
(
01|02 
)
/
```

Resultado:

```
01
02
```

**Filtrado y modificación: ejemplo de Prometheus**

Lista de opciones:

```
up{instance="demo.robustperception.io:9090",job="prometheus"} 1 1521630638000
up{instance="demo.robustperception.io:9093",job="alertmanager"} 1 1521630638000
up{instance="demo.robustperception.io:9100",job="node"} 1 1521630638000
```

Expresión regular:

```
/. *instance="
(
[^"]*
)
.*/
```

Resultado:

```
demo.robustperception.io:9090
demo.robustperception.io:9093
demo.robustperception.io:9100
```

**Filtrado y modificación mediante grupos de captura de valores y texto con nombre asignado**

Al usar grupos de captura con nombre, puede capturar partes separadas de “texto” y “valor” de las opciones devueltas por la consulta de variables. Esto permite que la lista desplegable de variables contenga un nombre descriptivo para cada valor que se pueda seleccionar.

Por ejemplo, al consultar la métrica `node_hwmon_chip_names` de Prometheus, `chip_name` es mucho más fácil de recordar que el valor `chip`. Por lo tanto, el siguiente resultado de la consulta variable:

```
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_0",chip_name="enp216s0f0np0"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_1",chip_name="enp216s0f0np1"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_2",chip_name="enp216s0f0np2"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_3",chip_name="enp216s0f0np3"} 1
```

Pasó por la siguiente expresión regular:

```
/chip_name="(?<text>[ ^ " ] + ) |chip=" (?<value >[ ^ " ] + )/g
```

Produciría la siguiente lista desplegable:

```
Display Name          Value
------------          -------------------------
enp216s0f0np0         0000:d7:00_0_0000:d8:00_0
enp216s0f0np1         0000:d7:00_0_0000:d8:00_1
enp216s0f0np2         0000:d7:00_0_0000:d8:00_2
enp216s0f0np3         0000:d7:00_0_0000:d8:00_3
```

Solo se admiten los nombres de los grupos de captura `text` y `value`.

## 
<a name="v9-dash-variable-add-inspect"></a>

La página de variables le permite identificar fácilmente si una variable se utiliza o se hace referencia a ella en otras variables o en el panel de control.

Todas las variables a las que se hace referencia o se utilizan tienen una marca de verificación verde junto a ellas, mientras que las variables no referenciadas tienen un icono de precaución naranja junto a ellas. Además, todas las variables a las que se hace referencia tienen un icono de dependencia junto a la marca de verificación verde. Puede seleccionar el icono para ver el mapa de dependencia. El mapa de dependencia se puede mover. Puede acercar o alejar la imagen con la rueda del ratón o una herramienta similar.

# Sintaxis de variable
<a name="v9-dash-variable-syntax"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.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 títulos de los paneles y las consultas de las métricas pueden ver las variables mediante dos sintaxis distintas.
+ `$varname`: esta sintaxis es más fácil de leer, pero no permite utilizar una variable en medio de una palabra.

  **Ejemplo**: `apps.frontend.$server.requests.count`
+ `${var_name}`: utilice esta sintaxis cuando desee usar una variable en medio de una expresión.
+ `${var_name:<format>}`: este formato le da más control sobre cómo Grafana interpreta los valores. Para obtener más información, consulte *Opciones avanzadas de formato de variables*.
+ `[[varname]]`: no la utilice. Esta sintaxis es antigua y no está disponible. Se habilitará en una versión futura.

Antes de enviar las consultas al origen de datos, la consulta se *interpola*, lo que significa que la variable se reemplaza por su valor actual. Durante la interpolación, es posible que el valor de la variable se *escape* para ajustarlo a la sintaxis del lenguaje de consulta y al lugar en el que se utiliza. Por ejemplo, una variable que se utilice en una expresión regular en una consulta de InfluxDB o Prometheus tendrá un escape de expresiones regulares.

**Opciones avanzadas de formato de variables**

El formato de la interpolación de variables depende del origen de datos, pero hay algunas situaciones en las que es posible que quiera cambiar el formato predeterminado.

Por ejemplo, el valor predeterminado del origen de datos de MySQL es unir varios valores separados por comas entre comillas: `'server01','server02'`. En algunos casos, es posible que quiera que haya una cadena separada por comas sin comillas: `server01,server02`. Puede hacer que eso suceda con las opciones avanzadas de formato de variables que se enumeran a continuación.

**Sintaxis general**

Sintaxis: `${var_name:option}`

Si se especifica alguna opción de formato no válida, entonces `glob` es la default/fallback opción.

**CSV**

Formatea las variables con varios valores como una cadena separada por comas.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:csv}'
Interpolation result:  'test1,test2'
```

**Distribuida: OpenTSDB**

Formatea las variables con varios valores en un formato personalizado para OpenTSDB.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:distributed}'
Interpolation result:  'test1,servers=test2'
```

**Doublequote**

Formatea las variables de uno o varios valores en una cadena separada por comas, escapa `"` en cada valor por `\"` y cita cada valor con `"`.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:doublequote}'
Interpolation result:  '"test1","test2"'
```

**Glob: Graphite**

Formatea las variables con varios valores en un patrón glob (para consultas de Graphite).

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:glob}'
Interpolation result:  '{test1,test2}'
```

**JSON**

Formatea las variables con varios valores como una cadena separada por comas.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:json}'
Interpolation result:  '["test1", "test2"]'
```

**Lucene: Elasticsearch**

Formatea variables con varios valores en formato Lucene para Elasticsearch.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:lucene}'
Interpolation result:  '("test1" OR "test2")'
```

**Percentencode**

Formatea las variables de un solo valor y de varios valores para utilizarlas en los parámetros de URL.

```
servers = [ 'foo()bar BAZ',  'test2' ]
String to interpolate:  '${servers:percentencode}'
Interpolation result:  'foo%28%29bar%20BAZ%2Ctest2'
```

**Pipe**

Formatea las variables con varios valores en una cadena separada por canalizaciones.

```
servers = [ 'test1.',  'test2' ]
String to interpolate:  '${servers:pipe}'
Interpolation result:  'test1.|test2'
```

**Raw**

Desactiva el formato específico del origen de datos, como las comillas simples en una consulta SQL.

```
servers = [ 'test.1',  'test2' ]
String to interpolate:  '${var_name:raw}'
Interpolation result:  'test.1,test2'
```

**Regex**

Formatea las variables con varios valores en una cadena de expresiones regulares.

```
servers = [ 'test1.',  'test2' ]
String to interpolate:  '${servers:regex}'
Interpolation result:  '(test1\.|test2)'
```

**Singlequote**

Formatea las variables de uno o varios valores en una cadena separada por comas, escapa `'` en cada valor por `\'` y cita cada valor con `'`.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:singlequote}'
Interpolation result:  "'test1','test2'"
```

**Sqlstring**

Formatea las variables de uno o varios valores en una cadena separada por comas, escapa `'` en cada valor por `''` y cita cada valor con `'`.

```
servers = [ "test'1",  "test2" ]
String to interpolate:  '${servers:sqlstring}'
Interpolation result:  "'test''1','test2'"
```

**Text**

Formatea las variables de un solo valor y de varios valores para incluirlas en su representación textual. Para una sola variable, simplemente devolverá la representación de texto. Para las variables con varios valores, devolverá la representación de texto combinada con `+`.

```
servers = [ "test1",  "test2" ]
String to interpolate:  '${servers:text}'
Interpolation result:  "test1 + test2"
```

**Parámetros de consulta**

Formatea las variables de un solo valor y de varios valores para incluirlas en su representación de parámetro de consulta. Ejemplo: `var-foo=value1&var-foo=value2`

```
servers = [ "test1",  "test2" ]
String to interpolate:  '${servers:queryparam}'
Interpolation result:  "var-servers=test1&var-servers=test2"
```

# Evaluación del uso del panel de control
<a name="v9-dash-assess-dashboard-usage"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.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 información sobre el uso le permite comprender mejor cómo se usa su instancia de Grafana.

La característica de información sobre el uso recopila una serie de datos agregados y los almacena en la base de datos.
+ Vistas del panel (agregadas y por usuario)
+ Errores del origen de datos
+ Consultas al origen de datos

Los datos agregados le permiten acceder a varias características, como la información sobre los paneles de control y los orígenes de datos, el indicador de presencia, la clasificación de los paneles mediante datos de información y la visualización de los datos de información sobre el uso en un panel de control.

Esta característica también genera registros detallados que se pueden exportar a Loki.

## Información sobre el panel de control y el origen de datos
<a name="v9-dash-insights"></a>

Para cada panel de control y origen de datos, puede acceder a la información sobre el uso.

**Información sobre el panel de control**

Para ver la información sobre el uso del panel, haga clic en **Información sobre el panel de control** en la barra superior.

La información sobre el panel de control muestra los siguientes detalles.
+ **Estadísticas**: número de consultas y errores diarios de los últimos 30 días.
+ **Usuarios y actividad**: recuento de visitas diarias de los últimos 30 días; últimas actividades en el panel de control y usuarios recientes (con un límite de 20).

**Información sobre los orígenes de datos**

La información sobre los orígenes de datos proporciona detalles sobre cómo se ha utilizado un origen de datos en los últimos 30 días, por ejemplo:
+ Consultas por día
+ Errores por día
+ Tiempo de carga de consultas por día (promedio en ms)

Búsqueda de información sobre los orígenes de datos:

1. Vaya a la vista de lista **Origen de datos**.

1. Haga clic en **Origen de datos**.

1. Haga clic en la pestaña **Información**.

## Indicador de presencia
<a name="v9-dash-presence-indicator"></a>

Cuando inicia sesión y mira un panel, puede saber quién está viendo el mismo panel a través de un indicador de presencia, que muestra los avatares de los usuarios que han interactuado recientemente con el panel. El valor predeterminado del tiempo es de 10 minutos. Para ver el nombre del usuario, coloque el cursor sobre su avatar. Los avatares provienen de [Gravatar](https://gravatar.com/) y se basan en el correo electrónico del usuario.

Cuando haya más usuarios activos en un panel de control de los que permite el indicador de presencia, haga clic en el icono **\$1X**. Al hacerlo, se abrirá la información del panel, que contiene más detalles sobre la actividad reciente de los usuarios.

## Ordenación de los paneles mediante datos de información
<a name="v9-dash-sort-dashboards"></a>

En la vista de búsqueda, puede usar los datos de información para encontrar los paneles más utilizados, que no funcionan y no utilizados.
+ Errores totales
+ Errores en 30 días
+ Total de visitas
+ Visitas en 30 días

# Búsqueda de paneles de control en la versión 9 de Grafana
<a name="v9-search"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.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 buscar paneles de control por nombre y por título. Cuando busca paneles de control, el sistema muestra todos los paneles disponibles en la instancia de Grafana, aunque no tenga permiso para ver el contenido del panel.

## Búsqueda de paneles de control por el nombre
<a name="v9-search-by-name"></a>

Escriba cualquier parte del nombre del panel de control en la barra de búsqueda. La búsqueda devuelve los resultados de cualquier coincidencia parcial de las cadenas en tiempo real, a medida que escribe.

Características de la búsqueda de paneles de control:
+ Tiempo real
+ *No* distingue entre mayúsculas y minúsculas
+ Funciona en todos los paneles almacenados y basados en archivos.

**sugerencia**  
Puede utilizar las teclas de flecha del teclado para navegar por los resultados y pulsar `Enter` para abrir el panel seleccionado.

## Búsqueda de paneles de control por título
<a name="v9-search-by-title"></a>

Puede buscar un panel de control por el título del panel que aparece en un panel de control. Si el título del panel coincide con la consulta de búsqueda, el panel de control aparece en los resultados.

## Filtrado de resultados de búsqueda del panel de control mediante etiquetas
<a name="v9-search-by-tag"></a>

Las etiquetas son una forma excelente de organizar los paneles de control, especialmente a medida que aumenta el número de paneles. Puede agregar y gestionar las etiquetas en la **Configuración** del panel de control.

Al seleccionar varias etiquetas, Grafana muestra paneles de control que incluyan todas las etiquetas seleccionadas.

Para filtrar los resultados de búsqueda del panel de control por etiqueta, siga uno de estos pasos:
+ Para filtrar los resultados de la búsqueda del panel de control por etiqueta, seleccione una etiqueta que aparezca en la columna derecha de los resultados de la búsqueda.

  Para seguir filtrando, seleccione más etiquetas.
+ Para ver una lista de todas las etiquetas disponibles, haga clic en el menú desplegable **Filtrar por etiquetas** y seleccione una.

  Se mostrarán todas las etiquetas y, cuando seleccione una, la búsqueda del panel de control se filtrará al instante.

**sugerencia**  
Cuando utilice solo un teclado, pulse la tecla `tab` y navegue hasta el menú desplegable **Filtrar por etiqueta**, pulse la tecla de flecha hacia abajo para activar el menú y localizar una etiqueta y pulse `Enter` para seleccionarla.