Anwendungstopologie ansehen

In diesem Dokument wird beschrieben, wie Sie die Topologiekarte aufrufen, die Application Monitoring für Ihre App Hub-Anwendungen, ‑Dienste und ‑Arbeitslasten erstellt. Die Karte der Anwendungstopologie bietet eine dynamische Ansicht der Beziehungen Ihrer Anwendung, mit der Sie Benachrichtigungen und Traffic überwachen und Probleme beheben können.

Topologiekarte

Die Anwendungstopologiekarte bietet eine dynamische und umsetzbare Ansicht der Leistung Ihrer Anwendung und vereinfacht so die Überwachung und Fehlerbehebung. Die Topologiekarte stellt Ihre Anwendung mit Knoten und Kanten dar:

  • Knoten stellen die Dienste und Arbeitslasten Ihrer Anwendung dar:

    Topologie einer Beispielanwendung.

  • Edges stellen den Traffic Ihrer Anwendung zwischen Ihren Diensten und Arbeitslasten dar:

    Auf Kanten werden Latenz und Fehlerrate angezeigt.

Die Topologiekarte ist vollständig interaktiv. Sie können heran- und herauszoomen und Knoten verschieben, um die Beziehung zwischen Ihren Diensten und Arbeitslasten zu visualisieren. Wenn Sie auf einen Knoten oder eine Kante klicken, wird ein Bereich mit zusätzlichen Details zum Status des jeweiligen Knotens oder der jeweiligen Kante geöffnet.

Hinweise

Damit die Anwendungstopologiekarte generiert werden kann, müssen Ihre Tracedaten anwendungsspezifische Labels enthalten. Diese Labels sind nur verfügbar, wenn Sie Ihre App mit OpenTelemetry instrumentieren, Ihre Trace-Daten an die Telemetry API senden und Ihre Anwendung bei App Hub registrieren.

Führen Sie zuerst die folgenden Schritte aus:

  1. Konfigurieren Sie das Anwendungsmonitoring wie unter Anwendungsmonitoring einrichten beschrieben. Die Einrichtung für das Anwendungsmonitoring umfasst die Konfiguration des Standard-Tracebereichs, um alle Projekte aufzulisten, in denen Ihre Tracedaten gespeichert sind.
  2. Wenn Sie einen für Anwendungen aktivierten Ordner verwenden, hat Ihr Projekt standardmäßig eine Richtlinie zur Einschränkung der Dienstnutzung, die die Verwendung der App Topology API verhindert. Um dieses Problem zu beheben, muss jemand mit der Rolle Administrator für Unternehmensrichtlinien apptopology.googleapis.com der Zulassungsliste für die Richtlinie für das Projekt zur Verwaltung von Ordnern mit aktivierten Apps hinzufügen. Beachten Sie, dass möglicherweise auch eine Richtlinie auf Organisationsebene vorhanden ist. Weitere Informationen finden Sie unter Ressourcennutzung einschränken.

  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

    Wenn Sie Ihrem Trace-Bereich andere Projekte hinzugefügt haben, empfehlen wir, die Observability API auch für diese Projekte zu aktivieren. In der Karte der Anwendungstopologie werden nur Trace-Kanten aus Projekten mit Trace-Bereich angezeigt, die sich in derselben Organisation wie Ihr App Hub-Projekt befinden.

  4. Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle App Topology Viewer (roles/apptopology.viewer) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen der Anwendungstopologie benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

    Diese vordefinierte Rolle enthält die Berechtigungen, die zum Aufrufen der Anwendungstopologie erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

    Erforderliche Berechtigungen

    Die folgenden Berechtigungen sind erforderlich, um die Anwendungstopologie aufzurufen:

    • So generieren Sie eine Topologie: apptopology.applicationTopologies.generate

    Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

  5. Instrumentieren Sie Ihre Anwendung für die Verwendung von OpenTelemetry und senden Sie Ihre Trace-Daten an den OTLP-Endpunkt.

Topologiekarte ansehen

  1. Rufen Sie in der Google Cloud Console die Seite Anwendungsmonitoring auf:

    Zu Anwendungsmonitoring

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

  2. Wählen Sie in der Projektauswahl der Google Cloud Console Ihr App Hub-Hostprojekt oder Ihr Verwaltungsprojekt aus.

  3. Wählen Sie eine Anwendung aus der Liste aus.

  4. Klicken Sie auf den Tab Topologie. Die Topologiekarte für Ihre Anwendung wird angezeigt.

Die Topologiekarte ist vollständig interaktiv. Sie können heran- und herauszoomen und Knoten verschieben, um die Beziehung zwischen Ihren Diensten und Arbeitslasten zu visualisieren. Sie können sich auch Details zu einem Knoten oder einer Kante ansehen:

  • Wählen Sie den Knoten aus, um offene Benachrichtigungen oder Attribute für einen Dienst oder eine Arbeitslast aufzurufen.
  • Wenn Sie die Latenz und die Fehlerrate zwischen zwei Knoten aufrufen möchten, wählen Sie die Kante aus.

Fehlerbehebung

Informationen, die Ihnen helfen können, zu verstehen, warum in der Anwendungstopologiekarte keine Daten angezeigt werden, finden Sie unter Fehlerbehebung bei Application Monitoring.