Ajouter des widgets de tableau de bord

Ce document explique comment ajouter des widgets à un tableau de bord personnalisé à l'aide de Google Cloud Console. Les tableaux de bord personnalisés peuvent afficher les données de métriques, les règles d'alerte, le texte descriptif et les entrées de journal. Ces tableaux de bord peuvent également afficher des objectifs de niveau de service (SLO) pour un ensemble de services.

En général, les widgets de tableau de bord 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.

Lorsque vous ajoutez des widgets qui affichent des données de métriques, vous pouvez afficher ces données sur un intervalle de temps ou n'afficher que les données les plus récentes. Par exemple, pour afficher une métrique sur un intervalle de temps, ajoutez un graphique en courbes, un graphique en aires, un graphique à barres ou une carte de densité. Pour afficher uniquement les données les plus récentes, ajoutez une table ou un indicateur. Les indicateurs changent de couleur en fonction des données, par rapport aux seuils d'avertissement et de danger. Pour obtenir des informations générales sur les différents types de widgets, consultez la page Tableaux de bord et graphiques.

Vous pouvez placer jusqu'à 40 widgets sur un tableau de bord et les organiser en groupes nommés.

Pour plus d'informations sur l'API Cloud Monitoring, consultez la page Gérer des tableaux de bord à l'aide d'API.

Avant de commencer

Avant de créer ou de modifier un tableau de bord, assurez-vous de disposer de l'un des rôles Identity and Access Management suivants:

  • roles/monitoring.dashboardEditor
  • roles/monitoring.editor
  • roles/monitoring.admin
  • roles/owner

Pour en savoir plus sur les rôles, consultez la page Contrôle des accès.

Ajouter des graphiques et des tableaux à un tableau de bord

Cette section explique comment configurer des graphiques et des tableaux à l'aide de la console:

  • Les graphiques affichent les données au fil du temps. Quatre styles sont disponibles : Courbes, Empilé, Barres empilées et Carte de densité. Une fois qu'un graphique est configuré, vous pouvez modifier son type de widget. Pour savoir pourquoi vous pouvez sélectionner un style spécifique, consultez Graphiques montrant l'évolution des données au fil du temps.

    Pour savoir comment configurer un graphique à l'aide de l'API Cloud Monitoring, consultez la section Tableau de bord avec un widget XyChart.

  • Les tables contiennent une ligne pour chaque série temporelle surveillée et n'affichent que la valeur la plus récente. Il existe deux styles de tableau. Le widget Tableau affiche une valeur numérique telle que "25%". Le widget Top List affiche à la fois la valeur et un indicateur visuel de la valeur par rapport à la plage de valeurs possibles. Vous pouvez passer d'un type de widget à un autre.

    Pour en savoir plus sur l'utilisation de l'API Cloud Monitoring pour configurer une table, consultez Tableau de bord avec un widget TimeSeriesTable.

Pour ajouter un graphique ou un tableau à un tableau de bord, procédez comme suit:

  1. Dans la console, sélectionnez Monitoring ou cliquez sur le bouton suivant:
    Accéder à Monitoring
  2. Dans le volet de navigation, sélectionnez Tableaux de bord, puis choisissez le tableau de bord que vous souhaitez afficher ou modifier.
  3. Si le bouton Modifier le tableau de bord s'affiche, cliquez dessus.
  4. Sélectionnez un widget de graphique ou de tableau dans la bibliothèque de graphiques, ou faites glisser l'un de ces widgets de la bibliothèque vers la zone du graphique.

  5. Spécifiez les données affichées par le widget:

    • Pour configurer rapidement le widget, utilisez le mode Basique. Ce mode fournit des options de configuration minimales. Vous pouvez toujours passer d'une configuration de base à un autre mode de configuration.
    • Pour accéder à tous les champs configurables ou saisir un filtre Monitoring, utilisez le mode Avancé. Vous ne pourrez peut-être pas passer à un autre mode de configuration.
    • Pour utiliser le langage MQL (Monitoring Query Language), sélectionnez l'onglet MQL. Lorsque vous utilisez MQL, vous ne pouvez pas changer de mode de configuration et conserver votre requête.

    Le tableau suivant décrit les options disponibles pour chaque mode:

Basic

Pour configurer le widget, procédez comme suit:

  1. Sélectionnez les données de séries temporelles à afficher.
  2. (Facultatif) Grouper une série temporelle.
  3. (Facultatif) Configurez les options d'affichage du graphique.
  4. (Facultatif) Représenter plusieurs types de métriques sous forme de graphique.

