Cette page a été traduite par l'API Cloud Translation.

Créer des tableaux de bord de visualisation

Cette page décrit le processus de création et de gestion des tableaux de bord dans votre instance Grafana, utilisée pour visualiser les journaux et les métriques de votre projet Google Distributed Cloud (GDC) isolé.

Un tableau de bord fournit une représentation visuelle dynamique des performances de votre système. Il se compose d'un ou plusieurs panneaux personnalisables, chacun étant configuré pour interroger et afficher des métriques spécifiques de vos composants GDC. Ces panneaux vous permettent d'effectuer les opérations suivantes :

Visualisez les métriques à l'aide de différents types de graphiques.
Définissez des seuils d'alerte pour déclencher des notifications en fonction des valeurs des métriques.
Personnalisez les propriétés d'affichage telles que les libellés, les unités et les plages de dates.
Définissez des résolutions temporelles cohérentes pour effectuer des comparaisons précises.

En utilisant efficacement les tableaux de bord Grafana, vous pouvez obtenir des informations précieuses sur les performances et l'état de votre environnement GDC.

Avant de commencer

Pour obtenir les autorisations nécessaires pour accéder aux tableaux de bord Grafana et les afficher, demandez à votre administrateur IAM de l'organisation ou du projet de vous accorder l'un des rôles de lecteur Grafana prédéfinis.

De plus, pour obtenir les autorisations nécessaires pour gérer les objets d'API requis pour créer des tableaux de bord, demandez à votre administrateur IAM de l'organisation ou du projet de vous accorder les rôles ConfigMap et Dashboard associés.

Selon le niveau d'accès et les autorisations dont vous avez besoin, vous pouvez obtenir des rôles de créateur, d'éditeur ou de lecteur pour ces ressources dans une organisation ou un projet. Pour en savoir plus, consultez Préparer les autorisations IAM.

Une fois les rôles correspondants obtenus, procédez comme suit avant de créer des tableaux de bord :

Collectez des métriques à partir de vos charges de travail.
Définissez le chemin d'accès au fichier kubeconfig en tant que variable d'environnement :
```
export KUBECONFIG=KUBECONFIG_PATH
```
Remplacez KUBECONFIG_PATH par le chemin d'accès au fichier kubeconfig du serveur de l'API Management sur lequel vous souhaitez créer le tableau de bord.

Identifier votre point de terminaison Grafana

L'URL suivante est le point de terminaison de l'instance Grafana de votre projet :

https://GDC_URL/PROJECT_NAMESPACE/grafana

Remplacez les éléments suivants :

GDC_URL : URL de votre organisation dans GDC.
PROJECT_NAMESPACE : espace de noms de votre projet.

Par exemple, le point de terminaison Grafana pour le projet platform-obs dans l'organisation org-1 est https://org-1/platform-obs/grafana.

Créer un tableau de bord personnalisé

Pour créer un tableau de bord Grafana et personnaliser vos paramètres, procédez comme suit :

Ouvrez votre point de terminaison Grafana pour afficher l'interface utilisateur.
Dans le menu de navigation, cliquez sur Ajouter.
Dans le menu déroulant, cliquez sur Tableau de bord. Grafana crée un tableau de bord vide.
Sur le tableau de bord vide, ajoutez tous les panneaux de votre choix.
Dans le menu Source de données de chaque panneau, sélectionnez la source de données souhaitée pour le panneau, y compris les métriques (prometheus), les journaux d'audit (auditloki) et les journaux opérationnels (oploki).

Pour les univers multizones, Grafana dispose de sources de données avec des libellés de zones que vous pouvez utiliser pour créer des visualisations de tableaux de bord avec des métriques et des journaux provenant de plusieurs zones. Ces sources de données sont nommées au format DATA_SOURCE-ZONE_ID, où :
- DATA_SOURCE peut prendre l'une des valeurs suivantes :
  - Prometheus (prometheus ou metrics) pour afficher les métriques.
  - Journaux d'audit (auditloki) pour afficher les journaux d'audit.
  - Journaux opérationnels (oploki) pour afficher les journaux opérationnels.
- ZONE_ID correspond à l'ID de la zone à partir de laquelle vous souhaitez afficher les données dans le tableau de bord.
De plus, pour créer un tableau de bord de visualisation pour les ressources multizones, le nom de la source de données est --Mixed--. Cette source de données vous permet d'ajouter plusieurs requêtes par zone et d'obtenir des visualisations de données interzones dans un seul tableau de bord. Vous pouvez utiliser cette fonctionnalité pour comparer les comportements entre, par exemple, une seule métrique ou une seule requête de journal sur plusieurs zones de votre univers.
Personnalisez vos informations et modifiez vos panneaux pour fournir vos requêtes ou effectuer d'autres modifications.

