Créer et gérer des widgets de tableau de bord

Cette page explique comment créer et configurer des widgets de tableau de bord à l'aide de la vue de tableau de bord de Google Cloud Console. Tous les widgets de tableau de bord, à l'exception des zones de texte, peuvent afficher n'importe quel type de métrique ayant une valeur numérique ou de distribution, y compris des métriques personnalisées et des métriques basées sur les journaux. Les widgets de tableau de bord ne peuvent pas représenter graphiquement des données sous forme de chaîne.

Si vous êtes intéressé par l'explorateur de métriques, un autre outil permettant de créer des graphiques, consultez la section Utiliser l'explorateur de métriques.

Si vous souhaitez utiliser l'API Cloud Monitoring, consultez la page Gérer les tableaux de bord à l'aide d'API.

Avant de commencer

Assurez-vous de disposer de l'un des rôles décrits dans la section Autorisation.

Concevoir un tableau de bord

Lorsque vous sélectionnez des widgets, tenez compte des informations que vous souhaitez afficher et de la meilleure manière d'afficher ces données :

  • Pour afficher les données d'une série temporelle sur un intervalle de temps, créez un graphique en courbes, un graphique en aires empilées, un graphique à barres empilées ou un graphique de carte de densité. Les graphiques à barres empilées sont recommandés pour les métriques comportant des échantillons peu fréquents, telles que les métriques de quotas qui présentent un échantillon par jour. Les graphiques de carte de densité sont recommandés pour les métriques avec une valeur de distribution.

    Sur cette page, le terme graphique désigne uniquement les graphiques en courbes, les graphiques en aires empilées, les graphiques à barres et les graphiques à cartes de densité. Dans ce contexte, le terme graphique ne fait pas référence à des graphiques d'alerte.

  • Pour indiquer si la valeur la plus récente se trouve dans une zone de danger, une zone d'avertissement ou dans une plage de valeurs prévue, ajoutez une jauge ou un tableau de données.

  • Pour ajouter des informations sur le tableau de bord ou sur la procédure à suivre dans différentes situations, ajoutez une zone de texte.

  • Pour afficher le résumé d'une règle d'alerte à condition unique sur un tableau de bord, ajoutez un graphique d'alerte. Les graphiques d'alerte affichent les séries temporelles surveillées par une règle d'alerte, un seuil et des puces qui répertorient le nombre d'incidents associés à la règle et indiquent si cette règle est désactivée ou non.

Après avoir sélectionné le type d'information, l'étape suivante consiste à choisir les données spécifiques à afficher par le widget. Cette page fournit des informations générales. Pour en savoir plus, consultez la page Sélectionner des données à représenter sous forme de graphique.

Un tableau de bord peut contenir jusqu'à 40 widgets simultanément.

Ajouter un widget à un tableau de bord

Cette section explique comment ajouter un widget à un tableau de bord. Pour en savoir plus sur la configuration, consultez la section Configurer un widget de tableau de bord.