Sélectionnez les données de séries temporelles à afficher

Pour sélectionner la série temporelle à représenter, effectuez l'une des opérations suivantes:

  • Pour afficher un type de métrique, tel que l'utilisation du processeur d'une VM, utilisez les menus pour faire vos sélections:

    1. Cliquez sur Sélectionner une métrique, puis utilisez les menus pour sélectionner un type de ressource et un type de métrique.

      Pour réduire le nombre d'options de menu, saisissez le nom d'une ressource ou un type de métrique dans la barre de filtre . Par exemple, pour représenter l'utilisation du processeur par une instance de VM, saisissez utilization dans la barre de filtre.

      Pour répertorier tous les types de ressources et de métriques, désactivez l'option Afficher uniquement les ressources actives et les métriques. Par défaut, ce bouton est activé. Seules les métriques et les ressources contenant des données sont donc affichées dans les menus.

    2. (Facultatif) Pour spécifier un sous-ensemble de données à afficher, ajoutez un filtre ou appliquez des variables de modèle. Par exemple, vous pouvez afficher les données d'une zone en appliquant un filtre. Vous pouvez ajouter plusieurs filtres. Pour en savoir plus sur les filtres, consultez la page Filtrer les données représentées graphiquement. Pour en savoir plus sur les variables de modèle, consultez Filtrer un tableau de bord.

      Pour ajouter un filtre, cliquez sur Ajouter un filtre, puis sélectionnez le libellé et la valeur du libellé. Par exemple, pour n'afficher que les séries temporelles pour la zone us-east1-b, saisissez le filtre zone = us-east1-b.

      Pour appliquer une variable de modèle, utilisez le menu.

  • Pour afficher un objectif de niveau de service ou le nombre de processus exécutés sur des VM, saisissez un filtre Monitoring:

    1. Cliquez sur Aide dans le menu Sélectionner une métrique.
    2. Sélectionnez Mode de filtrage direct.
    3. Saisissez le filtre Monitoring dans la zone de texte.

Pour en savoir plus sur ces choix, consultez Sélectionner des métriques pour les graphiques dans les tableaux de bord.

Groupe de séries temporelles

  1. 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 Affichage groupé, puis utilisez le menu Grouper par pour sélectionner les libellés à regrouper. Après avoir effectué les sélections, cliquez sur OK.

    Cette option n'est pas disponible pour les graphiques de cartes de densité, car ces graphiques ne peuvent afficher qu'une seule série temporelle.

  2. Pour spécifier comment combiner des points de données dans une série temporelle, utilisez les cases d'option.

    Par exemple, si un graphique peut afficher 60 points de données et que les 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 la valeur de ce sélecteur est mean, chaque point du graphique correspond à la moyenne de trois points de la série temporelle d'origine.

Configurer les options d'affichage du graphique

Ces champs ne sont pas disponibles pour les tables.

(Facultatif) Représenter plusieurs types de métriques sous forme de graphique

Cette option n'est pas disponible pour les tables.

Pour afficher un autre type de métrique sur votre graphique, cliquez sur Ajouter une métrique, puis répétez les étapes précédentes. Un graphique peut afficher jusqu'à 10 types de métriques.

La première fois que vous cliquez sur Ajouter une autre métrique, les sélections que vous avez précédemment effectuées s'affichent dans le volet Série temporelle A. De plus, le volet Série temporelle B s'ouvre. Ce volet contient les champs de configuration que vous remplissez pour représenter graphiquement le deuxième type de métrique.

La capture d'écran suivante illustre ce comportement:

Exemple de configuration de l'explorateur de métriques avec deux métriques

Avancé

Pour configurer le widget, procédez comme suit:

  1. Sélectionnez les données de séries temporelles à afficher.
  2. Sélectionnez la méthode de prétraitement des séries temporelles.
  3. (Facultatif) Grouper une série temporelle.
  4. (Facultatif) Configurez les options d'affichage du graphique.
  5. (Facultatif) Représenter plusieurs types de métriques sous forme de graphique.
  6. (Facultatif) Afficher un ratio entre les types de métriques

Sélectionnez les données de séries temporelles à afficher

