Afficher les métriques pour plusieurs projets

Ce document explique comment configurer un champ d'application des 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 ont besoin de gérer les métriques pour les services et les ressources associés à différents projets Cloud.

Pour en savoir plus sur la configuration d'un champ d'application des 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 bien les termes champ d'application des métriques et projet effectuant une surveillance, consultez la section Champs d'application des métriques.

  • Assurez-vous que votre rôle Identity and Access Management (IAM) sur le projet effectuant une surveillance vous permet de modifier la portée des métriques du projet. Pour en savoir plus sur les rôles IAM requis, consultez la section 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 permet de modifier le champ d'application des métriques du projet. Pour en savoir plus sur les rôles IAM requis, consultez la section 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 différents périmètres.

  • Si vous configurez des rôles IAM ou accordez l'accès aux projets, vous devez prendre en compte les implications des autorisations sur un projet qui est un champ d'application pour un champ d'application des métriques multiprojets. Si vous accordez à un utilisateur un rôle sur un projet et que vous l'autorisez à lire les données Monitoring, cet utilisateur peut alors afficher toutes les métriques accessibles au 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 de la région Production.

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

Créer un champ d'application des 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 servant de champ d'application pour ce champ d'application des métriques. Nous vous recommandons également de ne pas créer de ressources dans ce projet effectuant une surveillance. 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 des métriques, ce projet doit être le projet effectuant une surveillance ou un projet surveillé du champ d'application des métriques. Si un projet n'est pas explicitement répertorié comme concerné, 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, telle qu'une instance de machine virtuelle (VM), qui génère des métriques.

  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 des 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 plus disponibles lorsque vous créez un graphique ou une règle d'alerte, actualisez la page Google Cloud Console.

Par exemple, supposons que vous disposiez 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 décrite 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 des métriques multiprojets, qui inclut les métriques des trois projets:

    Liste des projets inclus dans les métriques du projet "AllEnvironments".

    Le projet AllEnvironments ne dispose d'aucune ressource et ne contient donc 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 l'Staging (Production ), puis accédez à Surveillance , vous accédez alors au champ d'application des métriquesStaging (Production ). La capture d'écran suivante montre que le champ d'application des métriques pour le projet Staging (Production) est uniquement ce projet:

    Liste des projets inclus 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.

Cette configuration vous a permis d'atteindre vos objectifs. 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 contient pas de ressources. Par conséquent, 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 effectuant une surveillance, sélectionnez l'option Utiliser ce projet en tant que projet effectuant une surveillance:

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

    La boîte de dialogue précédente s'affiche lorsque le projet effectuant une surveillance, c'est-à-dire le projet sélectionné par le sélecteur de projet Cloud Console, contient au moins une ressource. La boîte de dialogue vous propose des options pour créer un projet effectuant une surveillance ou pour continuer avec le projet existant.

  6. Cliquez sur Add Projects (Ajouter des projets).

    Une fois que vous avez ajouté des projets à un champ d'application des 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 plus 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 devez modifier 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 inclut 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 pour le projet "Staging", qui incluent 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. Comme ce projet ne contient aucun projet surveillé, vous ne pouvez accéder qu'aux métriques qui lui sont associées. La capture d'écran suivante montre que le champ d'application des métriques pour le projet Production est uniquement ce projet:

    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 des métriques, ce champ d'application vous permet de surveiller les données du projet effectuant la surveillance 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 effectuant une surveillance 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 effectuant une surveillance n'inclut aucune métrique, par exemple lorsque le projet est nouveau, vous pouvez utiliser les champs d'application des métriques des projets surveillés pour n'afficher que leurs métriques.

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

Pour ajouter des projets en tant que projets surveillés dans un champ d'application des 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 des métriques est sélectionné.

  3. Dans le volet de navigation de Cloud 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 Portée des métriques. Pour accéder à cette page, dans le volet de navigation de Cloud Monitoring, cliquez sur Développer dans le champ Champ d'application des métriques.

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

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

Pour supprimer les projets d'un champ d'application des 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 des 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