Pour modifier un tableau de bord, assurez-vous que votre rôle IAM (Identity and Access Management) pour le projet de champ d'application d'un champ d'application des métriques inclut l'autorisation de modifier. Pour en savoir plus sur les rôles, consultez la page Contrôle des accès.

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

  1. Dans Cloud Console, sélectionnez Surveillance ou cliquez sur le bouton suivant :

    Accéder à Monitoring

  2. Dans le panneau de navigation Monitoring, cliquez sur Tableaux de bords :

    • Si vous souhaitez créer un tableau de bord, cliquez sur Créer un tableau de bord.
    • Pour mettre à jour un tableau de bord existant, cliquez sur la mosaïque de tableau de bord si elle apparaît sous Tableaux de bord récents, ou recherchez le tableau de bord dans la liste de tous les tableaux de bord, puis cliquez sur son nom.
  3. Assurez-vous que le bouton Editing (Modifier) s'affiche. Si la fenêtre n'apparaît pas, cliquez sur le menu Affichage et sélectionnez Passer en mode Édition.

  4. Dans la bibliothèque de graphiques, cliquez sur le widget que vous souhaitez ajouter au tableau de bord. Vous pouvez également faire glisser le widget de la bibliothèque vers la zone du graphique. Un widget préconfiguré du type sélectionné s'affiche.

    Vous pouvez modifier la configuration du widget, modifier sa taille et sa position sur le tableau de bord à l'aide de votre pointeur. Vous pouvez aussi modifier le type de widget pour tous les widgets, à l'exception des graphiques d'alerte. Par exemple, vous pouvez convertir un graphique en courbes en graphique à barres empilées.

    La capture d'écran suivante illustre un graphique en courbes et son volet de configuration :

    Exemple d'ajout d'un graphique en courbes à un tableau de bord.

  5. Configurez le widget à l'aide du volet de configuration qui s'affiche lorsque le tableau de bord est modifiable et que le widget est sélectionné :

    • Pour configurer rapidement un widget, utilisez le mode Basique. Ce mode dispose d'options de configuration minimales. Une configuration de base peut toujours être représentée dans les autres modes.

    • Pour accéder à tous les champs de configuration du widget, utilisez le mode Avancé. Ce mode permet d'accéder à la plupart des champs d'agrégation. Ce mode n'est pas disponible pour tous les types de widgets. Une configuration avancée risque de ne pas pouvoir être représentée dans le mode de base plus simple.

    • Pour configurer un widget à l'aide de MQL, utilisez le mode MQL. Une configuration MQL peut ne pas pouvoir être représentée dans les autres modes.

  6. (Facultatif) Dans la barre d'outils du tableau de bord, cliquez sur Ajouter un graphique pour activer la bibliothèque de graphiques, puis répétez les étapes précédentes pour chaque widget que vous souhaitez ajouter. au tableau de bord.

Configurer un widget de tableau de bord

Cette section explique comment configurer des widgets de tableau de bord à l'aide des sélecteurs Google Cloud Console. Vous pouvez également créer un graphique ou modifier la configuration d'un widget de tableau de bord en modifiant la représentation JSON du tableau de bord.

Configurer un graphique

Cette section explique comment configurer des graphiques en courbes, des graphiques en aires empilées, des graphiques à barres et des graphiques de carte de densité. Pour en savoir plus sur l'ajout d'un graphique à votre tableau de bord à l'aide de Google Cloud Console, consultez la section Étapes générales pour ajouter un widget à un tableau de bord. Si vous souhaitez utiliser l'API Cloud Monitoring, consultez la section Tableau de bord avec un widget XyChart.

Basic

Pour configurer un graphique en courbes, en aires empilées, à barres ou sous forme de carte de densité en mode Basic, procédez comme suit:

  1. Sélectionnez les données de séries temporelles que vous souhaitez afficher :

    • Pour modifier le type de ressource et la métrique, sélectionnez une option dans les menus. Le menu Resource type (Type de ressource) répertorie toutes les ressources surveillées pour lesquelles des données de métriques sont disponibles. Le menu Métrique est déterminé par la sélection du Type de ressource.

      • Pour rechercher une entrée spécifique dans un menu, utilisez la barre de défilement ou saisissez du texte dans la zone Filtre du menu. Lorsque vous saisissez du texte, les entrées du menu sont limitées à celles incluant le texte saisi.

      • Si vous souhaitez accéder à un type de ressource ou à une métrique qui ne contient pas encore de données, vous devez modifier le comportement par défaut :

        • Pour sélectionner n'importe quel type de ressource, développez le menu Type de ressource, puis décochez la case Afficher uniquement les éléments actifs.

        • Pour afficher toutes les métriques du type de ressource sélectionné, même celles sans données, développez le menu Métrique, puis décochez la case Afficher uniquement les éléments actifs.

        • Pour sélectionner n'importe quelle métrique, cliquez sur Fermer dans le menu Resource type (Type de ressource), puis recherchez l'entrée qui vous intéresse. s'affiche en haut de l'écran. En cliquant sur "Fermer sur le type de ressource", le menu Métrique inclut toutes les métriques.

        • Pour afficher ou modifier les paramètres de type de ressource et de métrique utilisés par l'API Cloud Monitoring, dans le menu Type de ressource, cliquez sur Mode de filtrage direct.

      Pour plus d'informations sur la sélection de métriques, consultez la page Sélectionner des données à représenter dans le graphique.

    • Pour ajouter un filtre, cliquez sur Ajouter un filtre, puis sélectionnez le libellé et sa valeur. Vous pouvez ajouter plusieurs filtres. Par exemple, vous pouvez afficher les données d'une zone en appliquant un filtre. Pour en savoir plus sur les filtres, consultez la section Filtrer les données représentées graphiquement.

  2. Déterminez si vous souhaitez afficher chaque série temporelle ou regrouper les séries temporelles par valeur de libellé.

    • Pour afficher toutes les séries temporelles, ne cochez pas la case Affichage groupé.
    • Pour regrouper des séries temporelles par valeur de libellé, cochez la case Groupée, puis utilisez le menu Group by (Grouper par) pour sélectionner les libellés à regrouper. Une fois que vous avez fait votre choix, cliquez sur OK.
  3. Déterminez comment combiner les points de données :

    • Si les cases d'option ne répertorient que les centiles, vous avez sélectionné une métrique ayant une valeur de distribution. Utilisez les cases d'option pour sélectionner le centile de la distribution à afficher.

    • Si les cases d'option répertorient mean, min et max, vous avez sélectionné une métrique avec une valeur numérique. Utilisez ces cases d'option pour spécifier la façon dont les points de données sont combinés dans le cadre du processus de création d'un graphique. Par exemple, si un graphique affiche 60 points de données et que des données sont écrites à un point par minute, le graphique peut afficher une heure de données. Pour afficher trois heures de données, vous devez diminuer le nombre de points de données de 180 à 60. Lorsque ce sélecteur est mean, chaque point du graphique correspond à la moyenne de trois points dans la série temporelle d'origine.

  4. (Facultatif) Pour configurer l'affichage des données dans un graphique, cliquez sur Paramètres :

    Pour en savoir plus sur les légendes de graphique, consultez la section Configurer des légendes.