Pour sélectionner la série temporelle à représenter, effectuez l'une des opérations suivantes:

  • Pour afficher un type de métrique, tel que l'utilisation du processeur d'une VM, utilisez les menus pour faire vos sélections:

    1. Cliquez sur Sélectionner une métrique, puis utilisez les menus pour sélectionner un type de ressource et un type de métrique.

      Pour réduire le nombre d'options de menu, saisissez le nom d'une ressource ou un type de métrique dans la barre de filtre . Par exemple, pour représenter l'utilisation du processeur par une instance de VM, saisissez utilization dans la barre de filtre.

      Pour répertorier tous les types de ressources et de métriques, désactivez l'option Afficher uniquement les ressources actives et les métriques. Par défaut, ce bouton est activé. Seules les métriques et les ressources contenant des données sont donc affichées dans les menus.

    2. (Facultatif) Pour spécifier un sous-ensemble de données à afficher, ajoutez un filtre ou appliquez des variables de modèle. Par exemple, vous pouvez afficher les données d'une zone en appliquant un filtre. Vous pouvez ajouter plusieurs filtres. Pour en savoir plus sur les filtres, consultez la page Filtrer les données représentées graphiquement. Pour en savoir plus sur les variables de modèle, consultez Filtrer un tableau de bord.

      Pour ajouter un filtre, cliquez sur Ajouter un filtre, puis sélectionnez le libellé et la valeur du libellé. Par exemple, pour n'afficher que les séries temporelles pour la zone us-east1-b, saisissez le filtre zone = us-east1-b.

      Pour appliquer une variable de modèle, utilisez le menu.

  • Pour afficher un objectif de niveau de service ou le nombre de processus exécutés sur des VM, saisissez un filtre Monitoring:

    1. Cliquez sur Aide dans le menu Sélectionner une métrique.
    2. Sélectionnez Mode de filtrage direct.
    3. Saisissez le filtre Monitoring dans la zone de texte.

Pour en savoir plus sur ces choix, consultez Sélectionner des métriques pour les graphiques dans les tableaux de bord.

Sélectionnez le mode de prétraitement de la série temporelle

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

Les options de prétraitement s'affichent lorsque la métrique sélectionnée est de type delta ou cumulatif. Le type de valeur de la métrique détermine les options spécifiques disponibles.

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. L'exemple suivant montre les options lorsque les séries temporelles d'une métrique DELTA sont sélectionnées :

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

Pour les métriques DELTA, lorsque Rate est sélectionné, les valeurs des données sont divisées par le taux d'échantillonnage. Lorsque No preprocessing step est sélectionné, le taux d'échantillonnage ne met pas les valeurs de données à l'échelle. Par exemple, lorsque les unités de la métrique sont en Mio, la sélection de rate change les unités en Mio par seconde. Pour en savoir plus et obtenir un exemple, consultez la page Genres, types et conversions.

Groupe de séries temporelles

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

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

    • Pour combiner les séries temporelles en une seule, assurez-vous que le champ Grouper par est vide, puis sélectionnez la manière dont les séries temporelles sont combinées à l'aide du menu Fonction de regroupement.

      Lorsque vous affichez des séries temporelles sur une carte de densité, vous devez combiner les séries temporelles à l'aide de cette approche. Les cartes de densité ne peuvent afficher qu'une seule série temporelle. Pour en savoir plus, consultez la page 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, puis sélectionnez none dans le menu Fonction de regroupement.
      • Développez le menu Grouper par, sélectionnez Tout ajouter, puis sélectionnez une option dans le menu Fonction de regroupement.
    • 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 à l'aide du menu Group by function (Fonction de regroupement).

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

Configurer les options d'affichage du graphique

Ces champs ne sont pas disponibles pour les tables.

(Facultatif) Représenter plusieurs types de métriques sous forme de graphique

Cette option n'est pas disponible pour les tables.

Pour afficher un autre type de métrique sur votre graphique, cliquez sur Ajouter une métrique, puis répétez les étapes précédentes. Un graphique peut afficher jusqu'à 10 types de métriques.

La première fois que vous cliquez sur Ajouter une autre métrique, les sélections que vous avez précédemment effectuées s'affichent dans le volet Série temporelle A. De plus, le volet Série temporelle B s'ouvre. Ce volet contient les champs de configuration que vous remplissez pour représenter graphiquement le deuxième type de métrique.

La capture d'écran suivante illustre ce comportement:

Exemple de configuration de l'explorateur de métriques avec deux métriques

(Facultatif) Représenter un graphique selon un type de métriques

Cette option n'est pas disponible pour les tables.

Si, par exemple, vous souhaitez connaître le taux d'erreurs plutôt que le nombre absolu d'erreurs, vous devez représenter un ratio de types de métriques dans un graphique. Un graphique qui affiche un ratio de types de métriques peut indiquer des anomalies en raison des différences d'échantillonnage et d'alignement. Pour obtenir des références et des exemples, consultez la section Ratios de métriques.

