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 :

  • La latence des traces n'est pas disponible dans la surveillance des applications. Vous devez utiliser la page Explorateur Trace 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 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 le 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 Logging.
    • 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 en savoir plus sur l'octroi d'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 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 :

  1. Dans la console Google Cloud , accédez à la page  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.

  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 charge de travail ou votre service.
  5. Cliquez sur Enregistrer la règle.

Une fois ces étapes terminées, les 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 stratégie 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 de votre part.

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 si 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 incidents inattendus sont ouverts

Avec la sortie d'Application Monitoring, le libellé metadata.system_labels.apphub_host_project_id a été renommé metadata.system_labels.apphub_application_container. Ce changement peut entraîner la création 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 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 de votre part. Les incidents 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étriques 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.