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.

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

Avant de commencer

Dans le projet Google Cloud dans lequel vous souhaitez créer et modifier des tableaux de bord personnalisés, procédez comme suit:

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

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

  8. Options: 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 supprimer vos modifications, cliquez sur Annuler.

  10. 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. Il existe trois types de widgets de groupe : réductible, déroulant et onglet. Les widgets de groupe contiennent une collection de widgets. Ils 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. 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 le fait que 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 optez pour un affichage sous forme de 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 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 barre d'outils de la console Google Cloud, sélectionnez votre projet Google Cloud. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion du dossier compatible avec les applications.
  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. 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 des widgets de groupe réductibles

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 barre d'outils de la console Google Cloud, sélectionnez votre projet Google Cloud. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion du dossier compatible avec les applications.
  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 celui-ci.

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

  5. 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.

  6. 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 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 façon 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 pour créer ces widgets, consultez la section Tableau de bord avec un widget SingleViewGroup.

Pour ajouter ces widgets à 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. Dans la barre d'outils de la console Google Cloud, sélectionnez votre projet Google Cloud. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion du dossier compatible avec les applications.
  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 le modifiant, procédez comme suit:

    1. Dans la barre d'outils du widget, sélectionnez Modifier le groupe d'onglets, puis 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 liste les widgets pouvant ê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 Moins et Plus pour organiser les widgets dans le widget de groupe.

    6. Cliquez sur Appliquer.

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

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

É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: