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.
Modelo JSON de panel
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana.
Para ver los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte. Trabajando en Grafana versión 9
Para ver los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte. Trabajando en Grafana versión 8
Un panel en Grafana está representado por un objeto JSON, que almacena los metadatos de su panel. Los metadatos del panel incluyen las propiedades del panel, los metadatos de los paneles, las variables de plantilla y las consultas del panel.
Para ver el JSON de un panel
-
Navegue hasta un panel de control.
-
En el menú de navegación superior, selecciona el icono de configuración del panel de control (engranaje).
-
Selecciona el modelo JSON.
Campos JSON
Cuando un usuario crea un panel nuevo, se inicializa un nuevo objeto JSON del panel 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. Tras guardar un cuadro de mando, se asigna un valor entero al id
campo.
{ "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.
Nombre | Uso |
---|---|
|
identificador numérico único para el panel (generado por la base de datos) |
|
identificador de panel único que puede generar cualquier persona. string (8-40) |
|
título actual del panel |
|
etiquetas asociadas al panel de control, una matriz de cadenas |
|
tema del tablero, como |
|
zona horaria del panel de control, como o |
|
si un panel es editable o no |
|
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 |
|
intervalo de tiempo para el panel de control, como o |
|
metadatos del selector de tiempo, consulte la sección del selector de tiempo para obtener más información |
|
metadatos de plantillas, consulte la sección de plantillas para obtener más información |
|
metadatos de anotaciones, consulta las anotaciones para saber cómo añadirlos |
|
intervalo de actualización automática |
|
versión del esquema JSON (entero), que se incrementa cada vez que una actualización de Grafana introduce cambios en este esquema |
|
versión del panel (entero), que se incrementa cada vez que se actualiza el panel |
|
matriz de paneles (consulte la siguiente sección para obtener más información) |
Paneles
Los paneles son los componentes básicos de un cuadro de mando. Consta de consultas de fuentes de datos, tipos de gráficos, alias y mucho más. El panel JSON 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 de panel JSON 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 tablero se divide en 24 columnas) -
h
— En unidades de altura de rejilla, cada una representa 30 píxeles. -
x
— La posición x, en la misma unidad quew
. -
y
— La posición y, en la misma unidad queh
.
La rejilla 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" }
Creación de plantillas
El templating
campo contiene una matriz de variables de plantilla con sus valores guardados junto con algunos 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 plantilla.
Nombre | Uso |
---|---|
|
si la creación de plantillas está habilitada o no |
|
una matriz de objetos, cada uno de los cuales representa una variable de plantilla |
|
formato que se utilizará al obtener todos los valores de la fuente de datos, incluidos |
|
muestra el texto/valor de la variable seleccionada actualmente en el panel |
|
muestra la fuente de datos de las variables |
|
si la opción de todos los valores está disponible o no |
|
si se pueden seleccionar varios valores o no de la lista de valores variables |
|
formato que se utilizará al obtener series temporales de la fuente de datos |
|
nombre de la variable |
|
matriz de pares de texto/valor variables disponibles para su selección en el panel |
|
consulta de fuente de datos utilizada para obtener los valores de una variable |
|
configura cuándo actualizar una variable |
|
extrae parte del nombre de una serie o de un segmento de nodo métrico |
|
tipo de variable |