Afficher les métriques pour plusieurs projets

Ce document explique comment configurer un champ d'application de métriques pour accéder aux métriques stockées dans plusieurs projets Google Cloud et les surveiller à l'aide de Google Cloud Console. Ce document est destiné aux développeurs et aux administrateurs système qui doivent gérer les métriques pour des services et des ressources associés à différents projets Cloud.

Pour savoir comment configurer un champ d'application de métriques par programmation, consultez la page Gérer les champs d'application des métriques à l'aide de l'API.

Avant de commencer

  • Si vous ne connaissez pas les termes champ d'application des métriques et projet de champ d'application, consultez la section champs d'application des métriques.

  • Assurez-vous que votre rôle IAM (Identity and Access Management) sur le projet de champ d'application vous permet de modifier le champ d'application des métriques du projet. Pour en savoir plus sur les rôles IAM requis, consultez la page Configurations des champs d'application des métriques.

  • Pour chaque projet que vous souhaitez ajouter en tant que projet surveillé, assurez-vous que votre rôle IAM vous permette de modifier le champ d'application des métriques du projet. Pour en savoir plus sur les rôles IAM requis, consultez la page Configurations des champs d'application des métriques.

  • Si vous utilisez VPC Service Controls, vous devez prendre en compte l'ordre dans lequel vous créez le champ d'application des métriques multiprojets et vos périmètres VPC. Cloud Monitoring effectue la vérification du périmètre VPC lorsqu'un projet est ajouté à un champ d'application de métriques:

    • Lorsque vous créez d'abord le périmètre VPC, puis que vous essayez d'ajouter un projet au champ d'application des métriques, le processus de validation du périmètre s'exécute. Ce processus vérifie que le projet ajouté se trouve dans le même périmètre que le projet de champ d'application ou qu'il est connecté au projet de champ d'application via une liaison de périmètre. Si la validation du périmètre échoue, l'ajout du projet au champ d'application des métriques échoue également.

    • Lorsque vous créez d'abord le champ d'application de vos métriques multiprojets, puis que vous créez vos périmètres, le processus de validation du périmètre ne s'exécute pas. Cette approche vous permet d'accéder aux métriques de projets situés dans des périmètres différents.

  • Si vous configurez des rôles IAM ou que vous accordez l'accès aux projets, vous devez prendre en compte les implications des autorisations sur un projet qui correspond à un projet de champ d'application pour un champ d'application des métriques multiprojets. Si vous attribuez à un utilisateur un rôle sur un projet et que ce rôle lui permet de lire les données Monitoring, cet utilisateur peut afficher toutes les métriques accessibles par le champ d'application des métriques pour ce projet. Par exemple, si le projet Staging surveille le projet Production, un utilisateur pouvant afficher les métriques du projet Staging peut également afficher les métriques du projet Production.

  • Si vous souhaitez afficher les métriques de vos instances Amazon Elastic Compute Cloud (Amazon EC2), consultez la page Afficher les métriques d'un compte AWS.

Créer un champ d'application de métriques multiprojets

Pour gérer les métriques de plusieurs projets, ajoutez ces projets à un champ d'application des métriques. Lorsque vous créez un champ d'application des métriques ayant accès aux métriques de plusieurs projets, les graphiques, par exemple, affichent les métriques de tous les projets.

Lorsque vous souhaitez gérer les métriques de plusieurs projets, nous vous recommandons de créer un projet qui sera le projet du champ d'application des métriques concernées. Nous vous recommandons également de ne pas créer de ressources dans ce projet de champ d'application. Ces recommandations garantissent que votre projet de champ d'application ne génère pas de métriques, qui sont combinées aux métriques des autres projets dans le même champ d'application des métriques.

Pour que les métriques d'un projet soient accessibles dans un champ d'application de métriques, ce projet doit être le projet de champ d'application ou un projet surveillé du champ d'application des métriques. Si un projet n'est pas explicitement répertorié comme étant dans le champ d'application, ses métriques ne sont pas accessibles.

Utiliser un nouveau projet (recommandé)