Les étapes suivantes supposent que vous avez terminé les étapes de représentation graphique d'un type de métrique. Dans les étapes suivantes, vous sélectionnez un deuxième type de métrique, puis convertissez le graphique pour afficher un ratio:

  1. Sélectionnez Ajouter une métrique.

    Lorsque vous cliquez sur Ajouter une métrique, les sélections que vous avez précédemment effectuées s'affichent dans le volet Série temporelle A. De plus, le volet Série temporelle B s'ouvre.

  2. Sélectionnez le type de métrique Série temporelle B.

    Les deux types de métriques doivent être du même genre. Par exemple, si Time Series-A est une métrique GAUGE, sélectionnez un type de métrique avec un genre de métrique GAUGE.

  3. Assurez-vous que la valeur du champ Durée minimale de l'alignement est identique pour les deux types de métriques.

  4. Définissez les paramètres de regroupement pour le deuxième type de métrique.

    Nous recommandons que les champs de regroupement du deuxième type de métrique correspondent aux valeurs de Time Series-A. Par exemple, vous pouvez regrouper les deux types de métriques selon le libellé zone.

    Vous n'êtes pas obligé d'utiliser le même regroupement pour le numérateur et le dénominateur. Toutefois, vous ne pouvez regrouper que les libellés communs aux deux champs.

  5. Activez Afficher les métriques sous forme de ratio.

    Lorsque vous effectuez cette sélection, le libellé Time Series-A est renommé Numerator et le libellé Time Series-B est renommé Denominator.

  6. (Facultatif) Pour modifier le type de métrique, cliquez sur Intervertir le numérateur.

  7. (Facultatif) Développez Afficher les options de ratio pour configurer les options d'agrégation secondaire.

MQL

Pour ajouter un graphique ou un tableau à un tableau de bord à l'aide du mode MQL, saisissez une requête MQL.

Par exemple, la requête suivante affiche l'utilisation moyenne du processeur par une instance de machine virtuelle (VM) Compute Engine:

fetch gce_instance
| metric 'compute.googleapis.com/instance/cpu/utilization'
| group_by 1m, [value_utilization_mean: mean(value.utilization)]
| every 1m

Lorsque vous sélectionnez un widget de carte de densité, assurez-vous que les options d'agrégation combinent la série temporelle en une seule série temporelle. Si un graphique de carte de densité affiche Your MQL Query has too many time series, modifiez les paramètres d'agrégation pour combiner la série temporelle.

Pour en savoir plus sur le calcul des ratios avec MQL, consultez la section Calculer des ratios.

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

Pour en savoir plus sur l'ajout de filtres de modèle lorsque vous utilisez MQL, consultez la section Filtres de tableau de bord.

Ajouter des indicateurs à un tableau de bord

Pour comparer la mesure la plus récente à un ensemble de seuils avec un code couleur, ajoutez une jauge ou un tableau de données. Les jauges n'affichent que les mesures les plus récentes, tandis que les tableaux de données affichent l'historique des mesures récentes. La couleur d'arrière-plan de ces widgets est également codée par couleur. Lorsque la valeur la plus récente se situe dans les plages attendues, la couleur du widget est blanche. Lorsque la valeur se trouve dans une plage d'avertissement, le widget devient orange. De même, lorsque la valeur se trouve dans une plage de danger, le widget devient rouge.

Les deux widgets affichent une seule série temporelle. La capture d'écran suivante montre un exemple de jauge lorsque la mesure la plus récente est inférieure aux seuils d'avertissement et de danger:

Exemple de jauge.

Le reste des informations de cette section concerne la console. Pour en savoir plus sur l'utilisation de l'API Cloud Monitoring, consultez la section Tableau de bord avec une configuration de base Scorecard.

Pour ajouter une jauge ou un tableau de données à un tableau de bord:

  1. Dans la console, sélectionnez Monitoring ou cliquez sur le bouton suivant :
    Accéder à Monitoring
  2. Dans le volet de navigation, sélectionnez Tableaux de bord, puis choisissez le tableau de bord que vous souhaitez afficher ou modifier.
  3. Si le bouton Modifier le tableau de bord s'affiche, cliquez dessus.
  4. Sélectionnez un widget jauge ou tableau de données dans la bibliothèque de graphiques, ou faites glisser l'un de ces widgets de la bibliothèque vers la zone du graphique.
  5. Spécifiez les données affichées par le widget :
    • Pour configurer rapidement le widget, utilisez le mode Basique. Ce mode fournit des options de configuration minimales. Vous pouvez toujours passer d'une configuration de base à un autre mode de configuration.
    • Pour accéder à tous les champs configurables ou saisir un filtre Monitoring, utilisez le mode Avancé. Vous ne pourrez peut-être pas passer à un autre mode de configuration.
    • Pour utiliser le langage MQL (Monitoring Query Language), sélectionnez l'onglet MQL. Lorsque vous utilisez MQL, vous ne pouvez pas changer de mode de configuration et conserver votre requête.

    Le tableau suivant décrit les options disponibles pour chaque mode:

