

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 10 de Grafana
<a name="v10-dashboards"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).  
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).

 Un panel de control es un conjunto de uno o más [paneles](v10-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](v10-dash-using-dashboards.md)
+ [Creación de paneles de control](v10-dash-building-dashboards.md)
+ [Administración de paneles de control](v10-dash-managing-dashboards.md)
+ [Administración de listas de reproducción](v10-dash-managing-playlists.md)
+ [Uso compartido de paneles de control y paneles](v10-dash-sharing.md)
+ [Variables](v10-dash-variables.md)
+ [Evaluación del uso del panel de control](v10-dash-assess-dashboard-usage.md)
+ [Solución de problemas de paneles de control](v10-dash-troubleshoot.md)
+ [Búsqueda de paneles de control en la versión 10 de Grafana](v10-search.md)

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

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).  
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).

En 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="v10-dash-features"></a>

Puede usar los paneles de control para personalizar la presentación de los datos. En la siguiente imagen se muestra la interfaz del panel de control de Amazon Managed Grafana.

![\[Imagen que muestra la interfaz de los paneles de control de un espacio de trabajo de Amazon Managed Grafana, con puntos destacados de los botones de diferentes características.\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/images/AMG-dashboard-overview-v10.png)



|  Característica  |  Description (Descripción)  | 
| --- | --- | 
| **1. Inicio** | Seleccione 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 seleccionar el título del panel de control, puede buscar los paneles de control contenidos 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. Guardar panel de control** | Seleccione el icono Guardar para guardar los cambios en el panel de control. | 
| **6. Información sobre el panel de control** | Elija ver los análisis del panel de control, incluida la información sobre los usuarios, la actividad y el recuento de consultas. Para obtener más información, consulte [Evaluación del uso del panel de control](v10-dash-assess-dashboard-usage.md). | 
| **7. 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](v10-dash-modify-settings.md). | 
| **8. Menú desplegable del selector de tiempo** |  Se usa para seleccionar opciones de intervalo de tiempo relativo y establecer intervalos de tiempo absolutos personalizados. Para cambiar la configuración de **Zona horaria** y **Año fiscal** desde los controles del intervalo de tiempo, haga clic en el botón **Cambiar configuración de hora**. La configuración de hora se guarda en cada panel de control.  | 
| **9. Reducir intervalo de tiempo** |  Se utiliza 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](#v10-dash-setting-dashboard-time-range).  | 
| **10. Actualizar panel de control** | Seleccione esta opción para activar inmediatamente las consultas y actualizar los datos del panel de control. | 
| **11. Actualizar intervalo de tiempo del panel de control** | Seleccione un intervalo de tiempo de actualización automática del panel de control. | 
| **12. Modo de visualización**  | Seleccione esta opción 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.  | 
| **13. Panel del panel de control** |  El componente principal de un panel de control es el panel. Para agregar un panel, una fila del panel de control o un panel de biblioteca nuevos, seleccione **Agregar panel**. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/v10-dash-using-dashboards.html)  | 
| **14. Leyenda gráfica** | Cambie los colores de las series, el eje Y y la visibilidad de las series directamente desde la leyenda. | 
| **15. 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/v10-dash-using-dashboards.html)  | 

## Métodos abreviados de teclado
<a name="v10-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="v10-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 retroceder en el tiempo, en relación con la fecha y hora actuales o `now`. 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 las siguientes sintaxis:  
`now+n` para marcas de tiempo futuras.
`now-1n/n` para el *inicio de n hasta el final de n*, porque se trata de una marca de tiempo absoluta.

**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**. También puede elegir entre una lista de intervalos de tiempo absolutos utilizados recientemente.
+ El **intervalo de tiempo semirrelativo** se puede seleccionar en la configuración del intervalo de tiempo absoluto. Por ejemplo, para mostrar la actividad desde una fecha específica, puede elegir una hora absoluta para la hora de inicio y una hora relativa (por ejemplo, `now`) para la hora de finalización.

  Al utilizar un intervalo de tiempo semirrelativo, a medida que pase el tiempo, el panel de control se alejará automática y progresivamente para mostrar más historial y menos detalles. Al mismo ritmo, a medida que disminuya la alta resolución de los datos, las tendencias históricas de todo el periodo de tiempo se volverán más claras.
**nota**  
Las alertas no admiten intervalos de tiempo semirrelativos.
+ Para **reducir** la imagen, seleccione el icono de reducción (o con Cmd \$1 Z o Ctrl \$1 Z como método abreviado de teclado). Esto aumenta la vista y muestra un intervalo de tiempo mayor en el panel de control o en la visualización del panel.
+ Para **ampliar** la imagen, seleccione el intervalo de tiempo que desee ver en el gráfico de la visualización.
**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](#v10-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="v10-dash-building-dashboards"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).  
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).

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. Un panel de control se compone de [paneles con visualizaciones](v10-panels-viz.md). Cada panel tiene una consulta asociada para extraer datos de uno de sus [Conexión con orígenes de datos](AMG-data-sources.md).

Para crear paneles de control más interactivos y dinámicos, agregue y utilice [variables](v10-dash-variables.md). En lugar de codificar de forma rígida los nombres de servidores, aplicaciones u otros nombres en las consultas de métricas, puede utilizar variables en su lugar.

**Topics**
+ [Creación de paneles de control](v10-dash-creating.md)
+ [Importación de paneles de control](v10-dash-importing.md)
+ [Exportación de paneles](v10-dash-exporting.md)
+ [Modificación de la configuración del panel de control](v10-dash-modify-settings.md)
+ [Variables de URL de panel de control](v10-dash-dashboard-url-variables.md)
+ [Administración de paneles de biblioteca](v10-dash-manage-library-panels.md)
+ [Administración del historial de versiones del panel de control](v10-dash-manage-version-history.md)
+ [Administración de los enlaces de panel de control](v10-dash-manage-dashboard-links.md)
+ [Anotación de visualizaciones](v10-dash-annotations.md)
+ [Modelo JSON del panel de control](v10-dash-dashboard-json-model.md)
+ [Prácticas recomendadas para paneles de control](v10-dash-bestpractices.md)

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

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).  
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).

**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. Para obtener más información, consulte [Conexión con orígenes de datos](AMG-data-sources.md).

 Creación de un panel de control:

1. Inicie sesión en Grafana y seleccione **Paneles** en el menú de la izquierda.

1. Seleccione **Nuevo** y, a continuación, **Nuevo panel de control**.

1. En el panel de control vacío, seleccione **\$1 Agregar visualización**. Esto abre el nuevo cuadro de diálogo de visualización.

1. Elija un origen de datos. Puede elegir un origen de datos existente, uno de los orígenes de datos integrados en Grafana para hacer pruebas o elegir **Configurar un nuevo origen de datos** para configurar uno nuevo (solo los usuarios con permisos de administrador pueden configurar nuevos orígenes de datos).

   Se abre la vista **Editar panel** con el origen de datos seleccionado. Puede cambiar el origen de datos del panel más adelante con la pestaña **Consulta** del editor del panel, si es necesario.

1. Escriba o cree una consulta en el lenguaje de consulta del origen de datos. Elija el icono de actualización del panel de control para hacer una consulta en el origen de datos y ver los resultados sobre la marcha.

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](v10-panels-viz.md).