Pour créer un champ d'application de métriques multiprojets à l'aide d'un nouveau projet, procédez comme suit:

  1. Dans Google Cloud Console, créez un projet Google Cloud :

    Accéder à Cloud Console

    Nous vous recommandons de définir une convention d'attribution de noms pour les projets qui sont des projets de champ d'application de métriques multiprojets.

    N'utilisez pas ce projet à des fins autres que le projet de champ d'application pour les champs d'application de vos métriques multiprojets. Comme ce projet est nouveau, il ne contient aucune ressource qui génère des métriques, telles que des instances de machine virtuelle (VM).

  2. Sélectionnez votre nouveau projet avec l'outil de sélection de projets de Cloud Console.

  3. Dans le volet de navigation de Cloud Console, sélectionnez Monitoring, puis Paramètres.

  4. Cliquez sur Ajouter des projets GCP, puis sélectionnez les projets dont vous souhaitez accéder aux métriques à partir de ce champ d'application des métriques.

  5. Cliquez sur Ajouter des projets.

    Une fois que vous avez ajouté des projets à un champ d'application de métriques, la propagation des modifications dans tous les systèmes Monitoring prend environ 60 secondes. Si, au bout de 60 secondes, les métriques des projets ajoutés ne sont pas disponibles lorsque vous créez un graphique ou une règle d'alerte, actualisez la page Google Cloud Console.

Par exemple, supposons que vous disposez de deux projets contenant des instances de VM Compute Engine, Staging et Production. Supposons que ces deux projets ne surveillent que leurs propres données de projet. Autrement dit, leurs champs d'application de métriques n'incluent aucun projet surveillé. Vous souhaitez configurer des alertes pour les VM de chaque projet et afficher des tableaux de bord affichant des métriques pour les deux projets.

Vous suivez l'approche répertoriée dans cette section et créez le projet AllEnvironments, puis vous ajoutez les projets Staging et Production en tant que projets surveillés :

  • Si vous sélectionnez AllEnvironments, puis accédez à Monitoring, vous accédez au champ d'application de métriques multiprojets, qui incluent les métriques des trois projets:

    Liste des projets dans le champ d'application de métriques du projet "AllEnvironments".

    Le projet AllEnvironments ne comportant aucune ressource, il ne contient aucune métrique. Par conséquent, lorsque vous créez un graphique, vous ne voyez que les métriques des projets Staging et Production :

  • Si vous sélectionnez le projet Staging (Production ), puis accédez à Monitoring, alors vous accédez au champ d'application de métriques du projet Staging (Production). La capture d'écran suivante montre que le champ d'application des métriques pour le projet Staging (Production) se résume à ce projet uniquement :

    Liste des projets dans le champ d'application des métriques du projet "Staging".

    La capture d'écran précédente montre également que les métriques du projet Staging sont accessibles au projet AllEnvironments.

Vous avez atteint vos objectifs avec cette configuration. Lorsque vous sélectionnez le projet Staging (ou Production), vous accédez uniquement aux métriques de ce projet. Lorsque vous sélectionnez le projet AllEnvironments, vous avez accès aux métriques de tous les projets. Cependant, le projet AllEnvironments ne comportant aucune ressource, il ne génère pas de métriques.

Utiliser un projet existant

Pour ajouter le projet Production au champ d'application des métriques du projet Staging, procédez comme suit :

  1. Dans Google Cloud Console, sélectionnez Surveillance :

    Accéder à Monitoring

  2. Sélectionnez Staging avec l'outil de sélection de projets Cloud Console.

  3. Dans le volet de navigation Monitoring, sélectionnez Paramètres.

  4. Dans le volet des projets Google Cloud, cliquez sur Ajouter des projets GCP, puis sélectionnez Production.

  5. Si vous êtes invité à sélectionner un projet de champ d'application, sélectionnez l'option Utiliser ce projet comme projet de champ d'application :

    Options de configuration d'un champ d'application des métriques.

    La boîte de dialogue précédente s'affiche lorsque le projet de champ d'application, c'est-à-dire le projet sélectionné par l'outil de sélection de projet Cloud Console, contient au moins une ressource. La boîte de dialogue vous propose de créer un projet de champ d'application ou de continuer avec le projet de champ d'application existant.

  6. Cliquez sur Ajouter des projets.

    Une fois que vous avez ajouté des projets à un champ d'application de métriques, la propagation des modifications dans tous les systèmes Monitoring prend environ 60 secondes. Si, au bout de 60 secondes, les métriques des projets ajoutés ne sont pas disponibles lorsque vous créez un graphique ou une règle d'alerte, actualisez la page Google Cloud Console.

