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 utilisation en les regroupant.

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

Cette fonctionnalité n'est compatible qu'avec les Google Cloud projets. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion.

Avant de commencer

Effectuez les opérations suivantes dans le Google Cloud projet dans lequel vous souhaitez créer et modifier des tableaux de bord personnalisés :

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 Google Cloud console. Pour en savoir plus sur l'utilisation de l'API Cloud Monitoring, consultez Tableau de bord avec un widget Text.

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

  1. Dans la Google Cloud console, 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 barre d'outils de la Google Cloud console, sélectionnez votre Google Cloud projet. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion.
  3. Sélectionnez un tableau de bord ou cliquez sur Créer un tableau de bord.
  4. Dans la barre d'outils, cliquez sur  Ajouter un widget.
  5. Dans la boîte de dialogue Ajouter un widget, accédez à la section Mise en page, puis sélectionnez Texte.
  6. Ajoutez un titre.

  7. Dans le volet Contenu, saisissez le texte que vous souhaitez afficher.

    Pour en savoir plus sur la mise en forme, consultez Syntaxe Markdown.

  8. Facultatif : Utilisez les champs du volet Affichage pour personnaliser votre contenu.

    Par exemple, vous pouvez configurer la visibilité du widget.

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

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

Syntaxe Markdown

Cette section décrit la plupart des syntaxes Markdown compatibles avec le widget de texte. Les balises HTML ne sont pas acceptées.

  • En-têtes

    Une ligne commençant par un dièse, #, 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 dièse, # Header. Pour un en-tête de deuxième niveau, utilisez deux dièses, ## Second-level header.

  • Paragraphes

    Pour créer un paragraphe, utilisez une ligne vide.

  • Mise en valeur

    • Italique : utilisez *italic* ou _italic_.
    • Gras : utilisez **bold** ou __bold__.
    • Gras et italique : utilisez ***bold and italic***.
    • Police à chasse fixe : utilisez des accents graves, `fixed font`.

  • Liens : format [link text](path).

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

    • Pour créer un lien vers une autre section du tableau de bord. L'ancre d'une section est le titre de la section, converti en minuscules avec des mots séparés par un trait d'union. Par exemple, pour créer un lien vers une section intitulée "Charts using variables" (Graphiques utilisant des variables), définissez le 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/.

  • Listes : vous pouvez créer des listes numérotées ou à puces, et vous pouvez imbriquer des listes.

    • Pour les listes numérotées, ajoutez le préfixe 1. à chaque élément de la liste. Lorsque le texte est affiché, les éléments sont numérotés de manière séquentielle. Exemple :

      1. Ordered list item 1
1. Ordered list item 2

    • Pour les listes à puces, ajoutez le préfixe (+), (-) ou (*) à chaque élément de la liste. Exemple :

      + Unordered list item 1
+ Unordered list item 2

    • Pour imbriquer des listes, mettez en retrait la liste imbriquée. Exemple :

      1.  Item 1
    + Nested unordered-list item 1
    + Nested unordered-list item 2