1. En **Opciones del panel**, puede ingresar un título y una descripción para el panel. 

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

1. Cuando haya terminado de configurar el panel, seleccione **Guardar** para guardar el panel de control.

   También puede seleccionar **Aplicar** para ver los cambios sin salir del editor del panel.

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.

1. Seleccione **Save**.

1. Si lo desea, puede agregar más paneles al panel de control seleccionando **Agregar** en el encabezado del panel de control y **Visualización** en el menú desplegable.

**Copia de un panel de control existente**

Puede copiar rápidamente un panel de control existente para empezar a crear uno nuevo con rapidez.

**Copia de un panel de control existente**

1. Seleccione **Paneles** en el menú de la izquierda.

1. Elija el panel de control que desee copiar para abrirlo.

1. Seleccione **Configuración** (icono de engranaje) en la parte superior derecha del panel de control.

1. Seleccione **Guardar como** en la esquina superior derecha del panel de control.

1. (Opcional) Especifique el nombre, la carpeta, la descripción y si desea copiar o no las etiquetas originales del panel de control copiado.

1. Seleccione **Guardar**.

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

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

1. Seleccione **Paneles** en el menú de la izquierda y, a continuación, elija el panel de control que desee modificar.

1. En la parte superior del panel de control, seleccione **Agregar** y, a continuación, seleccione **Fila** en el menú desplegable.

   Si el panel de control está vacío, también puede seleccionar el botón **\$1 Agregar fila** situado en el centro del panel de control.

1. Pase el ratón sobre el título de la fila y seleccione el icono de **configuración** (engranaje) que aparece.

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. 

1. Seleccione **Update (Actualizar)**.

**Filas que se repiten y origen de datos especial del panel de control**

Si una fila incluye paneles que utilizan el origen de datos especial del [panel de control](AMG-data-sources.md#AMG-data-sources-special) (el origen de datos que utiliza un conjunto de resultados de otro panel del mismo panel de control), los paneles correspondientes en filas repetidas harán referencia al panel de la fila original, no a los de las filas repetidas.

Por ejemplo, en un panel de control:
+ `Row 1` incluye `Panel 1A` y `Panel 1B`.
+ `Panel 1B` utiliza los resultados obtenidos de `Panel 1A` mediante el origen de datos `Dashboard`.
+ La repetición de `Row 2` incluye `Panel 2A` y `Panel 2B`.
+ `Panel 2B` hace referencia a `Panel 1A`, no a `Panel 2A`.

**Desplazamiento de un panel**

1. Abra el panel de .

1. Seleccione 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, arrastre la esquina inferior derecha del panel. Puede ajustar el tamaño de un panel del panel de control a sus necesidades.

# Importación de paneles de control
<a name="v10-dash-importing"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).  
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).

Puede importar paneles de control preconfigurados a su espacio de trabajo de Amazon Managed Grafana.

**Importación de un panel de control**

1. Inicie sesión en el espacio de trabajo de Amazon Managed Grafana.

1. Seleccione **Paneles** en el menú de la izquierda.

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

1. A continuación, debe elegir la definición de JSON del panel de control que desea importar. Tiene tres opciones para la importación de JSON:
   + Cargue un archivo que contenga el JSON del panel de control.
   + Copie directamente el texto JSON en el área de texto.
   + Pegue la URL o el ID del panel de control de Grafana Labs en el campo. Para obtener más información sobre el panel de grafana.com URLs, consulte la siguiente sección.
   + (Opcional) Cambie los detalles del panel de control que desee cambiar.
   + Seleccione un origen de datos, si es necesario.
   + Seleccione **Importar**.
   + Guarde el panel de control.

## Búsqueda de paneles de control en grafana.com
<a name="v10-dash-import-from-grafana"></a>

La página [Paneles](https://grafana.com/grafana/dashboards/) de grafana.com le proporciona paneles de control para las aplicaciones de servidor más comunes. Explore una biblioteca de paneles de control oficiales y creados por la comunidad e impórtelos para ponerlos en marcha rápidamente.

**nota**  
Para importar paneles de control de grafana.com, el espacio de trabajo de Amazon Managed Grafana debe tener acceso a internet.

# Exportación de paneles
<a name="v10-dash-exporting"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).  
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).

Puede usar la interfaz de usuario de Grafana o la API HTTP para exportar paneles 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.

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

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

1. Abra el panel que desee exportar.

1. Seleccione el icono de compartir.

1. Seleccione **Exportar**.

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

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

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

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).  
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).

La 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. 
   + **Zona horaria**: especifique 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.
     + **Valor predeterminado**: 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.
     + **Hora local del navegador**: se utiliza la zona horaria configurada para el navegador del usuario que lo visualiza. 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**: personalice las opciones que se muestran para un tiempo relativo 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**: para anular 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**: seleccione esta opción si no desea que el panel de control muestre el selector de tiempo.

**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. O bien, para los complementos de orígenes de datos que instale desde [Búsqueda de complementos con el catálogo de complementos](grafana-plugins.md#plugin-catalog), puede utilizar la [documentación del sitio web de Grafana Labs](https://grafana.com/docs/grafana/v10.3/datasources/).

**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](v10-dash-variables.md).

**Adición de una variable**

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. 

**Adición de un enlace**

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

1. Ingrese un 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**  
El uso de etiquetas crea un menú desplegable dinámico de paneles de control, todos los cuales tienen una etiqueta específica.

1. Para agregar un enlace web, 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 un 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. Los metadatos de JSON definen el panel de control.

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](v10-dash-dashboard-json-model.md).

# Variables de URL de panel de control
<a name="v10-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 10.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).  
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).

Grafana 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](v10-dash-manage-dashboard-links.md) y [Templates and variables](v10-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](v10-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](v10-dash-variable-add.md#v10-dash-variable-add-adhoc).

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

# Administración de paneles de biblioteca
<a name="v10-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 10.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).  
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).

Un panel de 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.

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

1. Abra el panel que desee convertir en un panel de biblioteca en el modo de edición.

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

1. Seleccione **Paneles de biblioteca** y, a continuación, **\$1 Crear panel de biblioteca**. Se abrirá el cuadro de diálogo de creación.

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

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

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

1. Guarde el panel de control.

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.

También puede crear un panel de biblioteca directamente desde el menú de edición de cualquier panel; para ello, seleccione **Más…** y, a continuación, **Crear panel de biblioteca**.

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

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

1. Seleccione **Paneles** en el menú de la izquierda.

1. Seleccione **Nuevo** y, a continuación, elija **Nuevo panel de control** en el menú desplegable.

1. En el panel de control vacío, seleccione **\$1 Importar panel de biblioteca**. 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.

**Desvinculación de un panel de biblioteca**

1. Seleccione **Paneles** en el menú de la izquierda.

1. Seleccione **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. Seleccione el título del panel (o pase el puntero sobre el panel) para mostrar el menú de acciones en la esquina superior derecha del panel.

1. Seleccione **Editar**. El panel se abre en modo de edición.

1. En la esquina superior derecha de la página, seleccione **Desvincular**.

1. Elija **Sí, desvincular**.

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

Puede ver una lista de los paneles de biblioteca disponibles y buscar un panel de biblioteca.

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

