

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 del panel de control
<a name="v9-dash-dashboard-json-model"></a>

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

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

Para ver el JSON de un panel de control:

1. Vaya a un panel de control.

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

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

**Campos JSON**

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

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

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

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


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

**Paneles**

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

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

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

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

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

**Selector de tiempo**

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

**Plantillas **

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

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