Afficher la topologie de l'application

Ce document explique comment afficher le mappage de la topologie que la surveillance des applications crée pour vos applications, services et charges de travail App Hub. La carte de topologie des applications fournit une vue dynamique des relations de votre application pour vous aider à surveiller les alertes et le trafic, et à résoudre les problèmes.

Comprendre la carte de la topologie

La carte de la topologie des applications fournit une vue dynamique et exploitable des performances de votre application, ce qui simplifie la surveillance et le dépannage. La carte de topologie représente votre application à l'aide de nœuds et d'arêtes, comme suit :

  • Les nœuds représentent les services et les charges de travail de votre application :

    Topologie d'un exemple d'application.

  • Les arêtes représentent le trafic de votre application entre vos services et vos charges de travail :

    Les arêtes affichent la latence et le taux d'erreur.

La carte de la topologie est entièrement interactive. Vous pouvez faire un zoom avant ou arrière, et déplacer les nœuds pour visualiser la relation entre vos services et vos charges de travail. Pour ouvrir un panneau qui fournit des informations supplémentaires sur l'état d'un nœud ou d'un bord spécifique, cliquez sur le nœud ou le bord.

Avant de commencer

Pour générer le mappage de la topologie de l'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. Si vous utilisez un dossier compatible avec les applications, votre projet disposera d'une règle de restriction d'utilisation des services par défaut qui vous empêchera d'utiliser l'API App Topology. Pour résoudre ce problème, une personne disposant du rôle Administrateur de règle d'administration doit ajouter apptopology.googleapis.com à la liste d'autorisation des règles pour le projet de gestion des dossiers compatible avec les applications. Notez qu'il peut également exister une règle au niveau de l'organisation. Pour en savoir plus, consultez Restreindre l'utilisation des ressources.

  3. Enable the Observability, App Topology, and Telemetry APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

    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. La carte de la topologie des applications n'affiche que les arêtes de trace des projets de portée de trace qui se trouvent dans la même organisation que votre projet App Hub.

  4. 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 la topologie : apptopology.applicationTopologies.generate

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

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

Afficher la carte de la topologie

  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). La carte de topologie de votre application s'affiche.

La carte de la topologie est entièrement interactive. Vous pouvez faire un zoom avant ou arrière, et déplacer les nœuds pour visualiser la relation entre vos services et vos charges de travail. Vous pouvez également afficher des informations sur un nœud ou un bord :

  • Pour afficher les alertes ou les attributs ouverts pour un service ou une charge de travail, sélectionnez le nœud.
  • Pour afficher la latence et le taux d'erreur entre deux nœuds, sélectionnez l'arête.

Résoudre les problèmes

Pour obtenir des informations qui peuvent vous aider à comprendre pourquoi la carte de topologie des applications n'affiche pas de données, consultez Dépannage de la surveillance des applications.