Configurer un champ d'application de métriques

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

Pour en savoir plus sur la configuration d'un projet Google Cloud de manière automatisée, consultez la section 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éries temporelles que le projet peut représenter sous forme de graphique ou surveiller à l'aide de règles d'alerte.

Champs d'application des applications et des métriques App Hub

Une application que vous enregistrez avec App Hub peut envoyer des données de métriques à plusieurs projets. Si vous souhaitez créer un graphique qui affiche les données stockées dans plusieurs projets ou si vous souhaitez qu'une règle d'alerte surveille les données stockées dans plusieurs projets, vous devez configurer le champ d'application des métriques du projet hôte App Hub. Si vous ajoutez ou supprimez un service, mettez également à jour manuellement la portée des métriques.

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 portée et sur chaque conteneur de ressources que vous souhaitez ajouter au champ d'application de métriques. 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 via 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 conteneur de ressources 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 conteneur de ressources 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 conteneur de ressources 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éries temporelles pour les conteneurs de ressources 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, prenez en compte les implications des autorisations sur un projet dont le champ d'application des métriques inclut des conteneurs de ressources autres que le projet de champ d'application. Un rôle qui accorde une autorisation de lecture à Monitoring sur le projet de champ d'application permet au principal d'afficher des graphiques et des règles d'alerte susceptibles d'afficher des données stockées par un conteneur de ressources 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. Accédez à la page  Paramètres dans la console Google Cloud.

    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 console Google Cloud, sélectionnez votre projet Google Cloud.
  3. Sélectionnez Champ d'application de la métrique.

    L'onglet Champ d'application des métriques liste les ressources surveillées par le projet Google Cloud actuel. Il liste également les projets Google Cloud 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 de cette page est mis à jour pour afficher vos sélections. Si vous souhaitez supprimer un projet Google Cloud de la liste, cliquez sur  Supprimer 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 de votre 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

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 graphiques ni surveillées par le projet de champ d'application. 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, procédez comme suit:

  1. Accédez à la page  Paramètres dans la console Google Cloud.

    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 console Google Cloud, sélectionnez votre projet Google Cloud.
  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 remplissez la boîte de dialogue de confirmation.

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

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

  1. Accédez à la page  Paramètres dans la console Google Cloud.

    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 console Google Cloud, sélectionnez votre projet Google Cloud.
  3. Sélectionnez Champ d'application de la métrique.

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

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 avec l'outil de sélection de projets de la console Google Cloud.

Étape suivante