1. Seleccione **Paneles** en el menú de la izquierda.

1. Seleccione **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.

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

1. Seleccione **Paneles** en el menú de la izquierda.

1. Seleccione **Paneles de biblioteca**.

1. Seleccione el icono de eliminación situado junto al nombre del panel de biblioteca del panel que desee eliminar.

# Administración del historial de versiones del panel de control
<a name="v10-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 10.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).  
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).

Siempre que guarde una versión del panel de control, se guardará una copia de esa versión para que no 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.

**nota**  
Se guardan las 20 versiones más recientes de un panel de control.

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. Aparece la vista de diferencias de versiones. De forma predeterminada, verá un resumen textual de los cambios.

Para ver la diferencia del JSON sin procesar que representa su panel de control, haga clic en el botón **Ver diferencias de JSON** en la parte inferior.

**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 seleccionar el botón **Restaurar** situado a la derecha de una fila de la lista de versiones del panel de control o seleccionar el botón **Restaurar a la versión *<x>*** en la vista de diferencias. Al seleccionar cualquiera de estas opciones, se le solicitará 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 garantiza 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="v10-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 10.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).  
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).

Puede 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 atajos a sistemas externos, por ejemplo, para enviar un GitHub problema con el nombre del panel actual.

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.

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

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. Seleccione **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**: si está enlazando a muchos paneles, de forma predeterminada, Grafana los muestra side-by-side todos en la parte superior del panel. Al seleccionar esta opción y agregar un título opcional, se mostrarán los enlaces en un menú desplegable.
   + **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](v10-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.

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

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

1. Seleccione **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.
   + **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` hasta `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. Seleccione **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.

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

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

1. Cambie la configuración y, a continuación, elija **Actualizar**.

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

Para duplicar un enlace de panel de control existente, seleccione 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, seleccione 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, seleccione el icono situado a la derecha del título del 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.

  1. Seleccione el menú y elija **Editar**, o bien utilice el método abreviado de teclado, `e`.

  1. Expanda la sección **Opciones del panel** y desplácese hacia abajo hasta **Enlaces del panel**.

  1. Seleccione **Agregar enlace**.

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

  1. Ingrese la **URL** a la que quiere enlazar. Pulse `Ctrl+Space` (o `Cmd+Space`) y seleccione el campo de 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. Seleccione un panel (o coloque el cursor sobre el panel) para mostrar un menú de acciones en la parte superior derecha del panel.

  1. En el menú, seleccione **Editar**.

     También puede utilizar el método abreviado de teclado `e`.

  1. Expanda la sección **Opciones del panel** y desplácese hacia abajo hasta **Enlaces del panel**.

  1. Busque el enlace que desea cambiar y seleccione el icono **Editar** (lápiz) situado junto a él.

  1. Realice los cambios necesarios.

  1. Seleccione **Guardar** para guardar los cambios y cerrar la ventana.

  1. Para guardar los cambios en el panel de control, seleccione **Guardar** en la esquina superior derecha.
+ **Eliminación de un enlace de panel**

  1. Seleccione un panel (o coloque el cursor sobre el panel) para mostrar un menú de acciones en la parte superior derecha del panel.

  1. En el menú, seleccione **Editar**.

     También puede utilizar el método abreviado de teclado `e`.

  1. Expanda la sección **Opciones del panel** y desplácese hacia abajo hasta **Enlaces del panel**.

  1. Busque el enlace que desea eliminar y seleccione el icono **X** situado junto a él.

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

# Anotación de visualizaciones
<a name="v10-dash-annotations"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).  
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).

Las anotaciones proporcionan una forma de marcar puntos en una visualización con eventos detallados. Se visualizan como líneas verticales e iconos en todos los paneles de gráficos. Cuando pasa el ratón sobre una anotación, puede acceder a la descripción y las etiquetas del evento. El campo de texto puede incluir enlaces a otros sistemas con más detalles.