Prenons l'exemple précédent où les projets Staging et Production contiennent des instances de VM Compute Engine. Au départ, supposons que ces deux projets ne surveillent que leurs propres données. Autrement dit, leurs champs d'application de métriques n'incluent aucun projet surveillé. Comme précédemment, vous souhaitez configurer des alertes pour les VM de chaque projet et vous souhaitez afficher des tableaux de bord affichant les métriques des deux projets.

Si vous suivez la procédure décrite dans cette section, vous modifiez le champ d'application des métriques pour le projet Staging afin d'inclure les métriques du projet Production :

  • Lorsque vous sélectionnez le projet Staging, puis accédez à Monitoring, vous accédez au champ d'application des métriques multiprojets qui inclue les métriques des deux projets. La capture d'écran suivante montre que le champ d'application des métriques pour le projet Staging inclut les projets Staging et Production :

    Capture d'écran montrant les champs d'application des métriques du projet "Staging" qui inclut les métriques du projet "Production".

  • Lorsque vous sélectionnez le projet Production, puis accédez à la page Monitoring, vous accédez au champ d'application des métriques pour le projet Production. Étant donné que ce projet ne contient aucun projet surveillé, vous ne pouvez accéder qu'aux métriques de ce projet. La capture d'écran suivante montre que le champ d'application des métriques pour le projet Production se résume à ce projet uniquement :

    Capture d'écran montrant le champ d'application des métriques du projet "Production".

    La capture d'écran précédente montre également que les métriques du projet Production sont accessibles au projet Staging.

Lorsque vous ajoutez un projet à un champ d'application de métriques, ce champ d'application vous permet de surveiller les données du projet de champ d'application et du projet surveillé. À partir de ce champ d'application des métriques, vous ne pouvez pas facilement accéder uniquement aux métriques du projet de champ d'application ou du projet surveillé. À la place, vous accédez aux métriques combinées des deux projets.

Lorsqu'un projet de champ d'application contient ses propres métriques, vous devez utiliser des filtres pour séparer les métriques du projet de champ d'application des métriques des projets surveillés. Par exemple, vous devez utiliser des filtres si vous souhaitez créer une règle d'alerte qui surveille uniquement les instances de VM du projet Staging. Lorsque le projet de champ d'application ne contient aucune métrique, par exemple lorsqu'il s'agit d'un nouveau projet, vous pouvez utiliser les champs d'application des métriques des projets surveillées pour n'afficher que leurs métriques.

Ajouter des projets à un champ d'application de métriques

Pour ajouter des projets en tant que projets surveillés dans un champ d'application de métriques, procédez comme suit:

  1. Dans Google Cloud Console, sélectionnez Surveillance :

    Accéder à Monitoring

  2. Assurez-vous que le projet dont vous souhaitez modifier le champ d'application de métriques est sélectionné.

  3. Dans le volet de navigation Monitoring, sélectionnez Paramètres.

  4. Cliquez sur Ajouter des projets GCP, puis sélectionnez les projets que vous souhaitez ajouter.

  5. Cliquez sur Ajouter des projets.

Vous pouvez également ajouter des projets surveillés à partir de la page Champ d'application des métriques. Pour accéder à cette page, dans le volet de navigation Cloud Monitoring, cliquez sur Développer dans le champ Champ d'application des métriques.

Supprimer des projets d'un champ d'application de métriques

Si vous supprimez un projet d'un champ d'application de métriques, les métriques stockées dans ce projet ne seront pas accessibles au champ d'application de métriques. La suppression d'un projet du champ d'application de métriques ne modifie pas la configuration des graphiques, des tableaux de bord, des règles d'alerte, des tests de disponibilité ou des groupes que vous avez définis. Cependant, la série temporelle affichée sur les graphiques et la série temporelle surveillée par des règles d'alerte peuvent changer.

Pour supprimer des projets d'un champ d'application de métriques actuel, procédez comme suit:

  1. Dans Google Cloud Console, sélectionnez Surveillance :

    Accéder à Monitoring

  2. Assurez-vous que le projet dont vous souhaitez modifier le champ d'application de métriques est sélectionné.

  3. Dans le volet de navigation Monitoring, sélectionnez  Paramètres.

  4. Dans le volet GCP Projects in scope (Projets GCP concernés), sélectionnez les projets que vous souhaitez supprimer, puis cliquez sur Remove project (Supprimer le projet).

Étape suivante