Basic

Pour configurer le widget, procédez comme suit:

  1. Sélectionnez les données de séries temporelles à afficher.
  2. Combinez la série temporelle en une seule série temporelle.
  3. Configurez les niveaux d'avertissement et de seuil.

Sélectionnez les données de séries temporelles à afficher

Pour sélectionner la série temporelle à représenter, effectuez l'une des opérations suivantes:

  • Pour afficher un type de métrique, tel que l'utilisation du processeur d'une VM, utilisez les menus pour faire vos sélections:

    1. Cliquez sur Sélectionner une métrique, puis utilisez les menus pour sélectionner un type de ressource et un type de métrique.

      Pour réduire le nombre d'options de menu, saisissez le nom d'une ressource ou un type de métrique dans la barre de filtre . Par exemple, pour représenter l'utilisation du processeur par une instance de VM, saisissez utilization dans la barre de filtre.

      Pour répertorier tous les types de ressources et de métriques, désactivez l'option Afficher uniquement les ressources actives et les métriques. Par défaut, ce bouton est activé. Seules les métriques et les ressources contenant des données sont donc affichées dans les menus.

    2. (Facultatif) Pour spécifier un sous-ensemble de données à afficher, ajoutez un filtre ou appliquez des variables de modèle. Par exemple, vous pouvez afficher les données d'une zone en appliquant un filtre. Vous pouvez ajouter plusieurs filtres. Pour en savoir plus sur les filtres, consultez la page Filtrer les données représentées graphiquement. Pour en savoir plus sur les variables de modèle, consultez Filtrer un tableau de bord.

      Pour ajouter un filtre, cliquez sur Ajouter un filtre, puis sélectionnez le libellé et la valeur du libellé. Par exemple, pour n'afficher que les séries temporelles pour la zone us-east1-b, saisissez le filtre zone = us-east1-b.

      Pour appliquer une variable de modèle, utilisez le menu.

  • Pour afficher un objectif de niveau de service ou le nombre de processus exécutés sur des VM, saisissez un filtre Monitoring:

    1. Cliquez sur Aide dans le menu Sélectionner une métrique.
    2. Sélectionnez Mode de filtrage direct.
    3. Saisissez le filtre Monitoring dans la zone de texte.

Pour en savoir plus sur ces choix, consultez Sélectionner des métriques pour les graphiques dans les tableaux de bord.

Combiner la série temporelle en une seule série temporelle

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

Configurer les niveaux d'avertissement et de seuil

Effectuez l'une des opérations suivantes :

  • Pour les jauges, procédez comme suit:

    1. Saisissez les valeurs Minimum et Maximum pour la métrique. Lorsque la jauge affiche un pourcentage, définissez ces valeurs sur 0 et 1 respectivement.
    2. Configurez les seuils d'avertissement et de danger.

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

      Graphique affichant la configuration des jauges.

  • Pour les tableaux de données:

    1. Définissez la vue du graphique Spark. La vue détermine la manière dont les données passées sont affichées. Par exemple, si vous sélectionnez Ligne, une ligne s'affiche.
    2. Configurez les seuils d'avertissement et de danger.

Avancé

Pour configurer le widget, procédez comme suit:

  1. Sélectionnez les données de séries temporelles à afficher.
  2. Combinez la série temporelle en une seule série temporelle.
  3. Configurez les niveaux d'avertissement et de seuil.

Sélectionnez les données de séries temporelles à afficher

