Ce document explique comment configurer le champ d'application des métriques d'un projet de gestion. Un projet de gestion est créé par Google Cloud lorsque vous activez un dossier pour le service Application Monitoring. Le projet de gestion stocke les informations de configuration requises par les services Google Cloud Observability. C'est également le projet que vous utilisez pour afficher la télémétrie de votre application.
Si vous n'utilisez pas de dossier compatible avec les applications, ce document ne s'applique pas. Consultez plutôt Configurer une étendue de métriques.
Cette page explique comment afficher l'utilisation de votre quota de champ d'application des métriques, comment demander une mise à jour du quota et comment mettre à jour manuellement le champ d'application des métriques de votre projet de gestion.
Gérer le champ d'application des métriques pour un projet de gestion
Pour les dossiers compatibles avec les applications, Google Cloud Observability tente de synchroniser la liste des projets de votre dossier compatible avec les applications avec la liste des projets du champ d'application des métriques. Par exemple, si vous ajoutez un projet au dossier compatible avec les applications, une commande est émise pour ajouter ce projet au champ d'application des métriques.
Lorsque le nombre de projets dans votre dossier compatible avec les applications ne dépasse pas votre quota de champ d'application des métriques (qui est de 375 projets par champ d'application des métriques par défaut), Google Cloud Observability peut synchroniser la liste des projets dans le champ d'application des métriques avec la liste des projets dans votre dossier compatible avec les applications. Par exemple, supposons que le quota soit de 375 projets par champ d'application des métriques. Si votre dossier compatible avec les applications contient 100 projets, le champ d'application des métriques liste tous les projets de votre dossier compatible avec les applications. Si vous ajoutez des projets à votre dossier compatible avec les applications, ils sont également ajoutés au champ d'application des métriques.
Lorsque le nombre de projets dans votre dossier compatible avec les applications dépasse votre quota de champ d'application des métriques, la liste des projets dans le champ d'application des métriques n'inclut pas tous les projets de votre dossier compatible avec les applications. Par exemple, supposons que le quota soit de 375 projets par champ d'application des métriques et que votre dossier compatible avec les applications contienne 380 projets. Une fois 375 projets ajoutés au champ d'application des métriques, le quota est épuisé et les tentatives d'ajout des 5 projets restants échouent. Par conséquent, certaines données d'application ne sont pas disponibles pour votre projet de gestion.
Si le quota de métriques est épuisé, vous pouvez effectuer l'une des opérations suivantes :
modifier les projets listés dans le champ d'application des métriques ; Par exemple, vous pouvez supprimer certains projets du champ d'application des métriques pour pouvoir en ajouter d'autres.
Demandez une augmentation de quota, puis ajoutez manuellement les projets qui n'ont pas été ajoutés automatiquement. Dans l'exemple précédent, vous devez ajouter manuellement les cinq projets qui n'ont pas pu être ajoutés au champ d'application des métriques. Google Cloud Observability ne tentera pas d'ajouter un projet à un champ d'application des métriques si la première tentative pour ce projet a échoué.
Dans les deux cas, vous devez modifier manuellement le champ d'application des métriques.
Avant de commencer
- Si vous ne connaissez pas le terme champ d'application des métriques, consultez la présentation des champs d'application des métriques.
-
Pour obtenir les autorisations nécessaires pour configurer un champ d'application des métriques, demandez à votre administrateur de vous accorder le rôle IAM Administrateur Monitoring (
roles/monitoring.admin) sur le projet de gestion de votre dossier compatible avec les applications et sur chaque projet que vous souhaitez ajouter au champ d'application des 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.
Afficher votre utilisation des quotas
Pour éviter d'avoir à gérer manuellement le champ d'application des métriques pour votre projet de gestion, assurez-vous de disposer d'un quota avant d'ajouter des projets à votre dossier compatible avec les applications. Cette section explique comment afficher votre utilisation actuelle des quotas.
Pour afficher votre utilisation des quotas de champ d'application des métriques, procédez comme suit :
-
Dans la console Google Cloud , accédez à la page settings Paramètres :
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.
- Dans la console Google Cloud , sélectionnez votre projet de gestion.
Sélectionnez Champ d'application de la métrique.
Le volet Quota de champ d'application des métriques affiche votre utilisation et votre quota. Les icônes de l'onglet Portée des métriques ont la signification suivante :
L'icône d'erreur error indique qu'au moins 90 % de votre quota est utilisé.
L'icône d'avertissement warning indique que vous avez utilisé entre 70 % et 90 % de votre quota.
Demander une augmentation du quota
Si l'utilisation du quota de champ d'application de métriques de votre projet dépasse 70 %, une icône d'avertissement (warning) ou d'erreur (error) s'affiche dans l'onglet Champ d'application de métriques. Par défaut, un champ d'application des métriques peut inclure 375 projetsGoogle Cloud . Si vous augmentez votre quota et ajoutez plus de 375 projets Google Cloud à un champ d'application des métriques, vous risquez de rencontrer des problèmes de performances.
Pour demander une augmentation de quota, procédez comme suit :
-
Dans la console Google Cloud , accédez à la page settings Paramètres :
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.
- Dans la console Google Cloud , sélectionnez votre projet de gestion.
- Sélectionnez Champ d'application de la métrique.
Dans le volet Quota de portée des métriques, sélectionnez Demander une augmentation du quota, puis remplissez la boîte de dialogue.
Assurez-vous de demander une augmentation du quota "Projets surveillés / Champ d'application des métriques Monitoring". Pour en savoir plus sur cette tâche, consultez le document Gérer votre quota avec la console Google Cloud .
Une fois votre quota augmenté, vous pouvez ajouter des projets à votre 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 :
-
Dans la console Google Cloud , accédez à la page settings Paramètres :
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.
- Dans la console Google Cloud , sélectionnez votre projet de gestion.
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.
Pour ajouter des projets Google Cloud au champ d'application des métriques :
- Dans le volet Projets Google Cloud, cliquez sur Ajouter des projets.
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 cancel 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 :
-
Dans la console Google Cloud , accédez à la page settings Paramètres :
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.
- Dans la console Google Cloud , sélectionnez votre projet de gestion.
- Sélectionnez Champ d'application de la métrique.
- 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 :
-
Dans la console Google Cloud , accédez à la page settings Paramètres :
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.
- Dans la console Google Cloud , sélectionnez votre projet de gestion.
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.