Puede anotar las visualizaciones de tres formas:
+ Directamente en el panel, mediante la [consulta de anotaciones integrada](#v10-dash-built-in-query).
+ Mediante la API HTTP de Grafana.
+ Mediante la configuración de las consultas de anotación en la configuración del panel de control.

En los dos primeros casos, se crean nuevas anotaciones, mientras que en el último se consultan las anotaciones existentes de los orígenes de datos. La consulta de anotaciones integrada también lo admite.

En esta sección se explican las opciones primera y tercera; para obtener información sobre el uso de la API HTTP de Grafana, consulte [API de anotaciones](Grafana-API-Annotations.md).

Las anotaciones son compatibles con los siguientes tipos de visualización:
+ Serie temporal 
+ Línea temporal de estado
+ Velas

## Creación de anotaciones en paneles
<a name="v10-dash-create-annotations-in-panels"></a>

Grafana incluye la posibilidad de agregar eventos de anotaciones directamente desde un panel mediante la [consulta de anotaciones integrada](#v10-dash-built-in-query) que existe en todos los paneles. Las anotaciones que cree de esta manera se almacenan en Grafana.

Adición de anotaciones directamente en el panel:
+ El panel de control ya debe estar guardado.
+ Debe habilitarse la consulta integrada.

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

1. En el panel, seleccione el panel al que va a agregar la anotación. Aparecerá un menú contextual. 

1. En el menú contextual, seleccione **Agregar anotación**.

1. (Opcional) Agregue una descripción y etiquetas de la anotación.

1. Seleccione **Guardar**.

Como alternativa, para agregar una anotación, pulse `Ctrl` (o `Cmd`) mientras selecciona el panel y aparecerá el elemento emergente **Agregar anotación**.

**Anotaciones de región**

También puede crear anotaciones que cubran una región o un periodo de una visualización.

**Adición de una anotación de región**

1. En el panel, pulse `Ctrl` (o `Cmd`) mientras selecciona un área del panel.

1.  Agregue una descripción y etiquetas de la anotación (opcional). 

1.  Haga clic en **Guardar**. 

**Edición de una anotación**

1. En el panel de control, pase el ratón sobre un indicador de anotación en un panel.

1. Seleccione el icono **Editar** (lápiz) en la información sobre herramientas de anotación.

1. Modifique las and/or etiquetas descriptivas.

1. Seleccione **Guardar**.

**Eliminación de una anotación**

1. En el panel de control, pase el ratón sobre un indicador de anotación en un panel.

1. Seleccione el icono **Eliminar** (papelera) en la información sobre herramientas de la anotación.

## Obtención de anotaciones a través de la configuración del panel de control
<a name="v10-dash-fetch-annotations"></a>

En la configuración del panel de control, en **Anotaciones**, puede agregar nuevas consultas para obtener anotaciones mediante el uso de cualquier origen de datos, lo que incluye el origen de datos de anotaciones de datos integrada. Las consultas de anotaciones devuelven eventos que se pueden visualizar como marcadores de eventos en los gráficos del panel. 

**Adición de una consulta de anotaciones**

1. Seleccione el icono **Configuración** (engranaje) en el encabezado del panel para abrir el menú de configuración.

1. Seleccione **Anotaciones**.

1. Haga clic en **Agregar consulta de anotación**.

1. Ingrese un nombre para la consulta de anotaciones.

   Este nombre se le asigna al conmutador (casilla de verificación) que le permitirá habilitar la visualización de los eventos de anotación de esta consulta. 

1. Seleccione el origen de datos para las anotaciones.

   También puede elegir **Abrir el selector avanzado de orígenes de datos** para ver más opciones, incluida la adición de un nuevo origen de datos (disponible solo para administradores).

1. Si no quiere utilizar la consulta de anotación de inmediato, desactive la casilla **Habilitado**.

1. Si no quiere que el conmutador de consulta de anotaciones se muestre en el panel, seleccione la casilla **Oculto**.

1. Seleccione un color para los marcadores de eventos.

1. En el menú desplegable **Mostrar en**, elija una de las siguientes opciones:
   + **Todos los paneles**: las anotaciones se muestran en todos los paneles que admiten anotaciones.
   + **Paneles seleccionados**: las anotaciones se muestran en todos los paneles que seleccione.
   + **Todos los paneles excepto**: las anotaciones se muestran en todos los paneles excepto en los que seleccione.

1. Configure la consulta.

   Las opciones de consulta de anotaciones son diferentes para cada origen de datos. Para obtener información sobre las anotaciones de un origen de datos específico, consulte [Conexión con orígenes de datos](AMG-data-sources.md).

## Consulta integrada
<a name="v10-dash-built-in-query"></a>

Después de agregar una anotación, seguirán siendo visibles. Esto se debe a la consulta de anotación integrada que existe en todos los paneles. Esta consulta de anotación buscará todos los eventos de anotación que se originan en el panel actual, que están almacenados en Grafana, y los mostrará en el panel en el que se crearon. Esto incluye las anotaciones del historial del estado de las alertas.

De manera predeterminada, la consulta de anotaciones integrada utiliza el origen de datos `Grafana` especial, y las anotaciones manuales solo se admiten con este origen de datos. Puede utilizar otro origen de datos en la consulta de anotación integrada, pero solo podrá crear anotaciones automatizadas con el editor de consultas de ese origen de datos.

Para agregar anotaciones directamente al panel, esta consulta debe estar habilitada.

**Confirmación de que la consulta integrada está habilitada**

1. Seleccione el icono de **Configuración** (engranaje) del panel en el encabezado del panel para abrir el menú de configuración del panel de control.

1. Seleccione **Anotaciones**. 

1. Busque la consulta **Anotaciones y alertas (integrada)**.

   Si aparece **Deshabilitado** antes del nombre de la consulta, tendrá que seleccionar el nombre de la consulta para abrirla y actualizar la configuración.

**Cómo evitar que se busquen y dibujen las anotaciones**

1. Seleccione el icono de **Configuración** (engranaje) del panel en el encabezado del panel para abrir el menú de configuración del panel de control.

1. Seleccione **Anotaciones**. 

1. Seleccione la consulta **Anotaciones y alertas (integrada)**.

1. Seleccione el conmutador **Habilitado** para desactivarla.

Al copiar un panel mediante la característica **Guardar como**, obtendrá un nuevo ID de panel de control, por lo que las anotaciones creadas en el panel de origen no se verán en la copia. Puede seguir mostrándolas si agrega una nueva **consulta de anotación** y las filtra por etiquetas. Sin embargo, esto solo funciona si las anotaciones del panel de origen tienen etiquetas por las que filtrar.

**Filtrado de las consultas por etiqueta**

Puede crear consultas nuevas para buscar anotaciones a partir de la consulta de anotación integrada con el origen de datos `Grafana` mediante el establecimiento de **Filtrar por** en `Tags`.

Por ejemplo, cree una consulta de anotación con el nombre `outages` y especifique una etiqueta `outage`. Esta consulta mostrará todas las anotaciones (desde cualquier panel o mediante la API) que contengan la etiqueta `outage`. Si se definen varias etiquetas en una consulta de anotación, Grafana solo mostrará las anotaciones que coincidan con todas las etiquetas. Para modificar el comportamiento, habilite **Coincidir con cualquiera** y Grafana mostrará las anotaciones que contengan cualquiera de las etiquetas que haya proporcionado.

 También puede utilizar variables de plantilla en la consulta de etiquetas. Esto significa que, si tiene un panel que muestra las estadísticas de distintos servicios y una variable de plantilla que dicta qué servicios mostrar, puede utilizar la misma variable de plantilla en la consulta de anotaciones para mostrar solo las anotaciones de esos servicios. 

# Modelo JSON del panel de control
<a name="v10-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 10.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).  
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).

Un panel de 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.

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

1. Vaya a un panel de control.

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

1. Seleccione **Modelo JSON**.

## Campos JSON
<a name="v10-dash-json-fields"></a>

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": [],
  "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. | 
| `tags` | etiquetas asociadas al panel de control, una matriz de cadenas. | 
| `style` | tema del panel de control, como `dark` o `light` | 
| `timezone` | zona horaria del panel de control, como `utc` o `browser`. | 
| `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 para el panel de control, como `last 6 hours` o `last 7 days`. | 
| `timepicker` | metadatos del selector de tiempo; consulte la [sección del selector de tiempo](#v10-dash-json-panels) para obtener más información. | 
| `templating` | metadatos de plantillas; consulte la [sección de plantillas](#v10-dash-json-panels) para obtener más información. | 
| `annotations` | metadatos de anotaciones; consulte las [anotaciones](v10-dash-annotations.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 el esquema. | 
| `version` | versión del panel de control (entero), que se incrementa cada vez que se actualiza el panel de control. | 
| `panels` | matriz de paneles (consulte la siguiente sección para obtener más información). | 

## Paneles
<a name="v10-dash-json-panels"></a>

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 x utiliza la misma unidad que `w`.
+ `y`: la posición y utiliza 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"
      }
    ]
  }
```

En la siguiente tabla se describe el uso de los campos de creación de plantillas.


| Name | De uso | 
| --- | --- | 
|  `enable`  |  si la creación de plantillas está habilitada o no.  | 
|  `list`  |  una matriz de objetos, cada uno de los cuales representa una variable de plantilla  | 
|  `allFormat`  |  formato que se utilizará al obtener todos los valores del origen de datos, incluidos `wildcard`, `glob`, `regex` y `pipe`.  | 
|  `current`  |  muestra la variable seleccionada actualmente text/value en el tablero  | 
|  `datasource`  |  muestra el origen de datos de las variables  | 
|  `includeAll`  |  si la opción de todos los valores está disponible o no.  | 
|  `multi`  |  si se pueden seleccionar varios valores de la lista de valores variables.  | 
|  `multiFormat`  |  formato que se utilizará al obtener series temporales del origen de datos.  | 
|  `name`  |  nombre de la variable.  | 
|  `options`  |  matriz de text/value pares de variables disponibles para su selección en el tablero  | 
|  `query`  |  consulta del origen de datos que se utiliza para obtener los valores de una variable.  | 
|  `refresh`  |  configura cuándo actualizar una variable.  | 
|  `regex`  |  extrae parte del nombre de una serie o de un segmento de nodo métrico.  | 
|  `type`  |  tipo de la variable (`custom`, `query` o `interval`).  | 

# Prácticas recomendadas para paneles de control
<a name="v10-dash-bestpractices"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).  
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).

Esta sección proporciona información acerca de las prácticas recomendadas para los administradores y los usuarios de Grafana sobre cómo crear y mantener los paneles de Grafana.