Avancé

Si vous utilisez le mode Avancé et que vous sélectionnez le mode Basique, des messages d'erreur peuvent s'afficher. Ces paramètres s'affichent lorsque la configuration que vous sélectionnez en mode Avancé ne peut pas être représentée avec les options disponibles en mode Basic.

Pour configurer un graphique en courbes, en aires empilées, à barres ou sous forme de carte de densité en mode avancé, procédez comme suit:

  1. Sélectionnez les données de séries temporelles que vous souhaitez afficher :

    • Pour modifier le type de ressource et la métrique, sélectionnez une option dans les menus. Le menu Resource type (Type de ressource) répertorie toutes les ressources surveillées pour lesquelles des données de métriques sont disponibles. Le menu Métrique est déterminé par la sélection du Type de ressource.

      • Pour rechercher une entrée spécifique dans un menu, utilisez la barre de défilement ou saisissez du texte dans la zone Filtre du menu. Lorsque vous saisissez du texte, les entrées du menu sont limitées à celles incluant le texte saisi.

      • Si vous souhaitez accéder à un type de ressource ou à une métrique qui ne contient pas encore de données, vous devez modifier le comportement par défaut :

        • Pour sélectionner n'importe quel type de ressource, développez le menu Type de ressource, puis décochez la case Afficher uniquement les éléments actifs.

        • Pour afficher toutes les métriques du type de ressource sélectionné, même celles sans données, développez le menu Métrique, puis décochez la case Afficher uniquement les éléments actifs.

        • Pour sélectionner n'importe quelle métrique, cliquez sur Fermer dans le menu Resource type (Type de ressource), puis recherchez l'entrée qui vous intéresse. s'affiche en haut de l'écran. En cliquant sur "Fermer sur le type de ressource", le menu Métrique inclut toutes les métriques.

        • Pour afficher ou modifier les paramètres de type de ressource et de métrique utilisés par l'API Cloud Monitoring, dans le menu Type de ressource, cliquez sur Mode de filtrage direct.

      Pour plus d'informations sur la sélection de métriques, consultez la page Sélectionner des données à représenter dans le graphique.

    • Pour ajouter un filtre, cliquez sur Ajouter un filtre, puis sélectionnez le libellé et sa valeur. Vous pouvez ajouter plusieurs filtres. Par exemple, vous pouvez afficher les données d'une zone en appliquant un filtre. Pour en savoir plus sur les filtres, consultez la section Filtrer les données représentées graphiquement.

  2. Sélectionnez le mode de prétraitement des séries temporelles.

    Les options de prétraitement s'affichent lorsque la métrique sélectionnée présente un type de métrique delta ou cumulatif. Les options spécifiques disponibles sont déterminées par le type de valeur de la métrique.

    En général, ce paramètre peut être laissé sur la valeur par défaut.

    Lorsque des options de prétraitement sont disponibles, utilisez les cases d'option pour spécifier le mode de traitement des données brutes avant l'alignement des données. Dans l'exemple suivant, les options suivantes s'affichent lorsque la série temporelle d'une métrique DELTA :

    Affichez les options de prétraitement pour une métrique cumulative.

    Dans ce cas, si vous sélectionnez l'option Rate (Taux), les valeurs de données sont divisées par le taux d'échantillonnage. Si vous sélectionnez l'option No preprocessing step (Aucune étape de prétraitement), les valeurs des données ne sont pas mises à jour par le taux d'échantillonnage. Par exemple, si la métrique est exprimée en Mio, la sélection de l'option rate a pour effet de modifier les unités en Mio par seconde. Pour obtenir plus d'informations et un exemple, consultez la section Genres, types et conversions.

  3. Sélectionnez les paramètres d'alignement.

    En général, ces champs peuvent être laissés sur les valeurs par défaut. Pour en savoir plus, consultez la section Alignement : régularisation dans la série.

  4. Déterminez si vous souhaitez afficher chaque série temporelle ou regrouper les séries temporelles par valeur de libellé.

    • Pour combiner toutes les séries temporelles en une seule série temporelle, assurez-vous que l'option Group by (Grouper par) est vide et sélectionnez la combinaison de ces séries à l'aide de la fonction Group by function (Grouper par fonction). .

      Vous devez utiliser cette option si vous affichez des séries temporelles sur un graphique de carte de densité. Pour plus d'informations, consultez la section Représentation graphique des métriques de distribution.

    • Pour afficher toutes les séries temporelles, effectuez l'une des opérations suivantes :

      • Assurez-vous que le champ Grouper par est vide et sélectionnez none pour Grouper par fonction.
      • Cliquez sur le menu Grouper par, sélectionnez Tout ajouter, puis sélectionnez l'option Grouper par fonction dans le menu. La fonction de regroupement des métriques stockant une valeur numérique peut ne pas générer un graphique nettement différent.
    • Pour regrouper des séries temporelles par valeur de libellé spécifique, cliquez sur Grouper par, puis sélectionnez les libellés à regrouper. Pour spécifier la manière dont les séries temporelles sont combinées, sélectionnez une fonction dans le menu Group by function (Grouper par fonction).

    Pour obtenir des informations générales sur l'alignement et le regroupement, consultez la section Choisir le mode d'affichage des données.

  5. (Facultatif) Pour configurer l'affichage des données dans un graphique, cliquez sur Paramètres :

    Pour en savoir plus sur les légendes de graphique, consultez la section Configurer des légendes.

