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 la surveillance des applications. Le projet de gestion stocke les informations de configuration requises par les services Google Cloud Observability. C'est 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 un champ d'application de métriques.
Cette page explique comment afficher l'utilisation des quotas de votre champ d'application de métriques, comment demander une mise à jour de quota et comment mettre à jour manuellement le champ d'application de métriques de votre projet de gestion.
Comment la portée des métriques d'un projet de gestion est-elle gérée ?
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 l'application ne dépasse pas votre quota de champ d'application des métriques, qui est défini par défaut sur 375 projets par champ d'application des métriques, Google Cloud Observability peut synchroniser la liste des projets du champ d'application des métriques avec la liste des projets de votre dossier compatible avec l'application. Par exemple, supposons que le quota soit de 375 projets par champ d'application des métriques. Si votre dossier compatible avec l'application contient 100 projets, le champ d'application des métriques liste tous les projets de votre dossier compatible avec l'application. Si vous ajoutez des projets à votre dossier compatible avec l'application, ils sont également ajoutés au champ d'application des métriques.
Lorsque le nombre de projets de votre dossier compatible avec l'application dépasse votre quota de champ d'application des métriques, la liste des projets du champ d'application des métriques n'inclut pas tous les projets de votre dossier compatible avec l'application. 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 cinq projets restants échouent. Par conséquent, certaines données d'application ne sont pas disponibles pour votre projet de gestion.
Si le quota de portée des 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 afin d'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 réessaiera pas d'ajouter un projet à un champ d'application des métriques lorsque la tentative initiale 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 section 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 de surveillance (
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. 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.
Afficher votre utilisation des quotas
Pour éviter d'avoir à gérer manuellement le champ d'application des métriques de votre projet de gestion, assurez-vous de disposer d'un quota disponible avant d'ajouter des projets à votre dossier compatible avec les applications. Cette section explique comment afficher votre utilisation actuelle des quotas.
Pour afficher l'utilisation de votre quota de 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.
Le volet Quota de champ d'application des métriques affiche votre quota et votre utilisation du 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 consommé.
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 votre champ d'application de métriques par votre projet dépasse 70%, une icône d'avertissement (warning) ou une icône 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 projets Google 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 de quota, puis remplissez la boîte de dialogue.
Assurez-vous de demander une augmentation du quota nommé "Projets surveillés / Champ d'application des métriques de surveillance". 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 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.
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 de cette page est mis à jour pour afficher vos sélections. Si vous souhaitez supprimer un projet Google Cloud de la liste, cliquez sur cancel 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
Vous pouvez supprimer des projets d'un champ d'application de métriques pour améliorer les performances ou libérer un 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 déjà utilisé 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 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:
-
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 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:
-
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 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.