Pour sélectionner la série temporelle à représenter, effectuez l'une des opérations suivantes:

  • Pour afficher un type de métrique, tel que l'utilisation du processeur d'une VM, utilisez les menus pour faire vos sélections:

    1. Cliquez sur Sélectionner une métrique, puis utilisez les menus pour sélectionner un type de ressource et un type de métrique.

      Pour réduire le nombre d'options de menu, saisissez le nom d'une ressource ou un type de métrique dans la barre de filtre . Par exemple, pour représenter l'utilisation du processeur par une instance de VM, saisissez utilization dans la barre de filtre.

      Pour répertorier tous les types de ressources et de métriques, désactivez l'option Afficher uniquement les ressources actives et les métriques. Par défaut, ce bouton est activé. Seules les métriques et les ressources contenant des données sont donc affichées dans les menus.

    2. (Facultatif) Pour spécifier un sous-ensemble de données à afficher, ajoutez un filtre ou appliquez des variables de modèle. Par exemple, vous pouvez afficher les données d'une zone en appliquant un filtre. Vous pouvez ajouter plusieurs filtres. Pour en savoir plus sur les filtres, consultez la page Filtrer les données représentées graphiquement. Pour en savoir plus sur les variables de modèle, consultez Filtrer un tableau de bord.

      Pour ajouter un filtre, cliquez sur Ajouter un filtre, puis sélectionnez le libellé et la valeur du libellé. Par exemple, pour n'afficher que les séries temporelles pour la zone us-east1-b, saisissez le filtre zone = us-east1-b.

      Pour appliquer une variable de modèle, utilisez le menu.

  • Pour afficher un objectif de niveau de service ou le nombre de processus exécutés sur des VM, saisissez un filtre Monitoring:

    1. Cliquez sur Aide dans le menu Sélectionner une métrique.
    2. Sélectionnez Mode de filtrage direct.
    3. Saisissez le filtre Monitoring dans la zone de texte.

Pour en savoir plus sur ces choix, consultez Sélectionner des métriques pour les graphiques dans les tableaux de bord.

Combiner la série temporelle en une seule série temporelle

  1. Sélectionnez les paramètres d'alignement. En général, il est possible de conserver les valeurs d'alignement par défaut. Pour en savoir plus, consultez la section Alignement : régularisation dans la série.

  2. Sélectionnez la fonction Grouper par. Cette fonction combine les séries temporelles.

Configurer les niveaux d'avertissement et de seuil

Effectuez l'une des opérations suivantes :

  • Pour les jauges, procédez comme suit:

    1. Saisissez les valeurs Minimum et Maximum pour la métrique. Lorsque la jauge affiche un pourcentage, définissez ces valeurs sur 0 et 1 respectivement.
    2. Configurez les seuils d'avertissement et de danger.

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

      Graphique affichant la configuration des jauges.

  • Pour les tableaux de données:

    1. Définissez la vue du graphique Spark. La vue détermine la manière dont les données passées sont affichées. Par exemple, si vous sélectionnez Ligne, une ligne s'affiche.
    2. Configurez les seuils d'avertissement et de danger.

MQL

Pour configurer le widget, saisissez une requête MQL qui combine la série temporelle en une seule série temporelle.

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, lorsque 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 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 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 seule série temporelle.

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

Afficher les données sous forme de tableau sur un tableau de bord

Pour afficher les données les plus récentes sous forme de tableau, ajoutez une table. Les tables peuvent afficher n'importe quel type de métrique ayant une valeur numérique. Elles peuvent également afficher les centiles des métriques dont la valeur est distribuée.

Les tableaux n'affichent que la valeur la plus récente, semblable au comportement des jauges et des tableaux de données. Toutefois, contrairement aux jauges et aux tableaux de données, les tableaux contiennent une ligne pour chaque série temporelle surveillée.

Il existe deux styles de tableau. Le widget Tableau affiche une valeur numérique telle que "25%". Le widget Top List affiche à la fois la valeur et un indicateur visuel de la valeur par rapport à la plage de valeurs possibles. Vous pouvez passer d'un type de widget à un autre.

La capture d'écran suivante illustre un tableau de bord qui montre l'utilisation du processeur par des instances de machine virtuelle à l'aide d'un widget Top List et d'un widget Table:

Exemple de widget Tableau.

Pour savoir comment ajouter des tables à un tableau de bord, consultez les documents suivants:

Trier et filtrer les tables

Vous pouvez modifier l'ordre des lignes dans l'affichage du tableau et filtrer le contenu de la table pour n'afficher que des lignes spécifiques. Ces paramètres ne sont pas persistants. Lorsque vous quittez la page ou lorsque vous actualisez le tableau de bord, les options de tri et de filtrage que vous avez appliquées sont supprimées.