MQL

MQL est une langue plus expressive que la langue de filtrage utilisée par les modes Basique et Avancé. Si vous configurez un graphique à l'aide de MQL, puis sélectionnez un autre mode, une boîte de dialogue s'affiche lorsque vous risquez de perdre votre configuration MQL. Cette boîte de dialogue vous permet d'annuler ou de confirmer le changement de mode.

Lorsque vous utilisez MQL pour configurer des graphiques de carte de densité, veillez à configurer les options d'agrégation pour combiner toutes les séries temporelles. Si le graphique de carte de densité affiche Your MQL Query has too many time series, modifiez les paramètres d'agrégation pour combiner toutes les séries temporelles.

Pour plus d'informations sur l'utilisation de MQL, consultez la page Présentation de MQL.

Configurer une jauge ou un tableau de données

Cette section explique comment configurer une jauge ou un tableau de données. Pour en savoir plus sur l'ajout de l'un de ces widgets à votre tableau de bord à l'aide de Google Cloud Console, consultez la section Étapes générales pour ajouter un widget à un tableau de bord. Si vous souhaitez utiliser l'API Cloud Monitoring, consultez la section Tableau de bord avec un widget Scorecard de base.

Basic

Pour configurer une jauge ou un tableau de données à l'aide du mode Basique, procédez comme suit :

  1. Sélectionnez le widget pour activer son volet de configuration.

  2. Sélectionnez les données de séries temporelles que vous souhaitez afficher :

    • Pour modifier le type de ressource et la métrique, sélectionnez une option dans les menus. Le menu Resource type (Type de ressource) répertorie toutes les ressources surveillées pour lesquelles des données de métriques sont disponibles. Le menu Métrique est déterminé par la sélection du Type de ressource.

      • Pour rechercher une entrée spécifique dans un menu, utilisez la barre de défilement ou saisissez du texte dans la zone Filtre du menu. Lorsque vous saisissez du texte, les entrées du menu sont limitées à celles incluant le texte saisi.

      • Si vous souhaitez accéder à un type de ressource ou à une métrique qui ne contient pas encore de données, vous devez modifier le comportement par défaut :

        • Pour sélectionner n'importe quel type de ressource, développez le menu Type de ressource, puis décochez la case Afficher uniquement les éléments actifs.

        • Pour afficher toutes les métriques du type de ressource sélectionné, même celles sans données, développez le menu Métrique, puis décochez la case Afficher uniquement les éléments actifs.

        • Pour sélectionner n'importe quelle métrique, cliquez sur Fermer dans le menu Resource type (Type de ressource), puis recherchez l'entrée qui vous intéresse. s'affiche en haut de l'écran. En cliquant sur "Fermer sur le type de ressource", le menu Métrique inclut toutes les métriques.

        • Pour afficher ou modifier les paramètres de type de ressource et de métrique utilisés par l'API Cloud Monitoring, dans le menu Type de ressource, cliquez sur Mode de filtrage direct.

      Pour plus d'informations sur la sélection de métriques, consultez la page Sélectionner des données à représenter dans le graphique.

    • Pour ajouter un filtre, cliquez sur Ajouter un filtre, puis sélectionnez le libellé et sa valeur. Vous pouvez ajouter plusieurs filtres. Par exemple, vous pouvez afficher les données d'une zone en appliquant un filtre. Pour en savoir plus sur les filtres, consultez la section Filtrer les données représentées graphiquement.

  3. Spécifiez la façon dont les séries temporelles sélectionnées sont combinées en une seule valeur.

    Utilisez les cases d'option pour spécifier la façon dont les données de différentes séries temporelles sont combinées. Pour calculer la moyenne des données, sélectionnez mean.

  4. Configurez les niveaux d'avertissement et de seuil d'une jauge ou d'un tableau de données :

    • Pour les jauge, saisissez les valeurs Minimum et Maximum de la métrique. Lorsque la jauge affiche un pourcentage, définissez ces valeurs sur 0 et 1 respectivement.

    • Pour les tableaux de données, définissez Vue graphique Spark. Toutes les options affichent les données les plus récentes.

      • Ligne : affiche un graphique en courbes.
      • Barre : affiche un graphique à barres.
      • Icône : affiche une icône verte, ambre ou rouge.
      • Valeur : affiche uniquement la valeur.
    • Pour les jauges et les tableaux de données, configurez les seuils d'avertissement et de danger :

      • Danger above (Danger au-dessus) : lorsque la valeur dépasse ce seuil, défini sur rouge.
      • Warning above (Avertissement au-dessus) : lorsque la valeur dépasse ce seuil, défini sur ambre.
      • Danger below (Danger au-dessous) : lorsque la valeur est inférieure à ce seuil, défini sur rouge.
      • Warning below (Avertissement au-dessous) : lorsque la valeur est inférieure à ce seuil, défini sur ambre.

      Par exemple, la capture d'écran suivante illustre une configuration pour une jauge avec les seuils Avertissement ci-dessus et Danger ci-dessus:

      Graphique affichant la configuration des jauges.

      Un exemple de la jauge, lorsque le relevé est inférieur aux seuils d'avertissement et de danger, est présenté ci-dessous :

      Exemple de jauge.

      L'arc extérieur fin affiche la plage de valeurs possibles et indique les zones d'avertissement et de danger. L'arc intérieur épais indique la valeur actuelle.

