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.

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 surveillance 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 conteneurs de ressources à un champ d'application de métriques

Ajouter un conteneur de ressources à un champ d'application de métriques permet au projet de champ d'application de lire les données de séries temporelles stockées dans ce conteneur de ressources. Par conséquent, les graphiques peuvent afficher ces données de séries temporelles et les règles d'alerte peuvent les surveiller. Si le conteneur contient des ressources enfants, les données qu'elles stockent ne sont pas incluses dans le champ d'application des métriques.

Un conteneur de ressources surveillées est un conteneur de ressources qui a été ajouté à un champ d'application de métriques. Ajouter un conteneur de ressources à un champ d'application de métriques ne modifie pas le conteneur.

Si vous utilisez App Hub, pour afficher les métriques système à partir d'App Hub, vous devez configurer à la fois le projet hôte App Hub et le champ d'application des métriques. L'ajout d'un projet de service App Hub à un projet hôte App Hub ne modifie pas le champ d'application des métriques du projet. De même, l'ajout d'un projet à un champ d'application des métriques ne modifie pas la liste des projets de service App Hub associés au projet hôte App Hub. Pour en savoir plus sur la configuration d'un projet hôte App Hub, consultez Ajouter ou supprimer des projets de service.

Pour ajouter des conteneurs de ressources au champ d'application des métriques du projet en cours, 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. 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.

  3. 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.

    3. 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. 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 conteneurs de ressources surveillées d'un champ d'application de métriques

Une fois que vous avez supprimé un conteneur de ressources d'un champ d'application de métriques, les données de série temporelle stockées dans ce conteneur 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 conteneur 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.

Si vous utilisez App Hub, avant de supprimer un projet du champ d'application des métriques, assurez-vous qu'il n'est pas utilisé par une application App Hub. La suppression du projet du champ d'application des métriques n'aura aucun impact sur l'application. Toutefois, vous ne pourrez pas afficher les métriques système de cette application à partir du contexte du projet hôte App Hub. Pour en savoir plus sur la configuration d'un projet hôte App Hub, consultez Ajouter ou supprimer des projets de service.

Pour supprimer des conteneurs de ressources du champ d'application des métriques du projet en cours, 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. Sélectionnez Champ d'application de la métrique.
  3. 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.

Répertorier les ressources surveillées 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. 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