Afficher la topologie avec la surveillance des applications

Le graphique de topologie de la surveillance des applications vous permet de visualiser les relations entre vos applications, services et charges de travail. Vous pouvez utiliser ce graphique dynamique pour inspecter le flux de trafic, la latence, les taux d'erreur et les alertes ouvertes. Pour les applications enregistrées auprès d'App Hub, vous pouvez afficher la topologie d'une seule application ou au niveau de la limite de gestion des applications pour voir comment vos applications interagissent avec les services et les charges de travail externes.

Pour exécuter des requêtes personnalisées et mettre en corrélation les données d'alerte et de trafic avec d'autres données de télémétrie, utilisez App Topology dans Cloud Hub.

Comprendre le graphique de topologie

Le graphique de topologie de l'application est entièrement interactif et fournit une vue dynamique et utile de vos applications, services et charges de travail. Cette vue vous aide à surveiller et à résoudre les problèmes de performances.

L'image suivante montre un graphique de topologie pour une limite de gestion d'application :

Topologie d'un exemple d'application.

Ce graphique comporte les éléments suivants :

  • Cercles bleus : chaque cercle bleu représente une application enregistrée auprès d'App Hub. L'exemple présente plusieurs applications :

    • Pour deux applications, le cercle bleu affiche un bouton Réduire. Pour ces applications, les services et les charges de travail sont affichés.

    • Pour une application, un seul nœud est affiché et le cercle bleu affiche le bouton Développer . La valeur du bouton correspond au nombre de services et de charges de travail enregistrés.

    Pour obtenir des informations sur les attributs et les alertes de l'application, sélectionnez son cercle bleu.

  • Nœuds : chaque nœud représente un service ou une charge de travail enregistré ou découvert. L'icône du nœud affiche l'un des éléments suivants :

    • Agent ()
    • Serveur MCP ()
    • Service ()
    • Charge de travail ()

    Pour obtenir des informations sur les attributs et les alertes, sélectionnez le nœud.

  • Connexions : représentent le trafic entre deux nœuds. Pour obtenir des informations sur les métriques clés, telles que le taux d'erreur et le 95e centile de latence, sélectionnez la connexion :

    Les connexions affichent la latence et le taux d'erreur entre deux charges de travail.

Limites

  • Les connexions affichent des informations sur la latence et le taux d'erreur qu'Application Monitoring dérive des données de la dernière heure. Vous ne pouvez pas modifier la période utilisée par Application Monitoring.
  • Le graphique de topologie et les menus contextuels n'affichent que les alertes des dernières 24 heures.
  • Pour les applications, services et charges de travail enregistrés, le graphique de topologie affiche les alertes des règles d'alerte avec des étiquettes de ressources, et non des règles d'alerte avec des étiquettes d'application. Pour les services et les charges de travail détectés, Application Monitoring utilise des étiquettes de ressources pour identifier les alertes.
  • Le graphique de topologie affiche au maximum 1 000 nœuds ou connexions. Pour chaque région App Hub compatible, le graphique affiche au maximum 100 services découverts et 100 charges de travail découvertes.
  • Vous ne pouvez pas enregistrer un service ou une charge de travail auprès d'une application en faisant glisser le nœud correspondant dans le cercle bleu d'une application. Le cercle est un guide visuel, pas un conteneur.

  • Pour les ressources suivantes, le graphique de topologie n'affiche les connexions que lorsque le service ou la charge de travail correspondants ont l'état d'enregistrement App Hub discovered :

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

    Un service ou une charge de travail ont l'état d'enregistrement discovered lorsqu'ils font partie de la limite de gestion de l'application, mais ne sont enregistrés dans aucune application.

Avant de commencer

Pour générer un graphique de topologie pour une application, vos données de trace doivent contenir des étiquettes spécifiques à l'application. Ces étiquettes ne sont disponibles que lorsque vous instrumentez votre application avec OpenTelemetry, envoyez vos données de trace à l'API Telemetry et enregistrez votre application auprès d'App Hub.

Pour commencer, procédez comme suit :

  1. Configurez Application Monitoring comme décrit dans Configurer Application Monitoring. La configuration de la surveillance des applications inclut la configuration du champ d'application de trace par défaut pour lister tous les projets qui stockent vos données de trace.

  2. Activez les API Observability, App Topology, Cloud Trace et Telemetry si elles ne sont pas déjà activées.

    Rôles requis pour activer les API

    Pour activer des API, vous devez disposer de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation via le rôle Propriétaire (roles/owner). Sinon, vous pouvez l'obtenir via le rôle Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles.

    Activer les API

    Si vous avez ajouté d'autres projets à votre champ d'application de trace, nous vous recommandons d'activer également l'API Observability pour ces projets. Le graphique de topologie de l'application n'affiche que les connexions de trace des projets de champ d'application de trace qui se trouvent dans la même organisation que votre projet App Hub.

  3. Pour obtenir les autorisations nécessaires pour afficher une topologie d'application, demandez à votre administrateur de vous accorder le rôle IAM Lecteur de topologie d'application (roles/apptopology.viewer) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

    Ce rôle prédéfini contient les autorisations requises pour afficher une topologie d'application. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

    Autorisations requises

    Les autorisations suivantes sont requises pour afficher une topologie d'application :

    • Obtenez les données des ressources découvertes : apptopology.discoveredResourcesTopologies.generate
    • Obtenez les données de la ressource : apptopology.sreDomainTopologies.generate

    Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

  4. Instrumentez votre application pour utiliser OpenTelemetry et envoyez vos données de trace au point de terminaison OTLP.

Afficher la topologie de votre limite de gestion des applications

  1. Dans la console Google Cloud , accédez à la page Surveillance des applications :

    Accéder à Surveillance des applications

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

  2. Dans le sélecteur de projet de la console Google Cloud , sélectionnez votre projet hôte ou projet de gestion.

  3. Cliquez sur l'onglet Topologie. Le graphique de topologie de votre limite de gestion des applications s'affiche.

À partir du graphique de topologie interactif, vous pouvez effectuer les opérations suivantes :

  • Modifiez la visualisation en effectuant un zoom avant ou arrière, en repositionnant les nœuds, ou en réduisant ou en développant un cercle bleu.

  • Obtenez des informations sur les attributs et les alertes associées en sélectionnant une application ou un nœud.

    Pour les services et les charges de travail découverts, le menu volant peut afficher un nom d'inventaire des éléments cloud. Google Cloud Observability utilise le nom de l'élément pour déterminer les données affichées par un tableau de bord.

  • Obtenez des informations sur le trafic entre les nœuds en sélectionnant la connexion. Un menu volant affiche les noms des nœuds et les métriques clés, telles que le taux d'erreur et le 95e centile de latence.

Afficher le graphique de topologie d'une application

  1. Dans la console Google Cloud , accédez à la page Surveillance des applications :

    Accéder à Surveillance des applications

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

  2. Dans le sélecteur de projet de la console Google Cloud , sélectionnez votre projet hôte ou projet de gestion.

  3. Sélectionnez une application dans la liste.

  4. Cliquez sur l'onglet Topologie. Le graphique de topologie de votre application s'affiche.

À partir du graphique de topologie interactif, vous pouvez effectuer les opérations suivantes :

  • Modifiez la visualisation en effectuant un zoom avant ou arrière, ou en repositionnant les nœuds.

  • Obtenez des informations sur les attributs et les alertes en sélectionnant un nœud.

  • Obtenez des informations sur le trafic entre les nœuds en sélectionnant la connexion. Un menu volant affiche les noms des nœuds et les métriques clés, telles que le taux d'erreur et le 95e centile de latence.

Résoudre les problèmes

Pour savoir pourquoi le graphique de topologie de l'application n'affiche pas de données, consultez Résoudre les problèmes liés à Application Monitoring.

Étapes suivantes

  • Explorez les graphiques de topologie dans Cloud Hub.