Ajouter des widgets au tableau de bord

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Ce document explique comment ajouter des widgets à un tableau de bord personnalisé à l'aide de la console Google Cloud. 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 du 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, une 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 de la comparaison des données avec les seuils d'avertissement et de danger. Pour obtenir des informations générales sur les différents types de widgets, consultez la section 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 Google Cloud:

  • Les graphiques affichent les données au fil du temps, et quatre styles sont disponibles : Ligne, Espace empilé, Barre empilée et Carte de densité. Une fois le graphique configuré, vous pouvez modifier son type de widget. Pour savoir pourquoi vous devez choisir un style spécifique, consultez Graphiques représentant les 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 Table affiche une valeur numérique telle que "25%". Le widget Top List affiche 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 et obtenir un exemple, consultez la section Afficher les données sous forme de tableau sur un tableau de bord.

    Pour savoir comment configurer une table à l'aide de l'API Cloud Monitoring, consultez la section 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 Google Cloud, 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 passer à un autre 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) Regrouper les séries temporelles.
  3. (Facultatif) Configurez les options d'affichage du graphique.
  4. (Facultatif) Représenter plusieurs types de métriques sous forme graphique.

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

Pour sélectionner la série temporelle à représenter dans le graphique, 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 effectuer 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 graphiquement l'utilisation du processeur d'une instance de VM, vous pouvez saisir 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 et les métriques actives. Par défaut, ce bouton est activé de sorte que seules les métriques et les ressources contenant des données soient 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 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 sa valeur. Par exemple, pour n'afficher que les séries temporelles associées à 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 des 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 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 un maximum de 10 types de métriques.

La première fois que vous cliquez sur Ajouter une autre métrique, les sélections que vous avez effectuées précédemment 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 le mode de prétraitement des séries temporelles.
  3. (Facultatif) Regrouper les séries temporelles.
  4. (Facultatif) Configurez les options d'affichage du graphique.
  5. (Facultatif) Représenter plusieurs types de métriques sous forme graphique.
  6. (Facultatif) Représenter un ratio de 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 dans le graphique, 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 effectuer 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 graphiquement l'utilisation du processeur d'une instance de VM, vous pouvez saisir 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 et les métriques actives. Par défaut, ce bouton est activé de sorte que seules les métriques et les ressources contenant des données soient 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 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 sa valeur. Par exemple, pour n'afficher que les séries temporelles associées à 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 des tableaux de bord.

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

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 de 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 la métrique est exprimée en Mio, sélectionnez rate pour passer en Mio par seconde. Pour en savoir plus et obtenir un exemple, consultez la section 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 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 un maximum de 10 types de métriques.

La première fois que vous cliquez sur Ajouter une autre métrique, les sélections que vous avez effectuées précédemment 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 ratio de types de métriques sous forme de graphique

Cette option n'est pas disponible pour les tables.

Par exemple, si 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 sous forme 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 exemples et plus d'informations, consultez la section Ratios des métriques.

Les étapes suivantes supposent que vous avez terminé de tracer 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 autre métrique, les sélections que vous avez effectuées précédemment 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 avoir le même genre. Par exemple, si Time Series-A est une métrique GAUGE, sélectionnez un type de métrique ayant un genre de métrique GAUGE.

  3. Assurez-vous que la valeur du champ Durée d'alignement minimale 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 vous recommandons de faire correspondre les champs de regroupement du deuxième type de métrique aux valeurs du champ Time Series-A. Par exemple, vous pouvez regrouper les deux types de métriques à l'aide du 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 sélectionnez cette option, le libellé Time Series-A est renommé Numerator et le libellé Time Series-B est nommé Denominator.

  6. (Facultatif) Pour modifier le type de métrique correspondant au numérateur, 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 une table à 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 de chaque 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 série temporelle unique. 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 les 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 lors de l'utilisation du langage MQL, consultez la section Filtres du tableau de bord.

PromQL

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

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

avg(compute_googleapis_com:instance_cpu_utilization)

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 série temporelle unique. Si un graphique de carte de densité affiche Your Query has too many time series, modifiez votre requête pour combiner la série temporelle.

Pour en savoir plus sur l'utilisation de PromQL, consultez la section PromQL dans Cloud Monitoring.

Les filtres au niveau de la page dans vos tableaux de bord personnalisés ne sont compatibles avec aucun graphique PromQL de ces tableaux de bord.

Ajouter des indicateurs à un tableau de bord

Pour comparer la mesure la plus récente à un ensemble de seuils codés par couleur, ajoutez une jauge ou un tableau de données. Les graphiques jauges n'affichent que les mesures les plus récentes, tandis que les tableaux de données présentent également un 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 est comprise dans les plages attendues, la couleur du widget est blanche. Lorsque la valeur est comprise dans une plage d'avertissement, le widget devient orange. De même, lorsque la valeur se situe 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 Google Cloud. Pour en savoir plus sur l'utilisation de l'API Cloud Monitoring, consultez la section Tableau de bord avec un fichier Scorecard de base.

