Résoudre les problèmes de surveillance des applications

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 :

  • Pour les ressources suivantes, la carte de topologie n'affiche les arêtes que lorsque le service ou la charge de travail correspondants ont un état d'enregistrement App Hub défini sur discovered :

    • Ressources Firestore
    • Ressources Spanner
    • Ressources Cloud Storage
    • Serveurs MCP Google Cloud

    Un service ou une charge de travail a l'état d'enregistrement discovered lorsqu'il fait partie de la limite de gestion des applications, mais qu'il n'est enregistré dans aucune application.

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 clés

Plusieurs raisons peuvent expliquer pourquoi vous ne voyez pas 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 Services et charges de travail compatibles avec la surveillance 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 pendant lequel aucune donnée de 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 Services et charges de travail compatibles avec la surveillance des applications.

Les données de métriques de votre application sont manquantes ou incomplètes

Vous affichez un graphique pour un service ou une charge de travail, mais il ne présente aucune donnée de métrique ou certaines données sont manquantes.

Il est possible que vous n'ayez rien à faire. 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, il est possible que certaines ressources ne génèrent pas 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 Services et charges de travail compatibles avec la surveillance des applications.

Si les données de métrique sont incomplètes, procédez comme suit :

  1. Assurez-vous que le sélecteur de projet est défini sur votre projet hôte App Hub ou sur le projet de gestion de votre dossier compatible avec les applications.

  2. 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 Configurer la surveillance des applications.

Les données de journaux 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 :

  1. Pour obtenir les autorisations nécessaires pour afficher les données de journaux, 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 listés dans son champ d'application des journaux 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 Rôles de journalisation.
    • Accesseur de vues de journaux (roles/logging.viewAccessor) sur les vues de journaux listées dans le champ d'application des journaux par défaut de votre projet hôte App Hub ou du projet de gestion de votre dossier compatible avec les applications. Pour savoir comment accorder l'accès à une vue de journal, consultez Contrôler l'accès à une vue de journal.

  2. Assurez-vous que l'administrateur de l'organisation a configuré le champ d'application des journaux par défaut de votre projet hôte App Hub ou du projet de gestion de votre dossier compatible avec les applications pour lister les ressources qui stockent les données de journaux de votre application. Pour en savoir plus, consultez Configurer la surveillance des applications.

Vos règles d'alerte sont manquantes

Pour les services et les charges de travail enregistrés, les tableaux de bord et la carte de topologie n'affichent les alertes que lorsque la règle d'alerte correspondante contient des libellés spécifiques à l'application. Il s'agit de libellés que vous ajoutez à la règle. Pour les services et les charges de travail découverts, la carte de topologie affiche les alertes en filtrant les libellés de ressources.

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 :

  1. Dans la console Google Cloud , accédez à la page Alertes :

    Accéder à la page Alertes

    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 barre d'outils de la consoleGoogle Cloud , sélectionnez votre projet hôte App Hub ou le projet de gestion de votre dossier compatible avec les applications.
  3. Recherchez la règle d'alerte, cliquez sur Afficher plus, sélectionnez Modifier, puis accédez à la section Notifications et nom.

  4. Dans la section Libellés d'application, sélectionnez votre application, puis votre service ou charge de travail :

    Page des règles d'alerte montrant comment associer une règle d'alerte à des libellés App Hub.

  5. 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, ainsi que votre service ou charge de travail :

  • apphub_application_location
  • apphub_application_id
  • apphub_service_id ou apphub_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 de libellé 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 celle-ci ne figure pas dans la liste.

Pour résoudre cet échec, vérifiez que la règle inclut les libellés suivants :

  • apphub_application_location
  • apphub_application_id
  • apphub_service_id ou apphub_workload_id

Les tableaux de bord de vos services et charges de travail sont différents

Aucune action n'est requise.

Les ressources utilisées par un service ou une charge de travail déterminent les données affichées 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 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 le projet hôte App Hub ou le projet de gestion de votre dossier compatible avec les applications.

Des alertes inattendues s'ouvrent

Avec la sortie d'Application Monitoring, le libellé metadata.system_labels.apphub_host_project_id a été renommé metadata.system_labels.apphub_application_container. Cette modification peut entraîner la génération de nouvelles alertes et la non-fermeture de certaines alertes ouvertes. Par exemple, pour les règles d'absence de métrique, vous pouvez recevoir une notification, car la modification des libellés peut entraîner l'arrêt de l'enregistrement d'échantillons par une série temporelle surveillée.

Aucune action n'est requise. Les alertes se ferment automatiquement lorsque les données cessent d'arriver, une fois la durée de fermeture automatique expirée. Pour en savoir plus, consultez Données de métrique partielles.

Vous ne pouvez pas accéder aux journaux dans votre dossier compatible avec les applications

Vous avez sélectionné un dossier compatible avec les applications à l'aide du sélecteur de ressources dans la console Google Cloud . Vous ouvrez ensuite une page Google Cloud Observability, comme la page Explorateur de journaux, et le sélecteur de ressources est réinitialisé sur un projet.

Ce comportement est intentionnel. Lorsque vous sélectionnez un dossier compatible avec les applications, puis 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 souhaitez que le projet soit sélectionné lorsque vous voulez afficher les données de télémétrie d'une application.

Pour accéder aux journaux dans le dossier compatible avec les applications, utilisez le sélecteur de ressources pour sélectionner manuellement le dossier.

Les arêtes n'apparaissent pas dans la carte de topologie de votre application

Vous pouvez voir vos services et charges de travail d'application visualisés dans la carte de topologie de la surveillance des applications, mais vous ne voyez aucun bord les reliant. Vous pouvez également voir un message semblable à "Aucune connexion de trace détectée pour le graphique de topologie. Instrumentez pour Trace afin de profiter pleinement de l'expérience de topologie."

Les arêtes de la carte de topologie représentent le trafic dans votre application et sont générées par les données de Cloud Trace. Essayez les solutions suivantes pour résoudre ce problème :

  1. Configurez votre application pour utiliser Trace :

  2. Vérifiez que vous avez configuré et défini le champ d'application de trace par défaut. Pour en savoir plus, consultez Configurer la surveillance des applications.

  3. Vérifiez que les spans de trace de votre application sont associés à des attributs de ressources spécifiques à l'application. Pour en savoir plus, consultez Ajouter des attributs d'application aux spans de trace.