Vous disposez des options de tri et de filtrage suivantes:

  • Pour trier le tableau en fonction d'une colonne, cliquez sur l'en-tête de la colonne.

  • Pour modifier les colonnes de la table, cliquez sur Afficher les colonnes, apportez vos modifications, puis cliquez sur OK.

  • Pour ne répertorier que des lignes spécifiques, ajoutez un ou plusieurs filtres. Vous pouvez ajouter plusieurs filtres. Lorsque vous ne spécifiez pas l'opérateur OR entre deux filtres, une relation logique AND associe ces filtres.

    Pour ajouter un filtre, cliquez sur Enter property name or value, sélectionnez une propriété dans le menu, puis saisissez une valeur ou sélectionnez-en une dans le menu des valeurs. Par exemple, si vous filtrez sur la propriété Name et saisissez la valeur demo, le tableau ne répertorie que les lignes dans lesquelles le champ Name inclut la valeur demo.

Ajouter du texte à un tableau de bord

Pour ajouter des informations utiles à un tableau de bord, ajoutez une zone de texte. Le contenu d'une zone de texte peut être des informations sur le tableau de bord, des liens vers des ressources pertinentes ou la marche à suivre dans différentes situations. Le contenu des widgets de texte est persistant. La capture d'écran suivante illustre une zone de texte:

Exemple de tableau de bord avec un widget Text.

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

Pour ajouter une zone de texte:

  1. Dans la console, sélectionnez Monitoring ou cliquez sur le bouton suivant :
    Accéder à Monitoring
  2. Dans le volet de navigation, sélectionnez Tableaux de bord, puis choisissez le tableau de bord que vous souhaitez afficher ou modifier.
  3. Si le bouton Modifier le tableau de bord s'affiche, cliquez dessus.
  4. Sélectionnez le widget de zone de texte dans la bibliothèque de graphiques ou faites-le glisser depuis la bibliothèque vers la zone du graphique.
  5. Saisissez le texte à afficher. 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.

Afficher les règles d'alerte sur un tableau de bord

Pour afficher le graphique associé à une règle d'alerte dans le même contexte que vos données de métriques, ajoutez un graphique d'alerte à votre tableau de bord. Les graphiques d'alerte affichent la série temporelle que la règle surveille, un seuil, le nombre d'incidents associés à la règle et si celle-ci est désactivée. La capture d'écran suivante illustre un graphique d'alerte:

Exemple de graphique d'alerte

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

Pour ajouter un graphique d'alerte à un tableau de bord, procédez comme suit:

  1. Dans la console, sélectionnez Monitoring ou cliquez sur le bouton suivant:
    Accéder à Monitoring
  2. Dans le volet de navigation, sélectionnez Tableaux de bord, puis choisissez le tableau de bord que vous souhaitez afficher ou modifier.
  3. Si le bouton Modifier le tableau de bord s'affiche, cliquez dessus.
  4. Sélectionnez le widget de graphique d'alerte dans la bibliothèque de graphiques ou faites-le glisser depuis la bibliothèque vers la zone du graphique.
  5. Sélectionnez une règle d'alerte existante à l'aide du menu Règle d'alerte.

Afficher les règles d'alerte

Lorsque vous consultez un graphique d'alerte, vous pouvez obtenir plus d'informations sur la règle d'alerte qu'il affiche. Par exemple, vous pouvez examiner les canaux de notification sélectionnés ou la documentation personnalisée incluse dans une notification. Pour obtenir des informations sur la règle d'alerte, procédez comme suit:

  • Pour afficher les détails de la règle d'alerte, cliquez sur le chip des incidents dans le graphique d'alerte, puis sélectionnez Afficher la règle d'alerte.

  • Pour modifier la règle d'alerte:

    1. Assurez-vous que le tableau de bord est en mode Édition.
    2. Sélectionnez le graphique d'alerte pour activer le volet de configuration, puis cliquez sur Modifier la règle.
  • Pour afficher les détails de la configuration de la série temporelle à afficher, cliquez sur Plus d'options et sélectionnez Afficher dans l'Explorateur de métriques.

    L'Explorateur de métriques affiche un graphique en courbes configuré avec la même configuration de métriques et de filtres que le graphique d'alerte. Toutes les modifications que vous pouvez apporter au graphique qu'affiche l'Explorateur de métriques sont limitées à ce graphique. Autrement dit, vous ne pouvez pas utiliser l'Explorateur de métriques pour modifier la règle d'alerte.

Supprimer des règles d'alerte

Si vous supprimez la règle d'alerte associée à un graphique d'alerte, celui-ci n'affiche plus de données. Pour plus d'informations, consultez Le graphique d'alerte n'affiche aucune donnée.

Afficher les entrées de journal sur un tableau de bord

Pour afficher les entrées de journal dans le même contexte que vos métriques, ajoutez un panneau de journaux à un tableau de bord personnalisé. Comme le panneau des journaux vous permet de filtrer les entrées de journal, vous pouvez le configurer pour n'afficher que les entrées qui vous intéressent.