Pour ajouter une jauge ou un tableau de données à un tableau de bord, procédez comme suit:

  1. Dans la console Google Cloud, 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 passer à un autre 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 les séries temporelles 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 dans le graphique, 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 effectuer 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 graphiquement l'utilisation du processeur d'une instance de VM, vous pouvez saisir 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 et les métriques actives. Par défaut, ce bouton est activé de sorte que seules les métriques et les ressources contenant des données soient 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 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 sa valeur. Par exemple, pour n'afficher que les séries temporelles associées à 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 des 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 minimale et maximale de 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 de 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 sous forme de graphique Spark. La vue détermine la façon 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 les séries temporelles 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 dans le graphique, 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 effectuer 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 graphiquement l'utilisation du processeur d'une instance de VM, vous pouvez saisir 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 et les métriques actives. Par défaut, ce bouton est activé de sorte que seules les métriques et les ressources contenant des données soient 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 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 sa valeur. Par exemple, pour n'afficher que les séries temporelles associées à 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 des 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, les valeurs d'alignement peuvent être conservées 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 minimale et maximale de 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 de 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 sous forme de graphique Spark. La vue détermine la façon 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.

PromQL

Pour configurer le widget, saisissez une requête PromQL 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. Si vous avez plusieurs VM, cette requête récupère plusieurs séries temporelles et ne peut pas être affichée par une jauge ou un tableau de données:

compute_googleapis_com:instance_cpu_utilization

Si votre requête renvoie plusieurs séries temporelles, un widget de jauge ou de tableau de données affiche le message d'erreur Your Query has too many time series.

Pour résoudre cette condition d'erreur, assurez-vous que la requête renvoie une seule série temporelle. Par exemple, la requête suivante calcule la moyenne pour toutes les séries temporelles:

avg(compute_googleapis_com:instance_cpu_utilization)

Pour en savoir plus sur l'utilisation du langage MQL, consultez la section PromQL dans Cloud Monitoring.

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 un tableau. Les tables peuvent afficher n'importe quel type de métrique ayant une valeur numérique et afficher des centiles pour les métriques à valeur de distribution. Les tableaux n'affichent que la valeur la plus récente, comme le 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 Liste principale est préconfiguré de manière à avoir deux colonnes et à limiter le nombre de lignes. Une colonne du widget Top List affiche un libellé tel que instance_id, et l'autre affiche la valeur et un indicateur visuel de la valeur par rapport à la plage de valeurs possibles. Le widget Table est préconfiguré pour afficher une colonne par étiquette avec plusieurs valeurs uniques, une ligne pour chaque série temporelle et une valeur numérique telle que "25 %".

Les deux widgets sont représentés par la même structure de données. Par conséquent, après avoir ajouté l'un de ces widgets à votre tableau de bord, vous pouvez limiter le nombre de lignes affichées, modifier les colonnes affichées par la table et modifier la représentation de la valeur.

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

Exemples de widgets **Top List** et **Table**.

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 du tableau pour n'afficher que des lignes spécifiques. Ces paramètres ne sont pas persistants. Lorsque vous quittez la page du tableau de bord ou 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, un opérateur logique "AND" rejoint 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 contient 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 inclure des informations sur le tableau de bord, des liens vers des ressources pertinentes ou la procédure à 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 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 une zone de texte, procédez comme suit:

  1. Dans la console Google Cloud, 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 que vous souhaitez 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 surveillée par la règle, 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 Google Cloud. 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 Google Cloud, 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 souhaitez peut-être en savoir plus sur la règle d'alerte affichée par le graphique d'alerte. 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, procédez comme suit:

    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 en savoir plus, consultez Le graphique d'alerte n'affiche aucune donnée.

Afficher les entrées du 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 des entrées de journal sur votre tableau de bord, consultez Afficher les journaux sur 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é. À l'aide de graphiques SLO, vous pouvez créer un tableau de bord personnalisé indiquant l'état de tous les SLO pour un ensemble de services.

Avant de pouvoir 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 Google Cloud. 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 Google Cloud, 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 indique que vous devez en créer un. Pour ajouter un SLO, cliquez sur Créer un SLO. Pour en savoir plus sur la création de 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 comportant 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 les afficher et les gérer en tant que collection. Par exemple, un widget de groupe réductible peut contenir des graphiques affichant les métriques de VM et les règles d'alerte qui surveillent les VM.

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

  1. Dans la console Google Cloud, 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 depuis 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 est affiché 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é dans le tableau de bord.

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

Étapes suivantes