Avancé

Si vous utilisez le mode Avancé et que vous sélectionnez le mode Basique, des messages d'erreur peuvent s'afficher. Ces paramètres s'affichent lorsque la configuration que vous sélectionnez en mode Avancé ne peut pas être représentée avec les options disponibles en mode Basic.

Pour configurer une jauge ou un tableau de données à l'aide du mode Avancé, procédez comme suit :

  1. Sélectionnez les données de séries temporelles que vous souhaitez afficher :

    • Pour modifier le type de ressource et la métrique, sélectionnez une option dans les menus. Le menu Resource type (Type de ressource) répertorie toutes les ressources surveillées pour lesquelles des données de métriques sont disponibles. Le menu Métrique est déterminé par la sélection du Type de ressource.

      • Pour rechercher une entrée spécifique dans un menu, utilisez la barre de défilement ou saisissez du texte dans la zone Filtre du menu. Lorsque vous saisissez du texte, les entrées du menu sont limitées à celles incluant le texte saisi.

      • Si vous souhaitez accéder à un type de ressource ou à une métrique qui ne contient pas encore de données, vous devez modifier le comportement par défaut :

        • Pour sélectionner n'importe quel type de ressource, développez le menu Type de ressource, puis décochez la case Afficher uniquement les éléments actifs.

        • Pour afficher toutes les métriques du type de ressource sélectionné, même celles sans données, développez le menu Métrique, puis décochez la case Afficher uniquement les éléments actifs.

        • Pour sélectionner n'importe quelle métrique, cliquez sur Fermer dans le menu Resource type (Type de ressource), puis recherchez l'entrée qui vous intéresse. s'affiche en haut de l'écran. En cliquant sur "Fermer sur le type de ressource", le menu Métrique inclut toutes les métriques.

        • Pour afficher ou modifier les paramètres de type de ressource et de métrique utilisés par l'API Cloud Monitoring, dans le menu Type de ressource, cliquez sur Mode de filtrage direct.

      Pour plus d'informations sur la sélection de métriques, consultez la page Sélectionner des données à représenter dans le graphique.

    • Pour ajouter un filtre, cliquez sur Ajouter un filtre, puis sélectionnez le libellé et sa valeur. Vous pouvez ajouter plusieurs filtres. Par exemple, vous pouvez afficher les données d'une zone en appliquant un filtre. Pour en savoir plus sur les filtres, consultez la section Filtrer les données représentées graphiquement.

  2. Sélectionnez les paramètres d'alignement.

    En général, ces champs peuvent être laissés sur les valeurs par défaut. Pour en savoir plus, consultez la section Alignement : régularisation dans la série.

  3. Sélectionnez la fonction group by (grouper par). Cette fonction combine toutes les séries temporelles.

  4. Configurez les niveaux d'avertissement et de seuil d'une jauge ou d'un tableau de données :

    • Pour les jauge, saisissez les valeurs Minimum et Maximum de la métrique. Lorsque la jauge affiche un pourcentage, définissez ces valeurs sur 0 et 1 respectivement.

    • Pour les tableaux de données, définissez Vue graphique Spark. Toutes les options affichent les données les plus récentes.

      • Ligne : affiche un graphique en courbes.
      • Barre : affiche un graphique à barres.
      • Icône : affiche une icône verte, ambre ou rouge.
      • Valeur : affiche uniquement la valeur.
    • Pour les jauges et les tableaux de données, configurez les seuils d'avertissement et de danger :

      • Danger above (Danger au-dessus) : lorsque la valeur dépasse ce seuil, défini sur rouge.
      • Warning above (Avertissement au-dessus) : lorsque la valeur dépasse ce seuil, défini sur ambre.
      • Danger below (Danger au-dessous) : lorsque la valeur est inférieure à ce seuil, défini sur rouge.
      • Warning below (Avertissement au-dessous) : lorsque la valeur est inférieure à ce seuil, défini sur ambre.

      Par exemple, la capture d'écran suivante illustre une configuration pour une jauge avec les seuils Avertissement ci-dessus et Danger ci-dessus:

      Graphique affichant la configuration des jauges.

      Un exemple de la jauge, lorsque le relevé est inférieur aux seuils d'avertissement et de danger, est présenté ci-dessous :

      Exemple de jauge.

      L'arc extérieur fin affiche la plage de valeurs possibles et indique les zones d'avertissement et de danger. L'arc intérieur épais indique la valeur actuelle.

