Afficher la topologie de l'application

Aperçu

Ce produit ou cette fonctionnalité est soumis aux "Conditions des offres pré-DG" de la section "Conditions d'utilisation générales du service" des Conditions spécifiques du service. Les produits et fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une compatibilité limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Ce document explique comment afficher la carte de topologie créée par la surveillance des applications pour vos App Hub applications, services et charges de travail. 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 topologie

La carte de 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 :

  

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

  

La carte de topologie est entièrement interactive. Vous pouvez effectuer 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'une arête spécifique, cliquez sur le nœud ou l'arête.

Avant de commencer

Remarque : Si vous utilisez VPC Service Controls et que vous limitez l'API App Hub, l'API Observability, l'API Telemetry, l'API Cloud Logging ou l'API App Topology, Google Cloud Observability ne peut pas créer de carte de topologie.

Pour générer la carte de topologie des applications, 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 la surveillance des applications comme décrit dans Configurer la surveillance des applications. La configuration de la surveillance des applications inclut la configuration de la portée 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 sera soumis à une règle de restriction d'utilisation du service 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 portée de trace, nous vous recommandons d'activer également l'API Observability pour ces projets. La carte de 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 qu'elle utilise OpenTelemetry et envoie vos données de trace au point de terminaison OTLP.

Afficher la carte de topologie

1. Dans la Google Cloud console, 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 Google Cloud console, sélectionnez votre projet hôte ou projet de gestionApp Hub.

3. Sélectionnez une application dans la liste.

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

La carte de topologie est entièrement interactive. Vous pouvez effectuer 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 une arête :

• Pour afficher les alertes ou les attributs ouverts d'un service ou d'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 Résoudre les problèmes liés à la surveillance des applications.