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.
# Creación de paneles de control
****
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).
Después de crear un espacio de trabajo de Grafana e iniciar sesión, puede crear paneles de control y modificar la configuración para adaptarla a sus necesidades.
**Topics**
+ [Creación de paneles de control](v9-dash-creating.md)
+ [Adición o edición de paneles](v9-dash-edit-panels.md)
+ [Modificación de la configuración del panel de control](v9-dash-modify-settings.md)
+ [Variables de URL de panel de control](v9-dash-dashboard-url-variables.md)
+ [Adición de un panel de biblioteca a su panel de control](v9-dash-manage-library-panels.md)
+ [Administración del historial de versiones del panel de control](v9-dash-manage-version-history.md)
+ [Administración de los enlaces de panel de control](v9-dash-manage-dashboard-links.md)
+ [Modelo JSON del panel de control](v9-dash-dashboard-json-model.md)
# Creación de paneles de control
****
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).
**Creación de un panel de control**
Los paneles de control y los paneles le permiten mostrar los datos de forma visual con Grafana. Cada panel necesita al menos una consulta para mostrar una visualización. Complete los siguientes requisitos previos antes de comenzar.
+ Asegúrese de que disponga de los permisos necesarios. Para obtener más información sobre los permisos, consulte [Usuarios, equipos y permisos](Grafana-administration-authorization.md).
+ Identifique el panel de control al que desea agregar el panel.
+ Comprenda el lenguaje de consulta del origen de datos de destino.
+ Asegúrese de que se haya agregado el origen de datos para el que está escribiendo una consulta.
Creación de un panel de control:
1. Inicie sesión en Grafana, coloque el cursor sobre el **panel de control** y haga clic en **\$1 Nuevo panel**.
1. Haga clic en **Agregar un panel nuevo**.
1. En la primera línea de la pestaña **Consulta**, haga clic en la lista desplegable y seleccione un origen de datos.
1. Escriba o cree una consulta en el lenguaje de consulta del origen de datos.
1. En la lista **Visualizaciones**, seleccione un tipo de visualización. Grafana muestra una vista previa de los resultados de la consulta con esa visualización aplicada. Para obtener más información, consulte [Visualizations options](v9-panels-viz.md).
1. Ajuste la configuración del panel de las siguientes formas.
+ [Configuración de asignaciones de valores](v9-panels-configure-value-mappings.md)
+ [Opciones específicas de visualización](v9-panels-viz.md)
+ [Anulación de los valores de los campos](v9-panels-configure-overrides.md)
+ [Configuración de umbrales](v9-panels-configure-thresholds.md)
+ [Configuración de opciones estándar](v9-panels-configure-standard-options.md)
**nota**
La mayoría de las visualizaciones necesitan algunos ajustes antes de mostrar correctamente la información que necesita.
1. Agregue una nota para describir la visualización (o describir los cambios) y, a continuación, haga clic en **Guardar** en la esquina superior derecha de la página.
**nota**
Las notas son útiles si necesita revertir el panel de control a una versión anterior.
**Configuración de filas que se repiten**
Puede configurar Grafana para agregar dinámicamente paneles o filas a un panel de control en función del valor de una variable. Las variables cambian las consultas de forma dinámica en todas las filas de un panel de control. Para obtener más información sobre los paneles de repetición, consulte [Configuración de paneles de repetición]().
También puede repetir filas si tiene variables definidas con las opciones `Multi-value` o `Include all values` seleccionadas.
Antes de empezar, asegúrese de que la consulta incluya una variable con varios valores y, a continuación, complete los siguientes pasos.
1. En la página de inicio del panel, haga clic en **Agregar panel**.
1. En el cuadro de diálogo **Agregar un panel**, haga clic en **Agregar una nueva fila**.
1. Pase el ratón sobre el título de la fila y haga clic en el icono del engranaje.
1. En el cuadro de diálogo **Opciones de fila**, agregue un título y seleccione la variable para la que desee agregar filas repetidas.
**nota**
Para proporcionar contexto a los usuarios del panel de control, agregue la variable al título de la fila.
**Desplazamiento de un panel**
1. Abra el panel de .
1. Haga clic en el título del panel y arrástrelo a la nueva ubicación. Puede colocar un panel en un panel de control en cualquier ubicación.
**Cambio de tamaño de un panel**
1. Abra el panel de .
1. Para ajustar el tamaño del panel, seleccione y arrastre la esquina inferior derecha del panel. Puede ajustar el tamaño de un panel del panel de control a sus necesidades.
# Adición o edición de paneles
****
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).
Una vez que haya creado un panel de control, puede agregar, editar o eliminar los paneles en cualquier momento.
+ **Ver panel**: para ver un panel de control, en el menú **Inicio**, seleccione **Paneles** y, a continuación, elija el que desee ver. Puede que tenga que expandir la carpeta que contiene el panel.
+ **Agregar panel**: para agregar un panel a un panel de control, seleccione el icono de **Agregar panel** en la barra de menú situada cerca de la parte superior de la página.
+ **Editar panel**Para editar un panel existente en un panel de control, elija el icono de menú que aparece al pasar el ratón sobre él y, a continuación, seleccione **Editar**.
+ **Eliminar panel**Para eliminar un panel existente en un panel de control, elija el icono de menú que aparece al pasar el ratón sobre él y, a continuación, seleccione **Eliminar**.
# Modificación de la configuración del panel de control
****
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).
La página de configuración del panel de control le permite:
+ Editar las propiedades generales del panel de control, incluida la configuración de hora.
+ Agregue consultas de anotación.
+ Agregue variables de panel de control.
+ Agregue enlaces.
+ Visualización del modelo JSON de panel de control
Acceso a la página de configuración del panel de control:
1. Abra un panel de control en modo de edición.
1. Haga clic en **Configuración del panel** (icono de engranaje) en la parte superior de la página.
**Modificación de la configuración de hora del panel de control**
Ajuste la configuración de hora del panel de control cuando desee cambiar la zona horaria del panel de control o la hora del navegador local y especifique los intervalos de tiempo de actualización automática.
**Modificación de la configuración de hora del panel de control**
1. En la página **Configuración del panel**, seleccione **General**.
1. Vaya a la sección **Opciones de tiempo**.
1. Especifique la configuración de hora de acuerdo con las descripciones siguientes.
1. La zona horaria especifica la zona horaria local del servicio o sistema que está supervisando. Esto puede resultar útil cuando se supervisa un sistema o servicio que funciona en varias zonas horarias.
+ Grafana usa la zona horaria seleccionada *por defecto* para el perfil del usuario, el equipo o la organización. Si no se especifica una zona horaria para el perfil del usuario, el equipo del que es miembro el usuario o la organización, Grafana utiliza la hora local del navegador.
+ Se usa la zona horaria configurada para el navegador del usuario que lo visualiza, la *hora local del navegador*. Suele ser la misma zona horaria que la configurada en el equipo.
+ Utilice las [zonas horarias estándar ISO 8601](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones), incluida la UTC.
+ **Actualización automática** personaliza las opciones que se muestran para una hora relativa y las opciones de actualización automática. Las entradas están separadas por comas y aceptan cualquier unidad de tiempo válida.
+ **Retraso ahora** anula el tiempo `now`, ingrese un retraso. Utilice esta opción para adaptarse a los retrasos conocidos en la agregación de datos y evitar valores nulos.
+ **Ocultar el selector de tiempo** elimina la pantalla del selector de tiempo de Grafana.
**nota**
Para tener controles de tiempo, los datos deben incluir una columna de tiempo. Consulte la documentación de su [origen de datos](AMG-data-sources.md) específico para obtener más información sobre cómo incluir una columna de tiempo.
**Adición de una consulta de anotación**
Una consulta de anotación es una consulta que busca eventos. Estos eventos se pueden visualizar en gráficos a lo largo del panel de control en forma de líneas verticales junto con un pequeño icono sobre el que puede pasar el ratón para ver la información del evento.
**Adición de una consulta de anotación**
1. En la página **Configuración del panel**, seleccione **Anotaciones**.
1. Seleccione **Agregar consulta de anotación**.
1. Ingrese un nombre y seleccione un origen de datos.
1. Rellene el resto del formulario para crear una consulta y una anotación.
La interfaz de usuario del editor de consultas cambia en función del origen de datos que seleccione. Consulte la documentación del [origen de datos](AMG-data-sources.md) para obtener más información sobre cómo crear una consulta.
**Adición de una variable**
Las variables le permiten crear paneles de control más interactivos y dinámicos. En lugar de codificar de forma rígida elementos como los nombres de servidores, aplicaciones y sensores en las consultas de métricas, puede utilizar variables en su lugar. Las variables se muestran como listas desplegables en la parte superior del panel de control. Estos menús desplegables facilitan el cambio de datos que se muestran en el panel de control.
Para obtener más información acerca de las variables, consulte [Variables](v9-dash-variables.md).
1. En la página **Configuración del panel**, haga clic en **Variable** en el menú de la sección de la izquierda y, a continuación, en el botón **Agregar variable**.
1. En la sección **General**, agregue el nombre de la variable. Este es el nombre que se utilizará más adelante en las consultas.
1. Seleccione un **tipo** de variable.
**nota**
El tipo de variable que seleccione afectará a los campos que rellene en la página.
1. Defina la variable y haga clic en **Actualizar**.
**Adición de un enlace**
Los enlaces de panel de control le permiten colocar enlaces a otros paneles de control y sitios web directamente debajo del encabezado del panel de control. Los enlaces facilitan la navegación a otros paneles de control y contenidos relacionados.
1. En la página **Configuración del panel**, haga clic en **Enlaces** en el menú de la sección izquierda y, a continuación, pulse el botón **Agregar enlace**.
1. Ingrese el título y, en el campo **Tipo**, seleccione **Panel** o **Enlace**.
1. Para agregar un enlace de panel de control, agregue una etiqueta opcional, seleccione cualquiera de las opciones del enlace de panel de control y haga clic en **Aplicar**.
**nota**
Las etiquetas son útiles para crear un menú desplegable dinámico de paneles de control, todos los cuales tienen una etiqueta específica.
1. Para agregar un enlace, agregue una URL y un texto de información sobre herramientas que aparezca cuando el usuario pase el ratón sobre el enlace, seleccione un icono que aparezca junto al enlace y seleccione cualquiera de las opciones de enlace de panel de control.
**Visualización del modelo JSON de panel de control **
Un panel de control en Grafana está representado por un objeto JSON, que almacena los metadatos de su panel de control. Los metadatos del panel de control incluyen sus propiedades, los metadatos de los paneles, las variables de plantilla, las consultas del panel, etc.
Para ver un modelo JSON de un panel de control, en la página **Configuración del panel**, haga clic en **JSON**.
Para obtener más información acerca de los campos JSON, consulte [Campos JSON](v9-dash-dashboard-json-model.md).
# Variables de URL de panel de control
****
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).
Grafana puede aplicar los valores variables pasados como parámetros de consulta en el panel de control. URLs Para obtener más información, consulte [Manage dashboard links](v9-dash-manage-dashboard-links.md) y [Templates and variables](v9-dash-variables.md).
**Pasar variables como parámetros de consulta**
Grafana interpreta los parámetros de la cadena de consulta con el prefijo `var-` como variables en el panel de control dado.
Por ejemplo, en esta URL:
```
https://${your-domain}/path/to/your/dashboard?var-example=value
```
El parámetro de consulta `var-example=value` representa el ejemplo de la variable del panel de control con un valor de `value`.
**Pasar varios valores a una variable**
Para pasar varios valores, repita el parámetro de la variable una vez para cada valor.
```
https://${your-domain}/path/to/your/dashboard?var-example=value1&var-example=value2
```
Grafana interpreta `var-example=value1&var-example=value2` como el ejemplo de la variable del panel de control con dos valores: `value1` y `value2`.
**Adición de variables a los enlaces de panel de control**
Grafana puede agregar variables a los enlaces de panel de control cuando las genera a partir de la configuración de un panel de control. Para obtener más información, consulte [Manage dashboard links](v9-dash-manage-dashboard-links.md).
**Pasar filtros ad hoc**
Los filtros ad hoc aplican filtros de clave o valor a todas las consultas de métricas que utilizan un origen de datos específico. Para obtener más información, consulte [Filtros ad hoc]().
Para pasar un filtro ad hoc como parámetro de consulta, utilice la sintaxis de la variable para pasar la variable de filtro ad hoc y proporcione también la clave, el operador como valor y el valor como una lista separada por canalizaciones.
Por ejemplo, en esta URL:
`https://${your-domain}/path/to/your/dashboard?var-adhoc=example_key|=|example_value`
El parámetro de consulta `var-adhoc=key|=|value` aplica el filtro ad hoc configurado como variable de panel de control ad hoc mediante la clave `example_key`, el operador `=` y el valor `example_value`.
**nota**
Cuando URLs compartas con filtros ad hoc, recuerda codificar la URL. En el ejemplo anterior, sustituya las canalizaciones `(|)` por `%7C` y el operador de igualdad `(=)` por ` %3D`.
**Control del intervalo de tiempo mediante una URL**
Para establecer el intervalo de tiempo de un panel de control, utilice los parámetros de consulta `from`, `to`, `time` y `time.window`. Como no son variables, no requieren el prefijo `var-`.
# Adición de un panel de biblioteca a su panel de control
****
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).
Un panel de biblioteca es un panel reutilizable que puede usar en cualquier panel de control. Al cambiar un panel de biblioteca, el cambio se propaga a todas las instancias en las que se utilice el panel. Los paneles de biblioteca agilizan la reutilización de los paneles en varios paneles de control.
Puede guardar un panel de biblioteca en una carpeta junto con los paneles de control guardados.
**Creación de un panel de biblioteca**
Al crear un panel de biblioteca, el panel del panel de control de origen también se convierte en un panel de biblioteca. Deberá guardar el panel de control original una vez que se haya convertido el panel.
1. Abra un panel en modo de edición.
1. En las opciones de visualización del panel, haga clic en la opción de flecha hacia abajo para ingresar cambios en la visualización.
1. Para abrir el cuadro de diálogo **Crear**, haga clic en la opción **Paneles de biblioteca** y, a continuación, haga clic en **Crear panel de biblioteca**.
1. En **Nombre del panel de biblioteca**, ingrese el nombre.
1. En **Guardar en carpeta**, seleccione la carpeta en la que se guardará el panel de biblioteca.
1. Para guardar los cambios, haga clic en **Crear panel de biblioteca**.
1. Para guardar el panel de control, haga clic en **Guardar**.
Una vez creado el panel de biblioteca, puede modificar el panel desde cualquier panel de control en el que aparezca. Una vez guardados los cambios, todas las instancias del panel de biblioteca reflejarán estas modificaciones.
**Adición de un panel de biblioteca a un panel de control**
Agregue un panel de biblioteca de Grafana a un panel cuando desee proporcionar visualizaciones a otros usuarios del panel de control.
1. Coloque el cursor sobre la opción **Paneles** en el menú de la izquierda y, a continuación, seleccione **Nuevo panel** en las opciones desplegables. Se abrirá el cuadro de diálogo **Agregar panel**.
1. Haga clic en la opción **Agregar un panel** de la biblioteca de paneles. Verá una lista de los paneles de biblioteca.
1. Filtre la lista o busque el panel que desea agregar.
1. Haga clic en un panel para agregarlo al panel de control.
**Desvincular un panel de biblioteca**
Desvincule un panel de biblioteca cuando desee hacer un cambio en el panel y no afectar a otras instancias del panel de biblioteca.
1. Pase el ratón sobre el **Panel de control** en el menú de la izquierda y, a continuación, haga clic en **Paneles de biblioteca**.
1. Seleccione un panel de biblioteca que se utilice en distintos paneles de control.
1. Seleccione el panel que desea desvincular.
1. Haga clic en el título del panel y, a continuación, en **Editar**. El panel se abre en modo de edición.
1. En la esquina superior derecha de la página, haga clic en **Desvincular**.
**Visualización de una lista de paneles de biblioteca**
Desvincule un panel de biblioteca cuando desee hacer un cambio en el panel y no afectar a otras instancias del panel de biblioteca.
1. Pase el ratón sobre la opción **Panel de control** del menú de la izquierda y, a continuación, haga clic en **Paneles de biblioteca**. Puede ver una lista de paneles de biblioteca previamente definidos.
1. Busque un panel de biblioteca específico si conoce su nombre. También puede filtrar los paneles por carpeta o tipo.
**Eliminación de un panel de biblioteca**
Elimine un panel de biblioteca cuando ya no lo necesite.
1. Pase el ratón sobre el **Panel de control** en el menú de la izquierda y, a continuación, seleccione **Paneles de biblioteca**.
1. Seleccione el panel que desea eliminar.
1. Haga clic en el icono de eliminación junto al nombre de la biblioteca.
# Administración del historial de versiones del panel de control
****
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).
Siempre que guarde una versión del panel de control, se guardará una copia de esa versión para que nunca se pierdan las versiones anteriores. Para obtener una lista de estas versiones, ingrese la configuración del panel de control y, a continuación, seleccione **Versiones** en el menú de la izquierda.
La característica de historial de versiones del panel de control le permite comparar y restaurar versiones del panel de control guardadas anteriormente.
**Comparación de dos versiones del panel de control**
Para comparar dos versiones del panel de control, seleccione las dos versiones de la lista que desee comparar. Haga clic en **Comparar versiones** para ver las diferencias entre las dos versiones.
Al hacer clic en el botón, accederá a la vista de diferencias. De forma predeterminada, verá un resumen textual de los cambios.
Para ver la diferencia del JSON sin procesar que representa su panel de control, puede hacer eso y también hacer clic en el botón **Ver diferencias de JSON** en la parte inferior.
Si quiere restaurar la versión con la que está comparando las diferencias, puede hacerlo si pulsa el botón **Restaurar a la versión ** en la parte superior derecha.
**Restauración a una versión del panel de control guardada anteriormente**
Si necesita restaurar una versión del panel de control guardada anteriormente, puede hacer clic en el botón **Restaurar** situado a la derecha de una fila de la lista de versiones del panel de control o hacer clic en el botón **Restaurar a la versión ** en la vista de diferencias. Al hacer clic en el botón, aparecerá la siguiente ventana emergente en la que se le pedirá que confirme la restauración.
Tras la restauración a una versión anterior, se creará una nueva versión con los mismos datos exactos que la versión anterior, solo que con un número de versión diferente. Esto se indica en la **columna Notas** de la fila de la nueva versión del panel de control. Esto se hace simplemente para garantizar que las versiones anteriores del panel de control no se vean afectadas por el cambio.
# Administración de los enlaces de panel de control
****
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).
Puede usar los enlaces para navegar entre los paneles de control más utilizados o para conectar otros con sus visualizaciones. Los enlaces le permiten crear accesos directos a otros paneles de control e incluso a sitios web externos.
Grafana admite enlaces de panel de control, enlaces de panel y enlaces de datos. Los enlaces de panel de control se muestran en la parte superior del panel de control. Para acceder a enlaces de paneles, haga clic en un icono situado en la esquina superior izquierda del panel.
**Elección del enlace que se va a utilizar**
Comience por averiguar cómo navega actualmente entre los paneles de control. Si suele pasar de un conjunto de paneles de control a otro y tiene dificultades para encontrar el mismo contexto en cada uno de ellos, los enlaces pueden ayudarle a optimizar el flujo de trabajo.
El siguiente paso es determinar qué tipo de enlace es el adecuado para el flujo de trabajo. Aunque todos los tipos de enlaces de Grafana se utilizan para crear atajos a otros paneles de control o sitios web externos, funcionan en diferentes contextos.
+ Si el enlace se refiere a la mayoría de los paneles (si no a todos) del panel de control, utilice los enlaces de panel de control.
+ Si desea obtener más detalles de paneles específicos, utilice los enlaces de los paneles.
+ Si quiere crear un enlace a un sitio externo, puede usar un enlace de panel de control o un enlace de panel.
+ Si desea obtener más detalles de una serie específica, o incluso de una sola medición, utilice los enlaces de datos.
**Control del intervalo de tiempo mediante una URL**
Para controlar el intervalo de tiempo de un panel o panel de control, puede proporcionar los parámetros de consulta en la URL del panel de control:
+ `from` define el límite inferior del intervalo de tiempo, especificado en ms epoch.
+ `to` define el límite superior del intervalo de tiempo, especificado en ms epoch.
+ `time` y `time.window` definen un intervalo de tiempo de `time-time.window/2` a `time+time.window/2`. Ambos parámetros deben especificarse en ms. Por ejemplo, `?time=1500000000000&time.window=10000` dará como resultado un intervalo de tiempo de 10 segundos entre 1499999995000 y 1500000005000.
**Enlaces de panel de control**
Al crear un enlace de panel de control, puede incluir el intervalo de tiempo y las variables de la plantilla actual para pasar directamente al mismo contexto en otro panel de control. De esta forma, no tendrá que preocuparse de si la persona a la que le envía el enlace está viendo los datos correctos. Para ver otros tipos de enlaces, consulte [Variables de enlace de datos]().
Los enlaces del panel de control también se pueden usar como accesos directos a sistemas externos, por ejemplo, para enviar [un GitHub problema con el nombre del panel actual](https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests).
Después de agregar un enlace de panel de control, aparece en la esquina superior derecha del panel de control.
**Adición de enlaces a paneles de control**
Agregue enlaces a otros paneles de control en la parte superior del panel de control actual.
1. Mientras ve el panel al que desea crear un enlace, haga clic en el icono de engranaje ubicado en la parte superior de la pantalla para abrir **Configuración del panel**.
1. Haga clic en **Enlaces** y, a continuación, seleccione **Agregar enlace de panel de control** o **Nuevo**.
1. En **Tipo**, seleccione **paneles de control**.
1. Seleccione entre las opciones de enlace siguientes.
+ **Con etiquetas**: ingrese etiquetas para limitar los paneles de control enlazados a solo aquellos con las etiquetas que haya ingresado. De lo contrario, Grafana incluye enlaces a todos los demás paneles de control.
+ **Como menú desplegable**: seleccione esta opción si va a enlazar varios paneles y agregue un título opcional a la lista desplegable. De lo contrario, Grafana muestra los enlaces del panel de control en paralelo en la parte superior del panel.
+ **Intervalo de tiempo**: seleccione esta opción para incluir el intervalo de tiempo del panel de control en el enlace. Cuando el usuario hace clic en el enlace, el panel de control enlazado se abre con el intervalo de tiempo indicado ya establecido.
+ **Valores variables**: seleccione esta opción para incluir en el enlace las variables de plantilla que se utilizan actualmente como parámetros de consulta. Cuando el usuario hace clic en el enlace, todas las plantillas coincidentes del panel de control vinculado se configuran con los valores del enlace. Para obtener más información, consulte [Variables de URL de panel de control](v9-dash-dashboard-url-variables.md).
+ **Abrir en una pestaña nueva**: seleccione esta opción para abrir el enlace de panel de control en una nueva pestaña o ventana.
1. Haga clic en **Add (Añadir)**.
**Adición de un enlace URL a un panel de control**
Agregue un enlace a una URL en la parte superior del panel de control actual. Puede vincularlo a cualquier URL disponible, incluidos los paneles de control, los paneles o los sitios externos. Incluso puede controlar el intervalo de tiempo para garantizar que el usuario amplíe los datos correctos en Grafana.
1. Mientras ve el panel al que desea crear un enlace, haga clic en el icono de engranaje ubicado en la parte superior de la pantalla para abrir **Configuración del panel**.
1. Haga clic en **Enlaces** y, a continuación, seleccione **Agregar enlace de panel de control** o **Nuevo**.
1. En Tipo, seleccione **Enlace**.
1. Seleccione entre las opciones de enlace siguientes.
+ **URL**: ingrese la URL a la que quiere vincular. Según el destino, es posible que desee incluir valores de campo. Para obtener más información, consulte este [ejemplo de GitHub](https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests).
+ **Título**: ingrese el título que desee que muestre el enlace.
+ **Información sobre herramientas**: ingrese la información sobre herramientas que desee que muestre el enlace.
+ **Icono**: elija el icono que desee que aparezca junto con el enlace.
+ **Intervalo de tiempo**: seleccione esta opción para incluir el intervalo de tiempo del panel de control en el enlace. Cuando el usuario hace clic en el enlace, el panel de control enlazado se abre con el intervalo de tiempo indicado establecido.
+ `from` define el límite inferior del intervalo de tiempo, especificado en ms epoch.
+ `to` define el límite superior del intervalo de tiempo, especificado en ms epoch.
+ `time` y `time.window` definen un intervalo de tiempo de `time-time.window/2` a `time+time.window/2`. Ambos parámetros deben especificarse en ms. Por ejemplo, `?time=1500000000000&time.window=10000` dará como resultado un intervalo de tiempo de 10 segundos entre 1499999995000 y 1500000005000.
+ **Valores variables**: seleccione esta opción para incluir en el enlace las variables de plantilla que se utilizan actualmente como parámetros de consulta. Cuando el usuario hace clic en el enlace, todas las plantillas coincidentes del panel de control vinculado se configuran con los valores del enlace.
El formato de la variable es el siguiente:
`https://${you-domain}/path/to/your/dashboard?var-${template-varable1}=value1&var-{template-variable2}=value2`
+ **Abrir en una pestaña nueva**: seleccione esta opción para abrir el enlace de panel de control en una nueva pestaña o ventana.
1. Haga clic en **Add (Añadir)**.
**Actualización de un enlace de panel de control**
Para cambiar o actualizar un enlace de panel de control existente, use este procedimiento.
1. En **Configuración del panel**, en la pestaña **Enlaces**, haga clic en el enlace existente que desee editar.
1. Cambie la configuración y, a continuación, haga clic en **Actualizar**.
**Duplicación de un enlace de panel de control**
Para duplicar un enlace de panel de control existente, haga clic en el icono de duplicado situado junto al enlace existente que desee duplicar.
**Eliminación de un enlace de panel de control**
Para eliminar un enlace de panel de control existente, haga clic en el icono de la papelera del enlace que desea eliminar.
**Enlaces de panel**
Cada panel puede tener su propio conjunto de enlaces que se muestran en la esquina superior izquierda del panel. Puede vincularlo a cualquier URL disponible, incluidos los paneles de control, los paneles o los sitios externos. Incluso puede controlar el intervalo de tiempo para garantizar que el usuario amplíe los datos correctos en Grafana.
Para ver los enlaces de los paneles disponibles, haga clic en el icono de la esquina superior izquierda de un panel.
+ **Adición de un enlace de panel**: cada panel puede tener su propio conjunto de enlaces que se muestran en la esquina superior izquierda del panel. Puede vincularlo a cualquier URL disponible, incluidos los paneles de control, los paneles o los sitios externos. Incluso puede controlar el intervalo de tiempo para garantizar que el usuario amplíe los datos correctos en Grafana. Haga clic en el icono de la esquina superior izquierda de un panel para ver los enlaces de panel disponibles.
1. Pase el cursor del ratón sobre el panel en el que desee agregar un enlace y pulse `e`. O bien, haga clic en la flecha desplegable situada junto al título del panel y, a continuación, haga clic en **Editar**.
1. En la pestaña **Panel**, desplácese hacia abajo hasta la sección **Enlaces**.
1. Expanda **Enlaces** y, a continuación, haga clic en **Agregar enlace**.
1. Ingrese un **título**. **Título** es una etiqueta legible del enlace que se mostrará en la interfaz de usuario.
1. Ingrese la **URL** a la que quiere enlazar. Incluso puede agregar una de las variables de plantilla que se hayan definido en el panel de control. Pulse `Ctrl+Space` o `Cmd+Space` y haga clic en el campo de la URL para ver las variables disponibles. Al agregar variables de plantilla al enlace del panel, el enlace envía al usuario al contexto correcto, con las variables relevantes ya configuradas.
También puede utilizar variables de tiempo.
+ `from` define el límite inferior del intervalo de tiempo, especificado en ms epoch.
+ `to` define el límite superior del intervalo de tiempo, especificado en ms epoch.
+ `time` y `time.window` definen un intervalo de tiempo de `time-time.window/2` a `time+time.window/2`. Ambos parámetros deben especificarse en ms. Por ejemplo, `?time=1500000000000&time.window=10000` dará como resultado un intervalo de tiempo de 10 segundos entre 1499999995000 y 1500000005000.
+ **Actualización de un enlace de panel**
1. En la pestaña **Panel**, busque el enlace en el que desea hacer cambios.
1. Haga clic en el icono **Editar** (lápiz) para abrir la ventana Editar enlace.
1. Realice los cambios necesarios.
1. Haga clic en **Guardar** para guardar los cambios y cerrar la ventana.
1. Haga clic en **Guardar** en la esquina superior derecha para guardar los cambios en el panel de control.
+ **Eliminación de un enlace de panel**
1. En la pestaña **Panel**, busque el enlace en el que desea hacer cambios.
1. Haga clic en el icono **X** situado al lado del enlace que desea eliminar.
1. Haga clic en **Guardar** en la esquina superior derecha para guardar los cambios en el panel de control.
# Modelo JSON del panel de control
****
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).
Un panel de control en Grafana está representado por un objeto JSON, que almacena los metadatos de su panel de control. Los metadatos del panel incluyen las propiedades del panel de control, los metadatos de los paneles, las variables de plantilla y las consultas del panel.
Para ver el JSON de un panel de control:
1. Vaya a un panel de control.
1. En el menú de navegación superior, haga clic en el icono de **Configuración del panel** (engranaje).
1. Haga clic en **Modelo JSON**.
**Campos JSON**
Cuando un usuario crea un panel de control nuevo, se inicializa un nuevo objeto JSON del panel de control con los siguientes campos.
**nota**
En el siguiente JSON, el ID se muestra como null, que es el valor predeterminado que se le asigna hasta que se guarde un panel de control. Tras guardar un panel de control, se asigna un valor entero al campo `id`.
```
{
"id": null,
"uid": "cLV5GDCkz",
"title": "New dashboard",
"tags": [],
"style": "dark",
"timezone": "browser",
"editable": true,
"graphTooltip": 1,
"panels": [],
"time": {
"from": "now-6h",
"to": "now"
},
"timepicker": {
"time_options": [],
"refresh_intervals": []
},
"templating": {
"list": []
},
"annotations": {
"list": []
},
"refresh": "5s",
"schemaVersion": 17,
"version": 0,
"links": []
}
```
A continuación, se describe cada campo del JSON del panel de control.
| Name | De uso |
| --- | --- |
| **id** | identificador numérico único del panel de control (generado por la base de datos). |
| **uid** | identificador único del panel de control que cualquier persona puede generar. cadena (8-40). |
| **title** | título actual del panel de control. |
| **etiquetas** | etiquetas asociadas al panel de control, una matriz de cadenas. |
| **estilo** | tema del panel de control, como *oscuro* o *claro*. |
| **timezone** | zona horaria del panel de control, como *utc* o *navegador*. |
| **editable** | si un panel de control es editable o no. |
| **graphTooltip** | 0 si no se comparte el punto de mira o la información sobre herramientas (predeterminado), 1 si se comparte el punto de mira, 2 si se comparte el punto de mira o la información sobre herramientas compartida. |
| **time** | intervalo de tiempo del panel de control, como *últimas 6 horas* o *últimos 7 días*. |
| **timepicker** | metadatos del selector de tiempo; consulte la [sección del selector de tiempo](#v9-dash-dashboard-json-model) para obtener más información. |
| **templating** | metadatos de plantillas; consulte la [sección de plantillas](#v9-dash-dashboard-json-model) para obtener más información. |
| **annotations** | metadatos de anotaciones; consulte las [anotaciones](v9-panels-annotate-visualizations.md) para saber cómo agregarlos. |
| **refresh** | intervalo de actualización automática. |
| **schemaVersion** | versión del esquema JSON (entero), que se incrementa cada vez que una actualización de Grafana cambia a dicho esquema. |
| **versión** | versión del panel de control (entero), que se incrementa cada vez que se actualiza el panel de control. |
| **panels** | conjunto de paneles (consulte los detalles a continuación). |
**Paneles**
Los paneles son los componentes básicos de un panel de control. Consiste en consultas de orígenes de datos, tipos de gráficos, alias, etc. El JSON del panel consta de una matriz de objetos JSON, cada uno de los cuales representa un panel diferente. La mayoría de los campos son comunes a todos los paneles, pero algunos campos dependen del tipo de panel. El siguiente es un ejemplo del JSON del panel de un panel de texto.
```
"panels": [
{
"type": "text",
"title": "Panel Title",
"gridPos": {
"x": 0,
"y": 0,
"w": 12,
"h": 9
},
"id": 4,
"mode": "markdown",
"content": "# title"
}
```
**Tamaño y posición del panel**
La propiedad gridPos describe el tamaño y la posición del panel en las coordenadas de la cuadrícula.
+ `w`: de 1 a 24 (el ancho del panel de control se divide en 24 columnas).
+ `h`: cada unidad de altura de la tabla representa 30 píxeles.
+ `x`: la posición de x, en la misma unidad que `w`.
+ `y`: la posición de y, en la misma unidad que `h`.
La cuadrícula tiene una gravedad negativa que mueve los paneles hacia arriba si hay un espacio vacío por encima de un panel.
**Selector de tiempo**
```
"timepicker": {
"collapse": false,
"enable": true,
"notice": false,
"now": true,
"refresh_intervals": [
"5s",
"10s",
"30s",
"1m",
"5m",
"15m",
"30m",
"1h",
"2h",
"1d"
],
"status": "Stable",
"type": "timepicker"
}
```
**Plantillas **
El campo `templating` contiene un conjunto de variables de plantilla con los valores guardados junto con otros metadatos.
```
"templating": {
"enable": true,
"list": [
{
"allFormat": "wildcard",
"current": {
"tags": [],
"text": "prod",
"value": "prod"
},
"datasource": null,
"includeAll": true,
"name": "env",
"options": [
{
"selected": false,
"text": "All",
"value": "*"
},
{
"selected": false,
"text": "stage",
"value": "stage"
},
{
"selected": false,
"text": "test",
"value": "test"
}
],
"query": "tag_values(cpu.utilization.average,env)",
"refresh": false,
"type": "query"
},
{
"allFormat": "wildcard",
"current": {
"text": "apache",
"value": "apache"
},
"datasource": null,
"includeAll": false,
"multi": false,
"multiFormat": "glob",
"name": "app",
"options": [
{
"selected": true,
"text": "tomcat",
"value": "tomcat"
},
{
"selected": false,
"text": "cassandra",
"value": "cassandra"
}
],
"query": "tag_values(cpu.utilization.average,app)",
"refresh": false,
"regex": "",
"type": "query"
}
]
}
```