MQL

MQL est une langue plus expressive que la langue de filtrage utilisée par les modes Basique et Avancé. Si vous configurez un graphique à l'aide de MQL, puis sélectionnez un autre mode, une boîte de dialogue s'affiche lorsque vous risquez de perdre votre configuration MQL. Cette boîte de dialogue vous permet d'annuler ou de confirmer le changement de mode. Pour plus d'informations, consultez la page Présentation du langage MQL (Monitoring Query Language).

Lorsque vous utilisez MQL pour configurer des jauges et des tableaux de données, veillez à configurer les options d'agrégation pour combiner toutes les séries temporelles. Si le widget affiche Your MQL Query has too many time series, modifiez les paramètres d'agrégation pour combiner toutes les séries temporelles.

Prenons par exemple la requête d'utilisation du processeur d'une instance de VM. Cette requête regroupe les données par zone, puis calcule la moyenne des données dans chaque zone.

fetch gce_instance
 | metric 'compute.googleapis.com/instance/cpu/utilization'
 | group_by [zone], mean(val())

Lorsque toutes vos instances de VM se trouvent dans la même zone, une jauge ou un tableau de données peut afficher les données demandées. Toutefois, si vos instances de VM se trouvent dans plusieurs zones, ces widgets affichent le message d'erreur Your MQL Query has too many time series.

