Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. Travailler dans la version 10 de Grafana
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. Travailler dans la version 9 de Grafana
Dans Amazon Managed Grafana, un tableau de bord est représenté par un objet JSON qui stocke les métadonnées de son tableau de bord. Les métadonnées du tableau de bord incluent les propriétés du tableau de bord, les métadonnées des panneaux, les variables de modèle et les requêtes des panneaux.
Pour afficher le JSON d'un tableau de bord
-
Ouvrez un tableau de bord.
-
Dans la barre de navigation supérieure, choisissez Gérer le tableau de bord.
-
Sélectionnez Afficher le JSON dans le menu déroulant.
champs JSON
Lorsqu'un utilisateur crée un nouveau tableau de bord, un nouvel objet JSON de tableau de bord est initialisé avec les champs suivants.
Note
Dans le JSON suivant, id
est affiché sous la formenull
, qui est la valeur par défaut qui lui est attribuée jusqu'à ce qu'un tableau de bord soit enregistré. Après avoir enregistré un tableau de bord, une valeur entière est attribuée au id
champ.
{
"id": null,
"uid": "cLV5GDCkz",
"title": "New dashboard",
"tags": [],
"style": "dark",
"timezone": "browser",
"editable": true,
"hideControls": false,
"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": []
}
Le tableau suivant fournit les détails d'utilisation pour chaque champ du tableau de bord JSON.
Nom | Utilisation |
---|---|
id | Identifiant numérique unique du tableau de bord (généré par la base de données). |
uid | L'identifiant unique du tableau de bord qui peut être généré par n'importe qui. uid Il s'agit d'une chaîne de 8 à 40 caractères. |
title | Titre actuel du tableau de bord. |
tags | Les balises associées au tableau de bord. Dans le JSON, les balises sont un tableau de chaînes. |
style
|
Le thème du tableau de bord (par exemple, dark oulight ). |
timezone
|
Fuseau horaire du tableau de bord (utc oubrowser ). |
editable
|
Si un tableau de bord peut être modifié. |
graphTooltip
|
Le style de l'infobulle.
|
time
|
La plage horaire du tableau de bord (par exemple, les 6 dernières heures, les 7 derniers jours). |
timepicker
|
Les métadonnées du timepicker. Pour de plus amples informations, veuillez consulter Sélecteur de temps. |
templating
|
Les métadonnées de modélisation. Pour de plus amples informations, veuillez consulter Modèles et variables. |
annotations
|
Les métadonnées des annotations. Pour de plus amples informations, veuillez consulter Annotations. |
refresh
|
Intervalle d'actualisation automatique. |
schemaVersion
|
Version du schéma JSON (entier), qui est incrémentée chaque fois qu'une mise à jour d'Amazon Managed Grafana modifie le schéma. |
version
|
Version du tableau de bord (entier), qui est incrémentée chaque fois que le tableau de bord est mis à jour. |
panels
|
La gamme de panneaux. Pour de plus amples informations, veuillez consulter Panneaux. |
Panneaux
Les panneaux sont les éléments de base d'un tableau de bord. Il comprend des requêtes de source de données, des types de graphes, des alias et d'autres données. Le panneau JSON se compose d'un tableau d'objets JSON, chacun représentant un panneau différent. La plupart des champs sont communs à tous les panneaux, mais certains champs dépendent du type de panneau. L'exemple suivant montre le panneau JSON d'un panneau de texte.
"panels": [
{
"type": "text",
"title": "Panel Title",
"gridPos": {
"x": 0,
"y": 0,
"w": 12,
"h": 9
},
"id": 4,
"mode": "markdown",
"content": "# title"
}
Taille et position du panneau
La gridPos
propriété décrit la taille et la position du panneau en coordonnées de la grille :
-
w
— 1 à 24 ans. La largeur du tableau de bord est divisée en 24 colonnes. -
h
— En unités de hauteur de grille. Chaque unité de hauteur de grille représente 30 pixels. -
x
— La position X. La position x utilise la même unité de colonne quew
. -
y
— La position y. La position y utilise la même unité de hauteur de grille queh
.
La grille a une gravité négative qui déplace les panneaux vers le haut s'il y a un espace vide au-dessus d'un panneau.
Sélecteur de temps
L'exemple suivant montre les timepicker
options.
"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"
}
Le tableau suivant fournit des informations sur l'utilisation detimepicker
.
Nom | Utilisation |
---|---|
collapse
|
S'il timepicker est effondré |
enable
|
Si elle timepicker est activée |
notice
|
Liste de tâches |
now
|
Liste de tâches |
refresh_intervals
|
Liste de tâches |
status
|
Liste de tâches |
type
|
Liste de tâches |
Création de modèles
Le templating
champ contient un tableau de variables de modèle avec leurs valeurs enregistrées et d'autres métadonnées. L'exemple suivant montre templating
les métadonnées.
"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"
}
]
}
Le tableau suivant fournit les détails d'utilisation de la section de création de modèles.
Nom | Utilisation |
---|---|
activer | Si la création de modèles est activée. |
liste | Un tableau d'objets, chacun représentant une variable de modèle |
Tous les formats | Format à utiliser lors de l'extraction de toutes les valeurs de la source de données (par exemplewildcard ,, glob regex , etpipe ). |
actuel | Affiche le texte ou la valeur de la variable actuellement sélectionnée sur le tableau de bord |
source de données | Affiche la source de données pour les variables |
Tout inclure | Si l'option « toutes les valeurs » est disponible |
multi | Si plusieurs valeurs peuvent être sélectionnées dans la liste des valeurs variables |
Multiformat | Le format à utiliser lors de la récupération des séries temporelles à partir de la source de données |
nom | Le nom d'une variable |
options | Le tableau de paires texte/valeur variables disponibles pour la sélection sur le tableau de bord |
query | La requête de source de données utilisée pour récupérer les valeurs d'une variable |
rafraîchir | Liste de tâches |
regex | Liste de tâches |
type | Le type de variable (custom query , ouinterval ) |