Para obtener información sobre los diferentes tipos de paneles que puede crear, consulte la entrada de blog [Grafana dashboards: A complete guide to all the different types you can build](https://grafana.com/blog/2022/06/06/grafana-dashboards-a-complete-guide-to-all-the-different-types-you-can-build/?pg=webinar-getting-started-with-grafana-dashboard-design-amer&plcmt=related-content-1) en el sitio web de Grafana Labs.

**nota**  
Esta sección puede ayudar a crear una estrategia para la supervisión y el mantenimiento de los paneles. Conoce mejor sus sistemas y debería utilizar esta sección como guía para su comprensión. Finalmente, es su responsabilidad crear la estrategia recomendada para su sistema.

## Estrategias de observabilidad comunes
<a name="v10-dash-common-observability-strategies"></a>

Cuando tiene mucho que supervisar, como un conjunto de servidores, necesita una estrategia para decidir qué es lo bastante importante como para supervisar. En esta página, se describen varios métodos comunes para elegir lo que se va a supervisar.

Una estrategia lógica le permite crear paneles uniformes y escalar su plataforma de observabilidad con mayor facilidad.

**Directrices para las estrategias**
+ El método USE le indica qué tan bien se encuentran las máquinas, el método RED le indica qué tan satisfechos están los usuarios.
+ USE informa sobre las causas de los problemas.
+ RED informa sobre la experiencia del usuario y es más probable que informe sobre los síntomas de los problemas.
+ Supervisar ambos métodos es importante para comprender el sistema. Como práctica recomendada, preste atención a los síntomas y no a las causas. Por lo general, las alertas se configuran en los paneles de RED.

**Método USE**

USE significa:
+ **Utilización**: porcentaje de tiempo que el recurso está ocupado, como el uso de la CPU del nodo.
+ **Saturación**: cantidad de trabajo que debe hacer un recurso, que suele ser la longitud de la cola o la carga del nodo.
+ **Errores**: recuento de eventos de error.

Este método es el recomendado para los recursos de hardware de la infraestructura, como la CPU, la memoria y los dispositivos de red. Para obtener más información, consulte la entrada de blog de Brendan Gregg [The USE Method](http://www.brendangregg.com/usemethod.html).

**Método RED**

RED significa:
+ **Tasa**: solicitudes por segundo
+ **Errores**: número de solicitudes con error.
+ **Duración**: cantidad de tiempo que tardan estas solicitudes, distribución de las mediciones de latencia.

Este método es más aplicable a los servicios, especialmente a un entorno de microservicios. Para cada uno de sus servicios, instrumente el código para mostrar estas métricas para cada componente. Los paneles de control RED son buenos para alertar y. SLAs Un panel de RED bien diseñado es un indicador de la experiencia del usuario.

Para más información, consulte la entrada del blog de Tom Wilkie [The RED method: How to instrument your services](https://grafana.com/blog/2018/08/02/the-red-method-how-to-instrument-your-services).

**Las cuatro señales doradas**

Según el [manual de SRE de Google](https://landing.google.com/sre/sre-book/chapters/monitoring-distributed-systems/#xref_monitoring_golden-signals), si solo puede medir cuatro métricas de su sistema para el usuario, céntrese en estas cuatro.

Este método es similar al método RED, pero incluye la saturación.
+ **Latencia**: tiempo que se tarda en atender una solicitud.
+ **Tráfico**: cantidad de demanda que recibe su sistema.
+ **Errores**: tasa de solicitudes con error.
+ **Saturación**: qué tan “lleno” está el sistema,

## Modelo de madurez de administración del panel de control
<a name="v10-dash-management-maturity-model"></a>

*Madurez de administración del panel de control* se refiere al buen diseño y eficiencia de su ecosistema paneles. Se recomienda revisar periódicamente la configuración del panel para evaluar en qué punto se encuentra y cómo puede mejorar.

En términos generales, la madurez del panel puede definirse como baja, media o alta. 

 Gran parte del contenido de este tema se ha extraído de la charla de KubeCon 2019: Cuadros de mando de [Kubernetes infalibles para personas](https://www.youtube.com/watch?v=YE2aQFiMGfY) con problemas de sueño. 

**Bajo: estado predeterminado**

En esta fase, no tiene una estrategia coherente de administración de los paneles. Casi todos los usuarios empiezan aquí.

¿Cómo sabe que está aquí?
+ Todos los usuarios pueden modificar sus paneles.
+ Hay muchos paneles copiados y se reutilizan muy poco o nunca.
+ Paneles únicos que perduran para siempre.
+ Sin control de versiones (panel de control JSON en el control de versiones).
+ Mucha navegación en busca de paneles, se busca el panel correcto. Esto significa perder mucho tiempo al intentar encontrar el panel que necesita.
+ No tener ninguna alerta que lo dirija al panel correcto.

**Medio: paneles metódicos**

En esta etapa, empezará a administrar el uso de los paneles con paneles metódicos. Puede que haya diseñado una estrategia, pero hay algunas cosas que podría mejorar.

 ¿Cómo sabe que está aquí? 
+ Evite la proliferación mediante el uso de variables de plantilla. Por ejemplo, no necesita un panel independiente para cada nodo, sino que puede utilizar variables de consulta. Y lo que es mejor, también puede convertir el origen de datos en una variable de plantilla, de modo que pueda reutilizar el mismo panel en distintos clústeres y backends de supervisión.

  Para obtener ideas, consulte la lista de ejemplos en [Variables](v10-dash-variables.md).
+ Paneles metódicos según una [estrategia de observabilidad](#v10-dash-common-observability-strategies).
+ Paneles jerárquicos con desgloses para pasar al siguiente nivel.
+ El diseño del panel refleja las jerarquías de servicios. Por ejemplo, puede utilizar el método RED con una fila por servicio. El orden de las filas podría reflejar el flujo de datos a medida que se desplaza hacia abajo en el panel.
+ Compare entre sí: divida los paneles de servicio cuando la magnitud varíe. Asegúrese de que las métricas agregadas no oculten información importante.
+ Gráficos expresivos con un uso significativo del color y ejes de normalización siempre que sea posible.
  + Ejemplo de color significativo: el azul significa que es bueno, el rojo significa que es malo. Los [umbrales](v10-panels-configure-thresholds.md) pueden ser útiles para eso.
  + Ejemplo de normalización de ejes: al comparar el uso de la CPU, mida por porcentaje en lugar de por número bruto, ya que las máquinas pueden tener un número diferente de núcleos. La normalización del uso de la CPU en función del número de núcleos reduce la carga cognitiva, ya que el espectador puede confiar en que se están utilizando todos los núcleos al 100%, sin tener que saber el número de núcleos. CPUs
+ La navegación dirigida reduce las suposiciones.
  + Las variables de plantilla dificultan la navegación al azar o sin rumbo fijo.
  + La mayoría de los paneles deberían estar vinculados mediante alertas.
  + La navegación se efectúa con enlaces. Para obtener más información, consulte [Administración de los enlaces de panel de control](v10-dash-manage-dashboard-links.md).
+  JSON de panel con control de versiones. 

**Alto: uso optimizado**

En esta etapa, ha optimizado el uso de la administración de los paneles con una estrategia coherente y bien pensada. Requiere mantenimiento, pero los resultados merecen la pena.
+ Reducción activa de la proliferación.
  + Revise de manera periódica los paneles existentes para asegurarse de que siguen siendo pertinentes.
  + Solo los paneles aprobados se agregan a la lista maestra de paneles.
  + Seguimiento del uso del panel. Puede aprovechar [Información de uso](v10-dash-assess-dashboard-usage.md).
+ Consistencia por diseño.
+ Utilice bibliotecas de secuencias de comandos para generar paneles y garantizar la coherencia en el diseño y el estilo.
  + grafonnet (Jsonnet)
  + grafanalib (Python)
+ No se puede editar en el navegador. Los lectores del panel cambian las vistas con variables.
+ La búsqueda de paneles es la excepción, no la regla.
+ Experimente y haga pruebas en una instancia de Grafana independiente dedicada a esa finalidad, no en su instancia de producción. Cuando se demuestre que un panel en el entorno de prueba es útil, agregue ese panel a su instancia principal de Grafana.

## Prácticas recomendadas para crear paneles de control
<a name="v10-dash-best-practices-for-creating-dashboards"></a>

En esta sección se describen algunas de las prácticas recomendadas que debe seguir al crear paneles de Grafana.

**Antes de empezar**

 Estos son algunos principios que se deben tener en cuenta antes de crear un panel. 

**Un panel debe contar una historia o responder a una pregunta**

¿Qué historia intenta contar con el panel? Intente crear una progresión lógica de los datos, por ejemplo, de grandes a pequeños o de generales a específicos. ¿Cuál es el objetivo de este panel de control? (Sugerencia: si el panel no tiene un objetivo, pregúntese si de verdad lo necesita).

Mantenga los gráficos simples y céntrese en responder a la pregunta que se esté planteando. Por ejemplo, si su pregunta es “¿qué servidores tienen problemas?”, tal vez no sea necesario mostrar todos los datos del servidor. Simplemente muestre los datos de los que tienen problemas.

**Los paneles de control deberían reducir la carga cognitiva, no aumentarla**

*Carga cognitiva* es básicamente la cantidad de esfuerzo que necesita para pensar en algo para comprenderlo. Haga que su panel sea fácil de interpretar. Los usuarios (cuando se intente averiguar qué pasó a las 2 de la mañana) lo agradecerán.

 Pregúntese: 
+ ¿Sé qué representa exactamente cada gráfico? ¿Es obvio o tengo que pensarlo?
+ Si se lo muestro a otra persona, ¿cuánto tardará en comprenderlo? ¿Se confundirán?

**Disponga de una estrategia de supervisión**

Es fácil crear nuevos paneles de control. Es más difícil optimizar la creación de paneles de control y seguir un plan, pero vale la pena. Esta estrategia debería regir tanto el esquema general del panel como garantizar la coherencia en el diseño de los paneles individuales.

Consulte [Estrategias de observabilidad comunes](#v10-dash-common-observability-strategies) y [Niveles de madurez de la administración de los paneles](#v10-dash-management-maturity-model) para obtener más información.

**Escríbalo**

Una vez que tenga una estrategia o unas pautas de diseño, escríbalas para mantener la coherencia a lo largo del tiempo.

**Prácticas recomendadas que seguir**
+ Al crear un panel nuevo, asegúrese de que tenga un nombre significativo.
  + Si va a crear un panel para jugar o experimentar, coloque la palabra `TEST` o `TMP` en el nombre.
  + Considere la posibilidad de incluir su nombre o iniciales en el nombre del panel o como una etiqueta para que las personas sepan quién es el propietario del panel.
  + Elimine los paneles de experimentos temporales cuando haya terminado de usarlos.
+ Si crea muchos paneles relacionados, piense en cómo hacer referencias cruzadas entre ellos para facilitar la navegación. Para obtener más información, consulte [Prácticas recomendadas para administrar paneles de control](#v10-dash-best-practices-for-managing-dashboards), más adelante en esta sección.
+ Grafana recupera los datos de un origen de datos. Es importante tener conocimientos básicos de [Conexión con orígenes de datos](AMG-data-sources.md) en general y de los orígenes de datos específicos.
+ Evite actualizar innecesariamente el panel para reducir la carga en la red o en el backend. Por ejemplo, si los datos cambian cada hora, no es necesario establecer la frecuencia de actualización del panel en 30 segundos.
+ Utilice los ejes Y izquierdo y derecho al mostrar series temporales con diferentes unidades o rangos.
+ Agregue documentación a los paneles.
  + Para agregar documentación a panel, agregue una [visualización del panel de texto](v10-panels-text.md) al panel. Registre aspectos como la finalidad del panel, los vínculos a los recursos útiles e instrucciones que los usuarios puedan necesitar para interactuar con el panel.
  + Para agregar documentación a un panel, edite la configuración del panel y agregue una descripción. Cualquier texto que agregue aparecerá si pasa el cursor sobre la `i` pequeña en la esquina superior izquierda del panel.
+ Reutilice los paneles y aplique la coherencia mediante [plantillas y variables](v10-dash-variables.md).
+ Tenga cuidado al apilar los datos de los gráficos. Las visualizaciones pueden ser engañosas y ocultar datos importantes. Se recomienda desactivarlo en la mayoría de los casos.

## Prácticas recomendadas para administrar paneles de control
<a name="v10-dash-best-practices-for-managing-dashboards"></a>

 En esta página, se describen algunas de las prácticas recomendadas que debe seguir al administrar los paneles de Grafana. 

**Antes de empezar**

Estos son algunos principios que debe tener en cuenta antes de empezar a administrar los paneles.

**Observabilidad estratégica**

Existen varias [estrategias de observabilidad comunes](#v10-dash-common-observability-strategies). Debe investigarlas y decidir si le sirve una de ellas o si quiere crear la suya. De cualquier manera, piense en un plan, escríbalo y cúmplalo.

Adapte su estrategia a las necesidades cambiantes según sea necesario.

**Nivel de madurez**

¿Cuál es el nivel de madurez de su panel? Analice la configuración actual de su panel y compárela con el [modelo de madurez de la administración del panel](#v10-dash-management-maturity-model). Comprender en qué punto se encuentra puede ser útil para decidir cómo llegar a donde quiere estar.

**Prácticas recomendadas que seguir**
+ Evite la proliferación de los paneles, es decir, el crecimiento descontrolado de estos. La proliferación de los paneles afecta de manera negativa al tiempo necesario para encontrar el panel adecuado. Duplicar los paneles y cambiar “algo” (lo que es peor: conservar las etiquetas originales) es la forma más fácil de hacerlo de forma descontrolada.
  + Revise periódicamente los paneles y elimine los que no sean necesarios.
  + Si crea un panel temporal, tal vez para probar algo, agregue el prefijo `TEST:` al nombre. Elimine el panel cuando haya terminado.
+ Copiar los paneles sin cambios significativos no es una buena idea.
  + Se le pasarán por alto las actualizaciones del panel original, como los cambios en la documentación, las correcciones de errores o las adiciones a las métricas.
  + En muchos casos, las copias se hacen simplemente para personalizar la vista mediante la configuración de los parámetros de la plantilla. En su lugar, para ello, se debería mantener un vínculo al panel principal y personalizar la vista con los [parámetros de la URL](v10-panels-configure-data-links.md#v10-panels-data-link-variables).
+ Cuando deba copiar un panel, cámbiele el nombre de manera clara y *no* copie las etiquetas del panel. Las etiquetas son metadatos importantes para los paneles que se utilizan durante la búsqueda. Si se copian etiquetas, se pueden producir coincidencias falsas.
+ Mantenga un panel de paneles o paneles de referencia cruzada. Esto puede hacerse de varias maneras: 
  + Cree vínculos a paneles o vínculos de datos. Los enlaces pueden ir a otros paneles de control o a sistemas externos. Para obtener más información, consulte [Manage dashboard links](v10-dash-manage-dashboard-links.md).
  +  Agregue un [panel de lista de paneles](v10-panels-dashboard-list.md). A continuación, puede personalizar lo que ve mediante búsquedas de etiquetas o carpetas.
  + Agregue un [panel de texto](v10-panels-dashboard-list.md) y utilice Markdown para personalizar la visualización. 

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

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).  
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).

En la página **Paneles** de su espacio de trabajo (disponible al seleccionar **Paneles** en el menú de la izquierda), puede llevar a cabo tareas de administración de los paneles de control, incluida la organización de los paneles de control en carpetas.

Para obtener más información sobre cómo crear paneles de control, consulte [Creación de paneles de control](v10-dash-building-dashboards.md).

## Exploración de paneles de control
<a name="v10-dash-browse-dashboards"></a>

En la página **Paneles**, puede buscar y administrar carpetas y paneles de control. Esto incluye opciones para:
+ Crear carpetas y paneles de control.
+ Mover los paneles de control entre carpetas.
+ Eliminar varios paneles de control y carpetas.
+ Ir a una carpeta.
+ Administrar los permisos de las carpetas. Para obtener más información, consulte [Permisos de paneles y carpetas](dashboard-and-folder-permissions.md).

## Creación de carpetas de panel de control
<a name="v10-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. Las subcarpetas le permiten crear una jerarquía anidada en la organización de los paneles de control.

**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 de paneles y carpetas](dashboard-and-folder-permissions.md).

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

1. Inicie sesión en Grafana. 

1. En el menú de la izquierda, seleccione **Paneles**.

1. En la página **Paneles**, seleccione **Nuevo** y, a continuación, elija **Nueva carpeta** en el menú desplegable.

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.

**Edición del nombre de una carpeta**

1. Seleccione **Paneles** en el menú de la izquierda.

1. Seleccione la carpeta a la que desee cambiarle el nombre.

1. Seleccione el icono **Editar título** (lápiz) en el encabezado y actualice el nombre de la carpeta.

   El nombre de la nueva carpeta se guarda automáticamente.

**Permisos de carpetas**

Puede asignar permisos a una carpeta. El panel de control de la carpeta hereda todos los permisos que haya asignado a la carpeta. Puede asignar permisos a los roles, equipos y usuarios de la organización.

**Modificación de los permisos de una carpeta**

1. Seleccione **Paneles** en el menú de la izquierda.

1. Seleccione la carpeta de la lista.

1. En la página de detalles de la carpeta, seleccione **Acciones de la carpeta** y seleccione **Administrar permisos** en la lista desplegable.

1. Actualice los permisos según desee.

Los cambios se guardan automáticamente.

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

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).  
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).

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="v10-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. Seleccione **Listas de reproducción** en el menú de la izquierda.

1. Elija una lista de reproducción de la lista de 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.

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

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 <nombre de la lista de reproducción>**.

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.


| Mode | Description (Descripción) | 
| --- | --- | 
| Modo normal |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 
| Modo TV |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/v10-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/v10-dash-managing-playlists.html)  | 
| Modo quiosco |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/v10-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/v10-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="v10-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.

**Creación de una lista de reproducción**

1. Seleccione **Paneles** en el menú de la izquierda.

1. Seleccione **Listas de reproducción** en la página de listas de reproducción.

1. Seleccione **Nueva lista 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**. 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 **x** situado junto al panel de control.

1. Para guardar los cambios, seleccione **Guardar**.

## Guardado de una lista de reproducción
<a name="v10-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.

**Guardado de una lista de reproducción**

1. Seleccione **Paneles** en el menú de la izquierda.

1. Seleccione **Listas de reproducción** para ver las listas de reproducción disponibles.

1. Elija la lista de reproducción que desee.

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. Para guardar los cambios, seleccione **Guardar**.

## Edición o eliminación de una lista de reproducción
<a name="v10-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, o bien puede eliminar la lista de reproducción.

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

1. Seleccione **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. Para guardar los cambios, seleccione **Guardar**.

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

1. Seleccione **Listas de reproducción**.

1. Seleccione **Eliminar** junto a la lista de reproducción que desea eliminar.

**Reorganización del orden del panel de control en una lista de reproducción**

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

1. Para guardar los cambios, seleccione **Guardar**.

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

1. Seleccione **Eliminar** para eliminar un panel de control de la lista de reproducción.

1. Para guardar los cambios, seleccione **Guardar**.

## Uso compartido de una lista de reproducción en modo de visualización
<a name="v10-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.

**Uso compartido de una lista de reproducción en modo de visualización**

1. En el menú **Paneles de control** situada a la izquierda, seleccione **Listas de reproducción**.

1. Seleccione **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. Para copiar la URL al portapapeles, elija **Copiar dirección del enlace**.

1. Pegue la URL en el destino.

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

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).  
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).

Grafana le permite 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.

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="v10-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.

**Uso compartido de un panel de control**

1. Seleccione **Paneles** en el menú de la izquierda del espacio de trabajo.

1. Elija el tipo de panel de control que desea compartir.

1. Seleccione el icono de compartir en la parte superior de la pantalla.

   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.

**Uso compartido de un enlace directo**

1. Seleccione **Copiar**. 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.

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

1. Seleccione la pestaña **Instantánea**.

1. Seleccione la **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 las secciones de importación y exportación en [Creación de paneles de control](v10-dash-building-dashboards.md).

## Uso compartido de un panel
<a name="v10-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.

**Uso compartido de un panel**

1. Seleccione el título del panel que desee compartir. Se abre el menú de paneles.

1. Seleccione **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.

**Uso de un enlace directo**

1. Seleccione **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.

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

Una instantánea de un panel sirve para compartir 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.

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

1. En el cuadro de diálogo **Compartir panel**, seleccione la pestaña **Instantánea**.

1. Seleccione **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**.

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

1. Seleccione **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 raíz.

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

1. Guarde el panel de control.

# Variables
<a name="v10-dash-variables"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).  
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).

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).
+ De forma predeterminada, las variables preseleccionan el valor superior de la lista desplegable. Si prefiere elegir un valor vacío, cambie la configuración de las variables de la siguiente manera:

  1. Seleccione la casilla de verificación de **Opción Incluir todo**.

  1. En el campo **Personalizar todos los valores**, ingrese el valor `+`.

