Modelo JSON de panel - Amazon Managed Grafana

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
  1. Navegue hasta un panel de control.

  2. En el menú de navegación superior, selecciona el icono de configuración del panel de control (engranaje).

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

id

identificador numérico único para el panel (generado por la base de datos)

uid

identificador de panel único que puede generar cualquier persona. string (8-40)

title

título actual del panel

tags

etiquetas asociadas al panel de control, una matriz de cadenas

style

tema del tablero, como dark o light

timezone

zona horaria del panel de control, como o utc browser

editable

si un panel 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 o last 6 hours last 7 days

timepicker

metadatos del selector de tiempo, consulte la sección del selector de tiempo para obtener más información

templating

metadatos de plantillas, consulte la sección de plantillas para obtener más información

annotations

metadatos de anotaciones, consulta las anotaciones para saber cómo añadirlos

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 introduce cambios en este esquema

version

versión del panel (entero), que se incrementa cada vez que se actualiza el panel

panels

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

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 de la fuente de datos, incluidoswildcard,, globregex,pipe.

current

muestra el texto/valor de la variable seleccionada actualmente en el panel

datasource

muestra la fuente 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 o no de la lista de valores variables

multiFormat

formato que se utilizará al obtener series temporales de la fuente de datos

name

nombre de la variable

options

matriz de pares de texto/valor variables disponibles para su selección en el panel

query

consulta de fuente de datos utilizada 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 variablecustom,query, o interval