Ce document contient des informations qui peuvent vous aider à comprendre les données affichées sur la page Surveillance des applications. Il contient également des informations qui peuvent vous aider à configurer votre projet Google Cloud afin de pouvoir afficher les données de votre application.
Problèmes connus
Cette section répertorie les problèmes connus liés à la surveillance des applications:
- La latence de la trace n'est pas disponible dans la surveillance des applications. Vous devez utiliser la page Explorateur de traces pour afficher vos données de trace. Pour en savoir plus, consultez Rechercher et explorer des traces.
Résoudre les problèmes
Cette section explique comment résoudre les problèmes liés à la surveillance des applications.
Vous êtes invité à créer une application
Vous ouvrez la page Surveillance des applications dans la console Google Cloud et le message "Créez une application pour commencer" s'affiche. Vous ne devriez pas voir ce message, car vous avez enregistré une application App Hub.
Pour résoudre ce problème, assurez-vous que le sélecteur de ressources est défini sur votre projet hôte App Hub ou sur le projet de gestion de votre dossier compatible avec les applications.
Votre application n'affiche pas de données pour certains signaux d'or
Plusieurs raisons peuvent expliquer l'absence de valeur pour un signal d'or:
L'infrastructure n'est pas compatible avec le type de métrique. Par exemple, les équilibreurs de charge réseau ne sont pas compatibles avec les métriques système. Pour en savoir plus, consultez la section Ressources compatibles avec le hub des applications.
Le type de métrique est accepté, mais aucune donnée n'est disponible. Par exemple, si la période est définie sur un intervalle où aucune donnée métrique n'a été collectée, aucune donnée ne s'affiche pour les signaux d'or.
Pour obtenir la liste des ressources qui génèrent des libellés App Hub, consultez la section Ressources compatibles avec App Hub.
Les données de métriques de votre application sont manquantes ou incomplètes
Vous consultez un graphique pour un service ou une charge de travail, et ce graphique n'affiche aucune donnée de métrique ou certaines données sont manquantes.
Aucune action de votre part n'est requise. Les graphiques ajoutés au tableau de bord prédéfini pour un service ou une charge de travail sont sélectionnés en fonction des ressources utilisées par ce service ou cette charge de travail. Toutefois, certaines ressources peuvent ne pas générer de données pour un type de métrique spécifique. Pour obtenir la liste des ressources qui génèrent des libellés App Hub, consultez la section Ressources compatibles avec App Hub.
Si les données de métrique sont incomplètes, procédez comme suit:
Assurez-vous que le sélecteur de projet est défini sur votre projet hôte App Hub ou le projet de gestion de votre dossier compatible avec les applications.
Assurez-vous que l'administrateur de l'organisation a configuré le champ d'application des métriques pour votre projet hôte App Hub ou le projet de gestion de votre dossier compatible avec les applications afin de lister les projets qui stockent les données de métriques de votre application. Pour en savoir plus, consultez la section Configurer la surveillance des applications.
Les données de journal de votre application sont manquantes ou incomplètes
Le panneau des journaux d'un tableau de bord n'affiche aucune entrée de journal ou n'affiche pas toutes les entrées de journal générées par votre application.
Pour résoudre ce problème, procédez comme suit:
-
Pour obtenir les autorisations nécessaires pour afficher les données de journal, demandez à votre administrateur de vous accorder les rôles IAM suivants:
-
Lecteur de journaux (
roles/logging.viewer) sur votre projet hôte App Hub ou le projet de gestion de votre dossier compatible avec les applications, ainsi que sur tous les autres projets qui indiquent leur portée de journalisation par défaut. Ce rôle permet d'accéder à la plupart des entrées de journaux du bucket de journaux_Default. Pour en savoir plus, consultez la section Rôles de journalisation. -
Accesseur de vues de journaux (
roles/logging.viewAccessor) sur les vues de journaux listées dans le champ d'action de journaux par défaut de votre projet hôte App Hub ou du projet de gestion de votre dossier compatible avec les applications. Pour en savoir plus sur l'octroi d'accès à une vue de journal, consultez Contrôler l'accès à une vue de journal.
-
Lecteur de journaux (
Assurez-vous que l'administrateur de l'organisation a configuré la portée des journaux par défaut de votre projet hôte App Hub ou du projet de gestion de votre dossier compatible avec les applications afin de lister les ressources qui stockent les données de journal de votre application. Pour en savoir plus, consultez la section Configurer la surveillance des applications.
Vos règles d'alerte sont manquantes
Pour qu'une règle d'alerte s'affiche sur un tableau de bord de surveillance des applications, vous devez l'associer à un service ou à une charge de travail en ajoutant des libellés spécifiques à la règle.
Pour associer une règle d'alerte à une charge de travail ou à un service à l'aide de la console Google Cloud, procédez comme suit:
-
Dans la console Google Cloud, accédez à la page notifications Alertes:
Accéder à l'interface des alertes
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.
- Dans la barre d'outils de la console Google Cloud, sélectionnez votre projet hôte App Hub ou le projet de gestion de votre dossier compatible avec les applications.
- Recherchez la règle d'alerte, cliquez sur more_vert Afficher plus, sélectionnez Modifier, puis accédez à la section Notifications et nom.
- Dans la section Étiquettes d'application, sélectionnez votre application, puis votre charge de travail ou votre service.
- Cliquez sur Enregistrer la règle.
Une fois ces étapes terminées, des libellés avec les clés suivantes sont associés à votre règle d'alerte. Ces libellés identifient votre application et votre service ou charge de travail:
apphub_application_locationapphub_application_idapphub_service_idouapphub_workload_id
Vous pouvez également ajouter des libellés utilisateur à une règle d'alerte à l'aide de Google Cloud CLI, de Terraform ou de l'API Cloud Monitoring. Toutefois, vous devez utiliser les clés d'étiquettes indiquées dans l'exemple précédent. Pour en savoir plus, consultez les ressources suivantes :
Vous avez ajouté des libellés d'application à votre règle d'alerte, mais elle ne s'affiche pas
Pour résoudre ce problème, vérifiez que la stratégie inclut les libellés suivants:
apphub_application_locationapphub_application_idapphub_service_idouapphub_workload_id
Les tableaux de bord de vos services et charges de travail sont différents
Aucune action n'est requise de votre part.
Les ressources utilisées par un service ou une charge de travail déterminent les données qui s'affichent pour ce service ou cette charge de travail.
Vous ne pouvez pas enregistrer les modifications apportées au tableau de bord que vous consultez
Vous explorez les données affichées dans un tableau de bord de service ou de charge de travail, et vous souhaitez enregistrer vos modifications. La barre d'outils affiche un bouton Enregistrer dans le tableau de bord. Toutefois, lorsque vous sélectionnez ce bouton, vous ne pouvez pas enregistrer les modifications apportées à votre tableau de bord actuel.
Le bouton Enregistrer dans le tableau de bord ne s'affiche que lorsque le tableau de bord que vous consultez est en lecture seule. Toutefois, vous pouvez utiliser ce bouton pour enregistrer vos modifications dans un tableau de bord personnalisé. Pour en savoir plus, consultez la page Présentation des tableaux de bord.
Vous ne pouvez pas enregistrer votre graphique
Lorsque vous explorez des données de télémétrie, le bouton Enregistrer dans le tableau de bord est désactivé dans la barre d'outils.
Pour résoudre ce problème, assurez-vous de disposer des autorisations nécessaires.
Pour obtenir les autorisations nécessaires pour enregistrer les modifications apportées à un tableau de bord personnalisé, demandez à votre administrateur de vous accorder le rôle IAM Éditeur Monitoring (roles/monitoring.editor) sur votre projet hôte App Hub ou le projet de gestion de votre dossier compatible avec les applications.
Des incidents inattendus sont ouverts
Avec le lancement de la surveillance des applications, le libellé metadata.system_labels.apphub_host_project_id a été renommé metadata.system_labels.apphub_application_container. Ce changement peut entraîner la génération de nouveaux incidents et la non-fermeture de certains incidents ouverts.
Par exemple, pour les règles d'absence de métrique, vous pouvez recevoir une notification, car le changement de libellé peut entraîner l'arrêt de la création d'échantillons dans une série temporelle surveillée.
Aucune action n'est requise de votre part. Les incidents se ferment automatiquement lorsque les données ne sont plus reçues, à l'expiration de la durée de fermeture automatique. Pour en savoir plus, consultez la section Données de métrique partielles.
Vous ne pouvez pas accéder aux journaux de votre dossier activé pour les applications
Vous avez sélectionné un dossier compatible avec les applications avec le sélecteur de ressources dans la console Google Cloud. Vous ouvrez ensuite une page d'observabilité Google Cloud, comme la page Explorateur de journaux, et le sélecteur de ressources est réinitialisé sur un projet.
Ce comportement est intentionnel. Lorsque vous avez sélectionné un dossier compatible avec la gestion des applications, puis que vous accédez à une page Google Cloud Observability, la ressource sélectionnée est réinitialisée sur le projet de gestion du dossier. En règle générale, vous devez sélectionner le projet lorsque vous souhaitez afficher les données de télémétrie d'une application.
Pour accéder aux journaux du dossier compatible avec les applications, utilisez le sélecteur de ressources pour sélectionner manuellement le dossier.