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 Anwendungstopologiekarte 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.

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

    Auf den 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. Klicken Sie auf den Knoten oder die Kante, um ein Feld mit zusätzlichen Details zum Status eines bestimmten Knotens oder einer bestimmten Kante zu öffnen.

Hinweis

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 Tracedaten an die Telemetry API senden und Ihre Anwendung bei App Hub registrieren.

So legen Sie los:

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

  3. Aktivieren Sie die Observability API, App Topology API, Cloud Trace API und Telemetry API.

    Rollen, die zum Aktivieren von APIs erforderlich sind

    Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin), die die Berechtigung serviceusage.services.enable enthält. Weitere Informationen zum Zuweisen von Rollen.

    APIs aktivieren

    Wenn Sie Ihrem Tracebereich andere Projekte hinzugefügt haben, empfehlen wir, die Observability API auch für diese Projekte zu aktivieren. Auf der Anwendungstopologiekarte werden nur Tracekanten aus Tracebereich Projekten 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, die erforderlich sind:

    Erforderliche Berechtigungen

    Die folgenden Berechtigungen sind erforderlich, um die Anwendungstopologie aufzurufen:

    • Zum Generieren der Topologie: apptopology.applicationTopologies.generate

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

  5. Instrumentieren Sie Ihre Anwendung so, dass OpenTelemetry verwendet wird und Ihre Tracedaten an den OTLP-Endpunkt gesendet werden.

Topologiekarte aufrufen

  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, wählen Sie Ihr App Hub Hostprojekt oder 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 auch Details zu einem Knoten oder einer Kante aufrufen:

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

Fehlerbehebung

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