Ajouter du texte et des regroupements à un tableau de bord

Ce document explique comment ajouter des informations utiles à un tableau de bord et comment regrouper des widgets dans un tableau de bord. Par exemple, vous pouvez ajouter des informations sur le tableau de bord, des liens vers des ressources pertinentes ou des instructions à suivre dans différentes situations. Lorsqu'un tableau de bord contient de nombreux widgets, vous pouvez améliorer son usabilité en les regroupant.

Pour en savoir plus sur l'API Cloud Monitoring, consultez la page Créer et gérer des tableaux de bord à l'aide d'API.

Avant de commencer

Ajouter du texte à un tableau de bord

La capture d'écran suivante illustre un widget de texte:

Exemple de tableau de bord avec un widget Text.

Les informations de cette section concernent la console Google Cloud. Pour en savoir plus sur l'utilisation de l'API Cloud Monitoring, consultez la section Tableau de bord avec un widget Text.

Pour ajouter un widget de texte à un tableau de bord, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page Tableaux de bord .

    Accéder à la page Tableaux de bord

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

  2. Sélectionnez un tableau de bord ou cliquez sur Créer un tableau de bord.
  3. Dans la barre d'outils, cliquez sur  Ajouter un widget.
  4. Dans la boîte de dialogue Ajouter un widget, accédez à la section Mise en page, puis sélectionnez Texte.
  5. Ajoutez un titre.

  6. Dans le volet Contenu, saisissez le texte à afficher.

    Pour en savoir plus sur la mise en forme, consultez la section Commandes Markdown acceptées.

  7. Options: utilisez les champs du volet Affichage pour personnaliser votre contenu.

  8. Pour appliquer vos modifications au tableau de bord, cliquez sur Appliquer dans la barre d'outils. Pour supprimer vos modifications, cliquez sur Annuler.

  9. Pour enregistrer le tableau de bord modifié, cliquez sur Enregistrer dans la barre d'outils.

Commandes Markdown compatibles

Cette section décrit les commandes Markdown compatibles avec le widget de texte:

  • En-têtes

    Une ligne commençant par un hachage, #, indique un en-tête. Vous pouvez utiliser plusieurs signes de hachage pour différents niveaux d'en-têtes. Par exemple, pour un en-tête de premier niveau, utilisez un seul hachage, # Header. Pour un en-tête de deuxième niveau, utilisez deux hashtags, ## Second-level header.

  • Polices

    • Italiques: utilisez *italic* ou _italic_.
    • Gras: utilisez **bold** ou __bold__.

  • Liens: formatez-les au format [link text](path).

    Vous pouvez utiliser n'importe quelle valeur pour link text. La valeur de path doit faire référence à un ancrage HTML dans le tableau de bord ou être une URL vers une page externe.

    • Pour créer un lien vers une autre section du tableau de bord. L'ancre d'une section correspond au titre de la section, converti en minuscules et séparé par un trait d'union. Par exemple, pour créer un lien vers une section intitulée "Graphiques utilisant des variables", définissez path sur #charts-using-variables.

    • Pour créer un lien vers une ressource externe, définissez path sur l'URL. Par exemple, pour créer un lien vers example.com, définissez path sur https://example.com/.

  • Variables: formatez-les sous la forme ${VARIABLE_NAME}.

    Le widget de texte n'affiche que la ou les valeurs de la variable. Par exemple, si vous avez une variable basée sur une étiquette dont la clé est zone et la valeur us-west1, le widget de texte affiche us-west1.

    Lorsque la valeur d'une variable est le caractère générique (*), le widget de texte affiche all.

    Les variables non reconnues sont affichées telles qu'elles sont écrites et ne sont pas affichées.

Organiser les widgets de tableau de bord

Les tableaux de bord personnalisés vous permettent de spécifier la position des graphiques, des règles d'alerte et d'autres widgets. Toutefois, vous pouvez améliorer la facilité d'utilisation d'un tableau de bord contenant de nombreux widgets en créant des sections ou en regroupant des widgets:

  • Pour créer des sections indexées dans votre tableau de bord, utilisez le widget "En-tête de section". Lorsque vous ajoutez ce widget à votre tableau de bord, un sommaire est créé et un séparateur horizontal est ajouté au tableau de bord. La table des matières vous permet d'accéder à une section spécifique du tableau de bord. Chaque widget de section contient un ancrage. Lorsque vous effectuez un dépannage, vous pouvez partager l'URL de la section avec un collègue. Pour copier l'URL de la section, effectuez un clic droit  Lien vers l'en-tête, puis sélectionnez Copier l'adresse du lien.

  • Pour réduire le temps de chargement d'un tableau de bord, utilisez des widgets de groupe réductibles et des widgets à vue unique. Ces deux widgets contiennent une collection de widgets et améliorent les performances en utilisant des données de priorité inférieure pour récupérer les membres de la collection qui ne sont pas affichés. Le widget de groupe réductible affiche tous les membres de la collection lorsqu'il est développé, sinon tous les membres sont masqués. À l'inverse, un widget de groupe en vue unique n'affiche qu'un seul membre de la collection à la fois, et vous utilisez un menu pour sélectionner le membre à afficher.

