Afficher la topologie de l'application

Pour comprendre les relations entre les applications, les services et les charges de travail, consultez la carte de la topologie. Cette carte 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 une carte de la topologie au niveau de la limite de gestion des applications, ce qui vous permet de comprendre comment une application interagit avec des services et des charges de travail externes.

Comprendre la carte de la topologie

La carte de la topologie des applications est entièrement interactive 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 une carte de la topologie pour une limite de gestion des applications :

Topologie d'un exemple d'application.

Cette carte 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 est affiché et le cercle bleu affiche le Développer bouton. 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é ou détecté. L'icône d'un nœud est déterminée par le type fonctionnel App Hub lorsqu'il est défini. Sinon, l'icône indique si le nœud représente un service () ou une charge de travail (). Pour obtenir des informations sur les attributs et les incidents, sélectionnez le nœud.

  • Arêtes : 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 l'arête :

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

    La valeur de latence est dérivée de la dernière heure de données.

Limites

La carte de la topologie peut ne pas afficher tous les incidents ni tous les services et charges de travail :

  • Les menus contextuels n'affichent que les incidents des dernières 24 heures.
  • La carte de la topologie affiche au maximum 1 000 nœuds ou arêtes. En outre, pour chaque région App Hub compatible, cette carte affiche au maximum 100 services détectés et 100 charges de travail détectées.
  • Vous ne pouvez pas enregistrer un service ou une charge de travail dans une application en faisant glisser le nœud correspondant dans le cercle bleu d'une application. Le cercle bleu est un guide visuel, pas un conteneur.

Avant de commencer

Pour générer la carte de la topologie d'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 dans App Hub.

Pour commencer, procédez comme suit :

  1. Configurez Application Monitoring comme décrit dans Configurer Application Monitoring. La configuration d'Application Monitoring inclut la configuration du champ d'application de trace par défaut pour répertorier 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 des règles d'administration doit ajouter apptopology.googleapis.com à la liste d'autorisation de la règle pour le projet de gestion du dossier compatible avec les applications. Notez qu'une règle peut également être en place au niveau de l'organisation. Pour en savoir plus, consultez la section Restreindre l'utilisation des ressources.

  3. 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 d'utilisation du service (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. La carte de la topologie des applications n'affiche que les arêtes de trace des projets de champ d'application 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 qu'elle utilise 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 Google Cloud console, accédez à la page Application monitoring (Surveillance des applications) :

    Accéder à Application monitoring (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 Google Cloud console, sélectionnez votre App Hub projet hôte ou de gestion.

  3. Cliquez sur l'onglet Topology (Topologie). La carte de la topologie de votre application s'affiche.

Depuis la carte de la topologie interactive, 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 incidents associés en sélectionnant une application ou un nœud.

    Pour les services et les charges de travail détectés, le menu contextuel peut afficher un nom Cloud Asset Inventory. 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 l'arête. Un menu contextuel 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 la carte de la topologie d'une application

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

    Accéder à Application monitoring (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 Google Cloud console, sélectionnez votre App Hub projet hôte ou de gestion.

  3. Sélectionnez une application dans la liste.

  4. Cliquez sur l'onglet Topology (Topologie). La carte de la topologie de votre application s'affiche.

Depuis la carte de la topologie interactive, 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 incidents en sélectionnant un nœud.

  • Obtenez des informations sur le trafic entre les nœuds en sélectionnant l'arête. Un menu contextuel 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 la carte de la topologie des applications n'affiche pas de données, consultez Résoudre les problèmes liés à Application Monitoring.