Conseil : Lorsque vous personnalisez votre tableau de bord, appliquez les bonnes pratiques pour votre cas d'utilisation afin de faciliter la visualisation et l'interprétation des données d'observabilité de vos composants. Par exemple, définissez des seuils d'acceptation, affichez des signaux utiles, ajoutez des libellés aux graphiques et choisissez une résolution temporelle cohérente.
Dans la barre de menu, cliquez sur Paramètres du tableau de bord pour ouvrir la page Paramètres.
Dans le menu de navigation, sélectionnez Modèle JSON.
Copiez le modèle JSON du tableau de bord et collez-le dans un fichier en texte brut pour l'utiliser ultérieurement.

Créer un objet `ConfigMap`.

Pour créer un objet ConfigMap contenant le modèle JSON du tableau de bord, procédez comme suit :

Ouvrez une fenêtre de terminal.
Créer un objet ConfigMap. Dans la section data de votre objet ConfigMap, collez le modèle JSON que vous avez copié précédemment :
```
apiVersion: v1
kind: ConfigMap
metadata:
  namespace: PROJECT_NAMESPACE
  name: CONFIGMAP_NAME
data:
  JSON_FILE_NAME.json: |
    {
    JSON_MODEL
    }
```
Remplacez les éléments suivants :
- PROJECT_NAMESPACE : espace de noms de votre projet.
- CONFIGMAP_NAME : nom que vous souhaitez attribuer à votre objet ConfigMap.
- JSON_FILE_NAME : nom que vous souhaitez donner au fichier du modèle JSON du tableau de bord.
- JSON_MODEL : modèle JSON de votre tableau de bord personnalisé.
Pour obtenir un exemple de ce à quoi cet objet doit ressembler, consultez un exemple de ConfigMap.

Appliquez l'objet ConfigMap au serveur de l'API Management :

kubectl --kubeconfig ${KUBECONFIG} apply -f CONFIGMAP_NAME.yaml

Exemple de `ConfigMap`

Le fichier YAML suivant montre un exemple de l'objet ConfigMap d'un tableau de bord dans l'espace de noms platform-obs :

  apiVersion: v1
  kind: ConfigMap
  metadata:
    namespace: platform-obs
    name: my-project-dashboard-configmap
  data:
    my-project-dashboard.json: |
      {
      "annotations": {
        "list": [
          {
            "builtIn": 1,
            "datasource": "--",
            "enable": true,
            "hide": true,
            "iconColor": "rgba(0, 211, 255, 1)",
            "name": "Annotations & Alerts",
            "type": "dashboard"
          }
        ]
      },
      "editable": true,
      "graphTooltip": 0,
      "id": null,
      "links": [],
      "panels": [],
      "schemaVersion": 27,
      "style": "dark",
      "tags": [],
      "templating": {
        "list": []
      },
      "time": {
        "from": "now-6h",
        "to": "now"
      },
      "timepicker": {},
      "timezone": "",
      "title": "Sample dashboard",
      "uid": null,
      "version": 0
      }

Créer une ressource personnalisée `Dashboard`

Pour créer une ressource personnalisée Dashboard et importer votre tableau de bord personnalisé dans l'instance Grafana de votre projet, procédez comme suit :

Ouvrez une fenêtre de terminal.
Créez une ressource personnalisée Dashboard et configurez le fichier avec le nom que vous avez donné à l'objet ConfigMap :
```
apiVersion: observability.gdc.goog/v1
kind: Dashboard
metadata:
  namespace: PROJECT_NAMESPACE
  name: DASHBOARD_NAME
spec:
  configMapRef:
    name: CONFIGMAP_NAME
    namespace: PROJECT_NAMESPACE
    key: JSON_FILE_NAME.json
  foldername: Default
```
Remplacez les éléments suivants :
- PROJECT_NAMESPACE : espace de noms de votre projet.
- DASHBOARD_NAME : nom que vous souhaitez attribuer à votre ressource personnalisée Dashboard.
- CONFIGMAP_NAME : nom que vous avez attribué à l'objet ConfigMap.
- JSON_FILE_NAME : nom que vous avez donné au fichier contenant le modèle JSON du tableau de bord dans l'objet ConfigMap.
Remarque : Pour organiser les tableaux de bord dans des dossiers, spécifiez foldername dans la section spec de la ressource Dashboard. Si vous omettez ce champ, le dossier Default sera utilisé par défaut. Les dossiers sont créés automatiquement s'ils n'existent pas.
Appliquez la ressource personnalisée Dashboard au serveur de l'API Management :
```
kubectl --kubeconfig ${KUBECONFIG} apply -f DASHBOARD_NAME.yaml
```

Le système surveille les modifications apportées à la ressource personnalisée Dashboard et à l'objet ConfigMap associé. Pour mettre à jour ou supprimer un tableau de bord, modifiez ces ressources. Toute modification déclenche une mise à jour de Grafana. Vous ne pouvez pas enregistrer les modifications effectuées directement dans l'interface utilisateur Grafana.

Créer des tableaux de bord de visualisation Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.