Pour utiliser les widgets décrits dans cette section, votre tableau de bord personnalisé doit utiliser le mode Mosaïque, qui est la mise en page par défaut. Si vous optez pour un affichage sous forme de grille, ces widgets ne sont pas disponibles.

Le reste de cette section explique comment ajouter et configurer des widgets que vous pouvez utiliser pour organiser vos tableaux de bord. Pour en savoir plus sur la modification de ces widgets, consultez la section Modifier la configuration d'un widget.

Ajouter un widget d'en-tête de section

Pour en savoir plus sur l'utilisation de l'API Cloud Monitoring pour créer un widget d'en-tête de section, consultez la section Tableau de bord avec un widget SectionHeader.

Pour ajouter un widget de titre de section à l'aide de la console Google Cloud, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page Tableaux de bord .

    Accéder à la page Tableaux de bord

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

  2. Dans la boîte de dialogue Ajouter un widget, accédez à la section Mise en page, puis sélectionnez le widget En-tête de section.

  3. Sur le widget, cliquez sur Modifier la section, puis remplissez la boîte de dialogue:

    • La valeur du champ Nom de la section s'affiche dans la table des matières.
    • La valeur du champ Sous-titre s'affiche dans le tableau de bord.
    • Si vous sélectionnez *Ajouter une séparation à la table des matières, une ligne horizontale est ajoutée après l'entrée dans la table des matières.

Ajouter un widget de groupe réductible

Pour en savoir plus sur l'utilisation de l'API Cloud Monitoring pour créer un widget de groupe réductible, consultez la section Tableau de bord avec un widget CollapsibleGroup.

Pour ajouter un widget de groupe réductible à l'aide de la console Google Cloud, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page Tableaux de bord .

    Accéder à la page Tableaux de bord

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

  2. Dans la boîte de dialogue Ajouter un widget, accédez à la section Mise en page, puis sélectionnez Groupe réductible.

  3. Pour ajouter un widget au groupe, faites-le glisser vers celui-ci.

    Une fois que vous avez ajouté des widgets au groupe, vous pouvez utiliser le pointeur pour les redimensionner et les repositionner.

  4. Pour ajouter un titre descriptif au groupe, placez votre pointeur sur le widget pour activer la barre d'outils, puis cliquez sur Modifier le groupe.

  5. Facultatif: Pour vous assurer que le groupe est réduit par défaut, placez votre pointeur sur le widget pour activer la barre d'outils, puis cliquez sur Réduire le groupe.

    Lorsqu'un widget de groupe réductible est réduit, la surveillance récupère les données des widgets du groupe avec une priorité inférieure à celle des autres widgets. Votre tableau de bord se charge ainsi plus rapidement.

Ajouter un widget de groupe en vue unique

Pour en savoir plus sur l'utilisation de l'API Cloud Monitoring pour créer un widget à vue unique, consultez la section Tableau de bord avec un widget SingleViewGroup.

Pour ajouter un widget de groupe en vue unique à l'aide de la console Google Cloud, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page Tableaux de bord .

    Accéder à la page Tableaux de bord

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

  2. Si nécessaire, créez les widgets que vous souhaitez ajouter au widget à vue unique.

  3. Dans la boîte de dialogue Ajouter un widget, accédez à la section Mise en page, puis sélectionnez Groupe de vues uniques.

    Un widget de groupe en vue unique est ajouté à votre tableau de bord.

  4. Ajouter des widgets au widget de groupe à vue unique:

    1. Dans le widget de groupe en vue unique, développez le menu Widget, puis sélectionnez Modifier le groupe.

    2. Cliquez sur Ajouter un widget, puis effectuez une sélection dans le menu Ajouter un widget.

    3. Répétez l'étape précédente pour chaque widget que vous souhaitez ajouter au widget de groupe en vue unique.

    4. Utilisez les boutons Moins et Plus pour organiser les widgets dans le widget de groupe.

    5. Cliquez sur Envoyer.

    Le tableau de bord est actualisé et seul l'un des widgets ajoutés au widget de groupe en vue unique est visible. La barre d'outils du widget affiché vous permet de le modifier ou d'effectuer d'autres actions.

Étape suivante

Vous pouvez également ajouter les widgets suivants à vos tableaux de bord personnalisés:

Pour en savoir plus sur l'exploration des données représentées graphiquement et le filtrage de vos tableaux de bord, consultez les documents suivants: