Afficher la topologie avec la surveillance des applications

Pour comprendre les relations entre les applications, les services et les charges de travail, consultez le graphique de topologie. Ce graphique dynamique vous aide à comprendre le flux de trafic et à identifier les incidents. Pour les applications enregistrées dans App Hub, vous pouvez afficher la topologie au niveau de l'application. Vous pouvez également afficher un graphique de topologie au niveau de la limite de gestion des applications, ce qui vous permet de comprendre comment une application interagit avec les services et charges de travail externes.

Pour explorer davantage vos applications, vous pouvez utiliser la topologie des applications dans Cloud Hub. Vous pouvez créer des requêtes personnalisées et corréler les données d'alerte et les données sur le trafic avec d'autres données.

Comprendre le graphique de topologie

Le graphique de topologie des applications 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 des applications :

Topologie d'un exemple d'application.

Ce graphique comporte les éléments suivants :

  • Cercles bleus : chaque cercle bleu représente une application enregistrée dans App Hub. L'exemple montre 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 s'affiche et le cercle bleu indique 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 incidents de l'application, sélectionnez son cercle bleu.

  • Nœuds : chaque nœud représente un service ou une charge de travail enregistrés ou découverts. 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 incidents, 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 que la surveillance des applications déduit de la dernière heure de données. Vous ne pouvez pas modifier la période utilisée par la surveillance des applications.
  • Les menus déroulants n'affichent que les incidents des dernières 24 heures :
  • Pour les applications, les services et les charges de travail enregistrés, le graphique de topologie n'affiche que les incidents provenant des règles d'alerte avec des libellés d'application. Pour les services et les charges de travail détectés, la surveillance des applications utilise des libellés de ressources pour identifier les incidents.
  • 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 et 100 charges de travail détectés.
  • Vous ne pouvez pas enregistrer un service ni une charge de travail avec 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 un état d'enregistrement App Hub de 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.

Avant de commencer

Pour générer un graphique de topologie pour une application, vos données de trace doivent contenir des libellés spécifiques à l'application. Ces libellés ne sont disponibles que lorsque vous instrumentez votre application avec OpenTelemetry, que vous envoyez vos données de trace à l'API Telemetry et que vous 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.

    Rôles requis pour activer les API

    Pour activer les API, vous avez besoin du rôle IAM Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin), qui contient l'autorisation serviceusage.services.enable. 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 la topologie des applications n'affiche que les connexions de trace provenant de projets de portée de trace qui appartiennent à la même organisation que votre projet App Hub.

  3. Pour obtenir les autorisations nécessaires pour afficher la topologie des applications, demandez à votre administrateur de vous accorder le rôle IAM Lecteur de topologie des applications (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 la topologie des applications. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

    Autorisations requises

    Les autorisations suivantes sont requises pour afficher la topologie des applications :

    • Pour générer une topologie : apptopology.applicationTopologies.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 envoyer vos données de trace au point de terminaison OTLP.

Afficher la topologie de votre périmètre 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 App Hub ou votre projet de gestion.

  3. Cliquez sur l'onglet Topology (Topologie). Le graphique de topologie de votre application s'affiche.

Dans le 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 développant un cercle bleu.

  • Obtenez des informations sur les attributs et les incidents associés 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 Cloud Asset Inventory. Google Cloud Observability utilise le nom de l'élément pour déterminer les données à afficher dans 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 App Hub ou votre projet de gestion.

  3. Sélectionnez une application dans la liste.

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

Dans le graphique de topologie interactif, vous pouvez effectuer les opérations suivantes :

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

  • Obtenez des informations sur les attributs et les incidents 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 obtenir des informations qui peuvent vous aider à comprendre pourquoi le graphique de topologie des applications n'affiche pas de données, consultez Dépannage de la surveillance des applications.

Étapes suivantes

  • Explorez les graphiques de topologie dans Cloud Hub.