Pour résoudre cette erreur, assurez-vous que la dernière clause group_by combine toutes les séries temporelles :

fetch gce_instance
 | metric 'compute.googleapis.com/instance/cpu/utilization'
 | group_by [zone], mean(val())
 | every 1m
 | group_by [], max(val())

Dans la dernière clause group_by, le premier argument, [], spécifie que toutes les séries temporelles doivent être combinées et le second argument, max(val()), définit la façon dont les séries temporelles doivent être combinées. Une fois l'opération de regroupement terminée, il existe une série temporelle.

Configurer une zone de texte

Cette section explique comment configurer une zone de texte. Pour savoir comment ajouter une zone de texte à votre tableau de bord à l'aide de Google Cloud Console, consultez la section Étapes générales pour ajouter un widget à un tableau de bord. Si vous souhaitez utiliser l'API Cloud Monitoring, consultez la section Tableau de bord avec un widget Text.

Le widget de zone de texte n'est compatible qu'avec un ensemble limité de commandes Markdown :

  • Pour créer un en-tête, utilisez #. Vous pouvez utiliser plusieurs signes de hachage pour différents niveaux d'en-têtes :

      # Header
      ## Second heading
      ### Third heading
    
  • Pour afficher une police en italiques, utilisez *italic* ou _italic_.

  • Pour afficher une police en gras, utilisez **bold** ou __bold__.

  • Pour ajouter un lien, utilisez [link text](absolute URL). Vous pouvez utiliser n'importe quelle valeur pour link text, mais vous devez utiliser l'URL absolue.

    Par exemple, vous pouvez écrire [cloud.google.com](https://cloud.google.com/) pour créer un lien vers cloud.google.com.

Configurer un graphique d'alerte

Pour configurer un graphique d'alerte, vous devez l'associer à une règle d'alerte à condition unique. Pour savoir comment ajouter un graphique d'alerte à votre tableau de bord à l'aide de Google Cloud Console, consultez la section Procédure générale pour ajouter un widget à un tableau de bord. Si vous souhaitez utiliser l'API Cloud Monitoring, consultez la section Tableau de bord avec un widget AlertChart.

Pour associer un graphique d'alerte à une règle d'alerte, dans le panneau de configuration du widget Alert chart (Graphique d'alerte), vous devez sélectionner une alerte à l'aide du menu Alert policy (Règle d'alerte). . Si aucune règle d'alerte ne peut être sélectionnée dans le menu, elle ne peut pas être représentée par un graphique d'alerte.

Après avoir sélectionné une règle d'alerte, des données de séries temporelles, un seuil et des puces indiquant le nombre d'incidents ouverts et si la règle est désactivée. La capture d'écran suivante illustre un graphique d'alerte:

Exemple de graphique d'alerte

La capture d'écran précédente illustre un graphique d'alerte pour une règle d'alerte permettant de surveiller l'utilisation du processeur de deux machines virtuelles différentes. Le seuil de condition, qui est défini sur 50%, est représenté par la ligne rouge en pointillé. La puce verte avec le libellé No incidents indique qu'aucun incident n'est ouvert pour la règle d'alerte.

Pour obtenir des informations sur la règle d'alerte affichée par un graphique d'alerte, effectuez l'une des opérations suivantes:

  • Placez le pointeur sur une entrée du menu Alert policy (Règles d'alerte) pour activer une info-bulle affichant les détails de l'alerte.
  • Cliquez sur la puce d'incident et sélectionnez Afficher la règle d'alerte pour accéder à la page de détails de la règle d'alerte.

Pour afficher les détails de la configuration du graphique d'alerte, cliquez sur Plus d'options et sélectionnez Afficher dans l'explorateur de métriques. Dans l'explorateur de métriques, un graphique en courbes contenant la même métrique et la même configuration de filtre que le graphique d'alerte s'affiche. Si vous modifiez le graphique affiché dans l'explorateur de métriques, vous ne pouvez pas appliquer ces modifications à la règle d'alerte ni au graphique d'alerte affiché sur un tableau de bord.

Si vous utilisez l'API Cloud Monitoring et que vous souhaitez représenter la représentation JSON d'un graphique d'alerte afin de pouvoir l'ajouter à un autre tableau de bord personnalisé à l'aide de l'API, cliquez sur JSON Editor dans la barre d'outils du tableau de bord.

Changer un type de widget

Pour modifier le type d'un widget, procédez comme suit:

  1. Assurez-vous que le bouton Editing (Modifier) s'affiche. Si la fenêtre n'apparaît pas, cliquez sur le menu Affichage et sélectionnez Passer en mode Édition.
  2. Sélectionnez le widget.
  3. Dans le volet de configuration, sélectionnez le type de widget actuel. Par exemple, si vous consultez un graphique en courbes, dans le volet de configuration, sélectionnez Graphique en courbes.

  4. Sélectionnez le nouveau type de widget dans le menu.

    Le menu des options répertorie tous les types de widgets pouvant représenter des données de métriques. Toutefois, un type de widget est désactivé s'il ne peut pas afficher les données sélectionnées. Par exemple, si la métrique sélectionnée ne présente pas de valeur de distribution, l'option de carte de densité est désactivée. De même, si le widget actuel affiche plusieurs séries temporelles, les options de jauge et de tableau de données sont désactivées.

Si un type de widget est désactivé dans le menu, vous pouvez éventuellement changer de type de widget après avoir modifié la configuration du widget en cours. Par exemple, si vous avez un graphique en courbes avec des séries temporelles regroupées par zone, pour afficher ces données avec une jauge, vous devez supprimer le libellé de regroupement et sélectionner une fonction de regroupement avant de modifier le type de widget.

Changer un widget de tableau de bord

Pour modifier un widget, procédez comme suit :

  1. Assurez-vous que le bouton Editing (Modifier) s'affiche. Si la fenêtre n'apparaît pas, cliquez sur le menu Affichage et sélectionnez Passer en mode Édition.

  2. Sélectionnez le widget pour activer le volet de configuration du widget.

  3. (Facultatif) Si vous souhaitez modifier le widget à l'aide de l'éditeur JSON, cliquez sur Éditeur JSON pour l'ouvrir.

  4. Modifiez le widget à l'aide du volet de configuration du widget ou de l'éditeur JSON:

    • Si vous utilisez le volet de configuration, vos modifications sont enregistrées automatiquement, sauf si vous désactivez l'enregistrement automatique. Si vous modifiez un graphique, consultez la page Définir les options d'affichage pour savoir comment configurer l'apparence d'un graphique.
    • Si vous utilisez l'éditeur JSON, vous devez cliquer sur Appliquer les modifications pour enregistrer vos modifications. Par défaut, seule la section du graphique au format JSON est développée. Pour afficher la définition complète du tableau de bord, cliquez sur Afficher plus:

      Illustration du bouton d'expansion dans l'éditeur JSON.

Supprimer un widget de tableau de bord

Pour supprimer un widget, procédez comme suit :

  1. Assurez-vous que le bouton Editing (Modifier) s'affiche. Si la fenêtre n'apparaît pas, cliquez sur le menu Affichage et sélectionnez Passer en mode Édition.
  2. Sélectionnez le widget que vous souhaitez supprimer.
  3. Dans la barre d'outils du graphique, sélectionnez Supprimer.

Étape suivante