**Topics**
+ [Adición y administración de variables](v10-dash-variable-add.md)
+ [Inspección de variables](v10-dash-variable-add-inspect.md)
+ [Sintaxis de variable](v10-dash-variable-syntax.md)

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

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).  
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).

En la siguiente tabla se muestran los tipos de variables de 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. | 
| Personalizada | Define las opciones de la variable de forma manual mediante una lista separada por comas. | 
| Text box (Cuadro de texto) | Muestre un campo de entrada de texto libre con un valor predeterminado opcional. | 
| Constant | Define una constante oculta. | 
| Origen de datos | Cambie rápidamente el origen de datos de un panel de control completo. | 
| Interval | Las variables de intervalo representan intervalos de tiempo. | 
| 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). | 
| Variables globales | Variables integradas que se pueden utilizar en expresiones del editor de consultas. | 
| Variables encadenadas | Las consultas de variables pueden contener otras variables. | 

**Topics**
+ [Introducción de opciones generales](#v10-dash-variable-options)
+ [Adición de una variable de consulta](#v10-dash-variable-add-query)
+ [Adición de una variable personalizada](#v10-dash-variable-add-custom)
+ [Adición de una variable de cuadro de texto](#v10-dash-variable-add-text)
+ [Adición de una variable constante](#v10-dash-variable-add-constant)
+ [Adición de una variable de origen de datos](#v10-dash-variable-add-datasource)
+ [Adición de una variable de intervalo](#v10-dash-variable-add-internal)
+ [Adición de filtros ad hoc](#v10-dash-variable-add-adhoc)
+ [Configuración de las opciones de selección de variables](#v10-dash-variable-add-selection)
+ [Variables globales](#v10-dash-variable-add-global)
+ [Variables encadenadas](#v10-dash-variable-add-chained)
+ [Administración de variables](#v10-dash-variable-add-manage)
+ [Filtrado de variables con expresiones regulares](#v10-dash-variable-add-filter)

## Introducción de opciones generales
<a name="v10-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 **Nueva variable**.

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="v10-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.
   + La consulta debe devolver los valores denominados `__text` y `__value`. Por ejemplo, en SQL, puede usar una consulta como `SELECT hostname AS __text, id AS __value from MyTable`. Las consultas para otros idiomas variarán en función de la sintaxis.
   + 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](#v10-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](#v10-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="v10-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](#v10-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](#v10-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="v10-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="v10-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](v10-dash-variable-syntax.md#v10-dash-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="v10-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.

   También puede elegir **Abrir el selector avanzado de orígenes de datos** para ver más opciones, incluida la adición de un origen de datos (solo para administradores). Para obtener más información, consulte [Conexión con orígenes de datos](AMG-data-sources.md).

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](#v10-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="v10-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="v10-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.

   También puede elegir **Abrir el selector avanzado de orígenes de datos** para ver más opciones, incluida la adición de un origen de datos (solo para administradores). Para obtener más información, consulte [Conexión con orígenes de datos](AMG-data-sources.md).

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="v10-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="v10-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 debe interpolarse 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 usan expresiones regulares, por lo que se interpola la misma variable que `(host1|host2|host3)`. Todos los valores también se escapan de expresiones regulares. Si no fuera así, 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 formatea la misma variable que `("host1" OR "host2" OR "host3")`. En este caso, todos los valores se escapan para que solo contengan palabras de control de Lucene y comillas.

**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 RAW](v10-dash-variable-syntax.md#v10-dash-variable-syntax-raw).

### Opción Incluir todo
<a name="v10-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="v10-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="v10-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 `>`, por ejemplo, `>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**

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**

Solo es compatible con los orígenes de datos de Prometheus. 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.

**\$1\$1\$1timezone**

La variable `$__timezone` devuelve la zona horaria actualmente seleccionada, `utc` o una entrada de la base de datos de zonas horarias de la IANA (por ejemplo, `America/New_York`).

Si la zona horaria actualmente seleccionada es *Hora del navegador*, Grafana intentará determinar la zona horaria de su navegador.

## Variables encadenadas
<a name="v10-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.

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="v10-dash-variable-add-manage"></a>

La página de variables le permite agregar variables y administrar las variables existentes. También le permite [inspeccionar](v10-dash-variable-add-inspect.md) 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="v10-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**

Para esta 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
```

Esta expresión regular:

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

Devuelve los siguientes resultados:

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

# Inspección de variables
<a name="v10-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="v10-dash-variable-syntax"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).  
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).

Los 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* debajo de esta lista.
+ `[[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="v10-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 10.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).  
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).

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, seleccione **Información sobre el panel** 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. Seleccione **Conexiones** en la navegación principal del espacio de trabajo.

1. Elija **Orígenes de datos**.

1. Elija un origen de datos.

1. Seleccione la pestaña **Información**.

## Indicador de presencia
<a name="v10-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="v10-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. Puede ordenar los paneles con lo siguiente.
+ Vistas
+ Errores
+ Vistas
+ Tiempo de creación
+ Hora de actualización

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

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).  
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).

 Utilice las siguientes estrategias para poder solucionar problemas habituales en los paneles de control. 

## El panel de control funciona con lentitud
<a name="v10-dash-dashboard-is-slow"></a>
+ ¿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 ralentizar el panel de control. Intente reducir uno o ambos.
+ Podría haber una gran carga en la infraestructura de su red. Si la lentitud no es constante, este puede ser el problema.

## Problemas de la frecuencia de la actualización del panel de control
<a name="v10-dash-refresh-rate-issues"></a>

De forma predeterminada, Grafana consulta el origen de datos cada 30 segundos. Sin embargo, 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 el origen de datos no envía datos con la frecuencia suficiente como para que se produzcan cambios cada 30 segundos.

Le recomendamos lo siguiente:
+ Active la actualización automática solo en los paneles de control, paneles o variables si es necesario. Los usuarios pueden actualizar su navegador manualmente.
+ Si necesita una actualización automática, establezca la frecuencia de actualización en un periodo de tiempo más largo que tenga sentido, como una vez por minuto, cada 10 minutos o cada hora.
+ Compruebe el intervalo de tiempo del panel de control. Si el panel de control tiene un intervalo de tiempo más largo, como una semana, no necesita actualizarlo automáticamente y debería desactivarlo.

## Gestión o renderización de datos nulos incorrecta o confusa
<a name="v10-dash-handling-or-rendering-null-data-is-wrong-or-confusing"></a>

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, pero esto puede resultar engañoso.

Los gráficos que tienen la opción **Conectar valores nulos** establecida en **Siempre** conectarán las líneas en las que falten valores.

Una forma de solucionar este problema consiste en utilizar barras en lugar de líneas y tener la opción **Sin valores** (en **Opciones estándar**) configurada en `0`. En este caso, los datos que faltan se mostrarán como áreas del gráfico sin datos.

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

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 10.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).  
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).

Puede 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="v10-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="v10-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="v10-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.

## Paleta de comandos
<a name="v10-search-palette"></a>

Puede usar la paleta de comandos para hacer lo siguiente:
+ Buscar y abrir paneles y carpetas.
+ Crear paneles y reglas de alerta.
+ Localizar páginas dentro de Grafana.
+ Cambiar el tema a oscuro o claro.

Para abrir la paleta de comandos, ingrese `ctrl+k` (`cmd+k` en macOS). También puede seleccionar la entrada de búsqueda en la barra de navegación de Grafana.

**nota**  
Para ir al paso anterior, pulse `backspace` con la paleta de comandos vacía.