Configurer un champ d'application de métriques

Ce document explique comment utiliser la console Google Cloud pour configurer un projetGoogle Cloud afin de pouvoir représenter sous forme de graphique et surveiller les données de séries temporelles stockées dans plusieurs projets. Ce document est destiné aux développeurs et aux administrateurs système qui doivent gérer les données de séries temporelles pour des services et des ressources associés à différents projets.

Pour savoir comment configurer un Google Cloud projet par programmation, consultez Configurer un champ d'application de métriques à l'aide de l'API.

Le champ d'application des métriques d'un projet Google Cloud détermine les données de série temporelle que le projet peut représenter sous forme de graphique ou surveiller à l'aide de règles d'alerte.

Applications App Hub et champs d'application des métriques

Vous gérez le champ d'application des métriques pour les projets hôtes App Hub. Vous pouvez gérer ce champ d'application à l'aide de la consoleGoogle Cloud ou de l'API Cloud Monitoring.

Google Cloud gère le champ d'application des métriques pour les dossiers compatibles avec les applications, sauf si l'ajout d'un projet au champ d'application des métriques échoue en raison de l'épuisement du quota du champ d'application des métriques. Dans ce cas, vous pouvez demander une augmentation de quota, puis ajouter manuellement des projets au champ d'application des métriques du projet de gestion pour le dossier compatible avec les applications. Pour en savoir plus, consultez Champs d'application des métriques pour les dossiers compatibles avec les applications.

Avant de commencer

  • Pour obtenir les autorisations nécessaires pour configurer un champ d'application de métriques, demandez à votre administrateur de vous accorder le rôle IAM Administrateur Monitoring (roles/monitoring.admin) sur le projet de définition du champ d'application et sur chaque projet que vous souhaitez ajouter au champ d'application de métriques ou en supprimer. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

    Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

  • Si vous utilisez VPC Service Controls, vous devez prendre en compte l'ordre dans lequel vous configurez un champ d'application des métriques 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 conteneur 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 configurez d'abord le champ d'application des métriques, 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 données de série temporelle des 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 dont le champ d'application des métriques inclut des projets autres que le projet de champ d'application. Un rôle qui accorde l'autorisation de lecture à Monitoring sur le projet de champ d'application permet au compte principal d'afficher les graphiques et les règles d'alerte qui peuvent afficher des données stockées par un projet inclus dans le champ d'application des métriques.

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

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

  1. Dans la console Google Cloud , accédez à la page  Paramètres :

    Accéder aux paramètres

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

  2. Dans la consoleGoogle Cloud , sélectionnez votre projet Google Cloud . Pour les configurations de projet hôte App Hub, sélectionnez le projet hôte.
  3. Sélectionnez Champ d'application de la métrique.

    L'onglet Champ d'application des métriques liste les ressources surveillées par leGoogle Cloud projet actuel. Il liste également les Google Cloud projets dont le champ d'application des métriques inclut le projet Google Cloud actuel.

  4. Pour ajouter des projets Google Cloud au champ d'application des métriques :

    1. Dans le volet Projets Google Cloud, cliquez sur Ajouter des projets.
    2. Dans la boîte de dialogue Ajouter des projets Google Cloud, cliquez sur Sélectionner des projets, puis effectuez vos sélections. Pour enregistrer vos modifications, cliquez sur Ajouter des projets.

      Vous êtes redirigé vers la page Paramètres, et le tableau sur cette page est mis à jour pour lister vos sélections. Si vous souhaitez supprimer un projetGoogle Cloud de la liste, cliquez sur Retirer le projet.

    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. Avant de créer un graphique ou une règle d'alerte, patientez au moins 60 secondes. Vous devrez peut-être actualiser la page de la console Google Cloud pour que les nouvelles métriques soient visibles.

    Le champ d'application des métriques du projet sélectionné a été mis à jour pour inclure les projets Google Cloud que vous avez sélectionnés.

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

Vous pouvez supprimer des projets d'un champ d'application de métriques pour améliorer les performances ou libérer du quota afin d'ajouter un autre projet. Par exemple, par défaut, un champ d'application des métriques peut inclure 375 projets Google Cloud . Si vous avez atteint ce quota, vous pouvez supprimer un projet pour en ajouter un autre.

Une fois que vous avez supprimé un projet d'un champ d'application de métriques, les données de séries temporelles stockées dans ce projet ne peuvent plus être représentées sous forme de graphique ni surveillées par le projet de champ d'application. La suppression d'un projet d'un 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é ni 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, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page  Paramètres :

    Accéder aux paramètres

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

  2. Dans la consoleGoogle Cloud , sélectionnez votre projet Google Cloud . Pour les configurations de projet hôte App Hub, sélectionnez le projet hôte.
  3. Sélectionnez Champ d'application de la métrique.
  4. Dans le volet Projets Google Cloud, sélectionnez les projets que vous souhaitez supprimer, cliquez sur Supprimer le projet, puis confirmez l'opération dans la boîte de dialogue.

Lister les projets dans un champ d'application des métriques

Pour lister les ressources dans un champ d'application des métriques, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page  Paramètres :

    Accéder aux paramètres

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

  2. Dans la consoleGoogle Cloud , sélectionnez votre projet Google Cloud . Pour les configurations de projet hôte App Hub, sélectionnez le projet hôte.
  3. Sélectionnez Champ d'application de la métrique.

    L'onglet Champ d'application des métriques liste les ressources surveillées par leGoogle Cloud projet actuel. Il liste également les Google Cloud projets dont le champ d'application des métriques inclut le projet Google Cloud actuel.

Demander une augmentation du quota

Par défaut, un champ d'application des métriques peut inclure 375 Google Cloud projets. Toutefois, vous pouvez demander une augmentation du quota "Projets surveillés / Champ d'application des métriques Monitoring". Si vous augmentez votre quota au-delà de la valeur par défaut de 375 projets Google Cloud , vous risquez de rencontrer des problèmes de performances.

Pour savoir comment demander une augmentation de quota, consultez Gérer votre quota avec la console Google Cloud .

Sélectionner un autre champ d'application des métriques

Le projet sélectionné dans le sélecteur de projets de la console Google Cloud est le projet de champ d'application du champ d'application des métriques actuel. Il existe une relation de type un à un entre un projet de champ d'application et un champ d'application des métriques.

Pour sélectionner un autre champ d'application des métriques, sélectionnez un autre projet à l'aide du sélecteur de projet de la consoleGoogle Cloud .

Étapes suivantes