La capture d'écran suivante illustre un panneau de journaux:

Exemple de tableau de bord avec un panneau de journaux.

Pour savoir comment afficher les entrées de journal sur votre tableau de bord, consultez la page Afficher les journaux dans un tableau de bord personnalisé.

Afficher les SLO sur un tableau de bord

Pour afficher l'état, la conformité ou la marge d'erreur d'un objectif de niveau de service (SLO) pour un service, ajoutez un graphique de SLO à un tableau de bord personnalisé. Un graphique de SLO fournit un résumé des performances d'un service par rapport à un SLO configuré. En utilisant les graphiques des SLO, vous pouvez créer un tableau de bord personnalisé indiquant l'état de tous les SLO pour un ensemble de services.

Avant d'utiliser un graphique de SLO, vous devez avoir configuré des services. Pour en savoir plus sur les services et les SLO, consultez la page Surveillance des SLO.

La capture d'écran suivante illustre un graphique de SLO indiquant la marge d'erreur d'un SLO:

Exemple de graphique de SLO indiquant la marge d'erreur restante pour un SLO.

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

Pour ajouter un graphique de SLO à un tableau de bord, procédez comme suit:

  1. Dans la console, sélectionnez Monitoring ou cliquez sur le bouton suivant :
    Accéder à Monitoring
  2. Dans le volet de navigation, sélectionnez Tableaux de bord, puis choisissez le tableau de bord que vous souhaitez afficher ou modifier.
  3. Si le bouton Modifier le tableau de bord s'affiche, cliquez dessus.
  4. Sélectionnez le widget de graphique SLO dans la bibliothèque de graphiques ou faites-le glisser depuis la bibliothèque vers la zone du graphique.
  5. Sélectionnez un service existant dans le menu Service.
  6. Sélectionnez un SLO existant pour le service dans le menu Objectifs de niveau de service.

    Si le service choisi n'a pas de SLO, un message vous invite à en créer un. Pour ajouter un SLO, cliquez sur Créer un SLO. Pour en savoir plus sur la création des SLO, consultez la page Créer un SLO. Après avoir créé un SLO, sélectionnez-le et passez à l'étape suivante.

  7. Sélectionnez une métrique de SLO dans le menu Type de graphique d'objectif de niveau de service. Vous pouvez sélectionner l'état, la conformité et la marge d'erreur absolue ou fractionnaire. Pour en savoir plus sur les métriques de SLO, consultez la page Récupérer des données de SLO.

Organiser les widgets du tableau de bord

Pour améliorer la facilité d'utilisation d'un tableau de bord avec de nombreux widgets, utilisez des widgets de groupe réductibles. Un widget de groupe réductible est un conteneur pour d'autres widgets. Vous pouvez donc afficher et gérer ces widgets comme une collection. Par exemple, un widget de groupe réductible peut contenir des graphiques affichant des métriques de VM et des règles d'alerte qui surveillent les VM.

Pour ajouter un widget de groupe réductible, procédez comme suit:

  1. Dans la console, sélectionnez Monitoring ou cliquez sur le bouton suivant:
    Accéder à Monitoring
  2. Dans le volet de navigation, sélectionnez Tableaux de bord, puis choisissez le tableau de bord que vous souhaitez afficher ou modifier.
  3. Si le bouton Modifier le tableau de bord s'affiche, cliquez dessus.
  4. Dans la barre d'outils du tableau de bord, assurez-vous que l'option Mosaïque est sélectionnée.
  5. Sélectionnez le widget de groupe réductible dans la bibliothèque de graphiques ou faites-le glisser depuis la bibliothèque vers la zone du graphique.
  6. (Facultatif) Saisissez un titre descriptif dans le volet de configuration. Le titre s'affiche sur le widget.
  7. (Facultatif) Définissez la vue par défaut pour développer ou 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.
  8. Pour ajouter des widgets au groupe, effectuez l'une des opérations suivantes:

    • Faites glisser un widget existant vers le groupe.
    • Faites glisser un widget de la bibliothèque de graphiques vers le groupe.
  9. (Facultatif) Utilisez votre pointeur pour redimensionner et repositionner les widgets dans le groupe.

Pour supprimer un widget d'un widget de groupe réductible, vous pouvez supprimer le widget ou le faire glisser vers l'espace inutilisé du tableau de bord.

Pour supprimer le regroupement, sélectionnez le widget du groupe réductible, puis sélectionnez Annuler dans la barre d'outils du widget.

Étapes suivantes