1.  Item 2
    1. Nested ordered-list item 1
    1. Nested ordered-list item 2

  • Variables : format ${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 des libellés où la clé est zone et la valeur est 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 rendues.

  • Échapper des caractères

    Certains caractères, comme les signes plus (+), sont convertis en éléments de liste. Si vous souhaitez afficher ces types de caractères littéralement, utilisez une barre oblique inverse pour échapper le caractère, \+.

Organiser les widgets du 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 l'utilisation d'un tableau de bord comportant de nombreux widgets en créant des sections dans votre tableau de bord ou en regroupant des widgets :

  • Pour créer des sections indexées dans votre tableau de bord, utilisez le widget d'en-tête de section. Lorsque vous ajoutez ce widget à votre tableau de bord, une table des matières est créée et une séparation horizontale est ajoutée 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 une ancre. Lors du dépannage, vous pouvez partager l'URL de la section avec un membre de votre équipe. Pour copier l'URL de la section, effectuez un clic droit sur 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. Il existe trois types de widgets de groupe : réductible, déroulant et onglet. Les widgets de groupe contiennent une collection de widgets et améliorent les performances en utilisant des données de priorité inférieure à récupérer pour 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. En revanche, les widgets de groupe déroulant et de groupe d'onglets n'affichent qu'un seul membre de la collection. La différence entre ces widgets réside dans la manière dont vous sélectionnez le membre à afficher à l'aide d'un menu ou d'un onglet.

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 modifiez la mise en page en grille, ces widgets ne sont pas disponibles.

Pour la plupart des widgets, vous pouvez configurer leur visibilité. Toutefois, les widgets organisationnels sont toujours visibles.

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 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 afin de créer un widget d'en-tête de section, consultez Tableau de bord avec un widget SectionHeader widget.

Pour ajouter un widget d'en-tête de section à l'aide de la Google Cloud console, procédez comme suit :

  1. Dans la Google Cloud console, 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 barre d'outils de la Google Cloud console, sélectionnez votre Google Cloud projet. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion.
  3. 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.

  4. Dans 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, alors une ligne horizontale est ajoutée après l'entrée dans la table des matières.

Ajouter des widgets de groupe réductible

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

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

  1. Dans la Google Cloud console, 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 barre d'outils de la Google Cloud console, sélectionnez votre Google Cloud projet. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion.
  3. Dans la boîte de dialogue Ajouter un widget, accédez à la section Mise en page, puis sélectionnez Groupe réductible.

  4. Pour ajouter un widget au groupe, faites-le glisser vers le groupe.

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

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

  6. Facultatif : Pour forcer la réduction du groupe par défaut, placez votre pointeur sur le widget afin d'activer la barre d'outils, puis cliquez sur Réduire le groupe.

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

Ajouter des widgets de groupe déroulant ou de groupe d'onglets

Les widgets de groupe déroulant et de groupe d'onglets contiennent une collection d'autres widgets, mais n'affichent qu'un seul membre de la collection. La différence entre ces widgets réside dans la manière dont vous sélectionnez le membre de la collection à afficher. Les groupes déroulants fournissent un menu, tandis que les groupes d'onglets fournissent des onglets dans la barre d'outils.

Pour en savoir plus sur l'utilisation de l'API Cloud Monitoring afin de créer ces widgets, consultez Tableau de bord avec un widget SingleViewGroup.

Pour ajouter ces widgets à un tableau de bord, procédez comme suit :

  1. Dans la Google Cloud console, 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 barre d'outils de la Google Cloud console, sélectionnez votre Google Cloud projet. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion.
  3. Si nécessaire, créez les widgets que vous souhaitez ajouter au widget de groupe.

  4. Dans la boîte de dialogue Ajouter un widget, accédez à la section Mise en page, puis sélectionnez Groupe déroulant ou Groupe d'onglets.

    Un widget du type sélectionné est ajouté à votre tableau de bord.

  5. Pour ajouter des widgets tels qu'un graphique en courbes à un widget de groupe, faites-les glisser dans le widget de groupe ou modifiez le widget de groupe et effectuez une opération d'ajout.

    Par exemple, pour ajouter des widgets à un widget de groupe d'onglets en modifiant le groupe, procédez comme suit :

    1. Dans la barre d'outils du widget, sélectionnez Modifier le groupe d'onglets, puis sélectionnez Modifier le groupe.
    2. Facultatif : Saisissez un titre pour le groupe.

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

      Le menu Ajouter un widget répertorie les widgets qui peuvent être ajoutés au groupe.

    4. Répétez l'étape précédente pour chaque widget que vous souhaitez ajouter au widget de groupe d'onglets.

    5. Utilisez les boutons Inférieur et Supérieur pour ordonner les widgets dans le widget de groupe.

    6. Cliquez sur Appliquer.

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

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

Étape suivante

Vous pouvez également ajouter des widgets à vos tableaux de bord personnalisés qui affichent les éléments suivants :

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 :