Fehlerbehebung beim Anwendungsmonitoring

Dieses Dokument enthält Informationen dazu, welche Daten auf der Seite Anwendungsmonitoring angezeigt werden. Außerdem enthält es Informationen, die Ihnen bei der Konfiguration Ihres Google Cloud Projekts helfen können, damit Sie die Daten Ihrer Anwendung anzeigen können.

Bekannte Probleme

In diesem Abschnitt werden bekannte Probleme im Zusammenhang mit dem Anwendungsmonitoring aufgeführt:

  • Für die folgenden Ressourcen werden in der Topologiekarte nur Kanten angezeigt, wenn der entsprechende Dienst oder die entsprechende Arbeitslast den App Hub-Registrierungsstatus discovered hat:

    • Firestore-Ressourcen
    • Spanner-Ressourcen
    • Cloud Storage-Ressourcen
    • Google Cloud MCP-Server

    Ein Dienst oder eine Arbeitslast hat den Registrierungsstatus discovered, wenn er oder sie Teil der Anwendungsverwaltungsgrenze ist, aber nicht für eine Anwendung registriert ist.

Fehlerbehebung

In diesem Abschnitt wird beschrieben, wie Sie Probleme im Zusammenhang mit dem Anwendungsmonitoring beheben.

Sie werden aufgefordert, eine Anwendung zu erstellen

Sie öffnen in der Google Cloud Console die Seite Anwendungsmonitoring und sehen die Meldung „Create an Application to get started“ (Erstellen Sie eine Anwendung, um zu beginnen). Sie erwarten diese Meldung nicht, da Sie eine App Hub-Anwendungregistriert haben.

Prüfen Sie, ob die Ressourcenauswahl auf Ihr App Hub-Hostprojekt oder das Verwaltungsprojekt für Ihren für Apps aktivierten Ordner festgelegt ist, um diesen Fehler zu beheben.

Für einige Golden Signals werden keine Daten für Ihre Anwendung angezeigt

Es gibt mehrere Gründe, warum Sie keinen Wert für ein Golden Signal sehen:

  • Die Infrastruktur unterstützt den Messwerttyp nicht. Network Load Balancer unterstützen beispielsweise keine Systemmesswerte. Weitere Informationen finden Sie unter Unterstützte Dienste und Arbeitslasten für das Anwendungsmonitoring.

  • Der Messwerttyp wird unterstützt, aber es sind keine Daten verfügbar. Wenn der Zeitraum beispielsweise auf ein Intervall festgelegt ist, in dem keine Messwertdaten erfasst wurden, sind keine Daten für die Golden Signals verfügbar.

Eine Liste der Ressourcen, die App Hub-Labels generieren, finden Sie unter Unterstützte Dienste und Arbeitslasten für das Anwendungsmonitoring.

Die Messwertdaten Ihrer Anwendung fehlen oder sind unvollständig

Sie sehen sich ein Diagramm für einen Dienst oder eine Arbeitslast an. Dieses Diagramm enthält entweder keine Messwertdaten oder einige Daten fehlen.

Möglicherweise müssen Sie nichts tun. Die Diagramme, die dem vordefinierten Dashboard für einen Dienst oder eine Arbeitslast hinzugefügt werden, werden basierend auf den Ressourcen ausgewählt, die von diesem Dienst oder dieser Arbeitslast verwendet werden. Einige Ressourcen generieren jedoch möglicherweise keine Daten für einen bestimmten Messwerttyp. Eine Liste der Ressourcen, die App Hub-Labels generieren, finden Sie unter Unterstützte Dienste und Arbeitslasten für das Anwendungsmonitoring.

Wenn die Messwertdaten unvollständig sind, gehen Sie so vor:

  1. Prüfen Sie, ob die Projektauswahl auf Ihr App Hub-Hostprojekt oder das Verwaltungsprojekt für Ihren für Apps aktivierten Ordner festgelegt ist.

  2. Prüfen Sie, ob der Organisationsadministrator den Messwertbereich für Ihr App Hub-Hostprojekt oder das Verwaltungsprojekt für Ihren für Apps aktivierten Ordner so konfiguriert hat, dass die Projekte aufgeführt werden, in denen die Messwertdaten Ihrer Anwendung gespeichert sind. Weitere Informationen finden Sie unter Anwendungsmonitoring einrichten.

Die Logdaten Ihrer Anwendung fehlen oder sind unvollständig

Im Logbereich eines Dashboards werden keine Logeinträge angezeigt oder es werden nicht alle Logeinträge angezeigt, die von Ihrer Anwendung generiert werden.

So beheben Sie diesen Fehler:

  1. Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen von Logdaten benötigen:

    • Logs Viewer (roles/logging.viewer) für Ihr App Hub-Hostprojekt oder das Verwaltungsprojekt für Ihren für Apps aktivierten Ordner und alle anderen Projekte, die im Standard-Logbereich aufgeführt sind. Diese Rolle gewährt Zugriff auf die meisten Logeinträge im _Default Log-Bucket. Weitere Informationen finden Sie unter Logging-Rollen.
    • Logs View Accessor (roles/logging.viewAccessor) für die Logansichten, die im Standard-Logbereich Ihres App Hub-Hostprojekts oder des Verwaltungsprojekts für Ihren für Apps aktivierten Ordner aufgeführt sind. Weitere Informationen zum Gewähren des Zugriffs auf eine Logansicht finden Sie unter Zugriff auf eine Logansicht steuern.

  2. Prüfen Sie, ob der Organisationsadministrator den Standard-Logbereich Ihres App Hub-Hostprojekts oder des Verwaltungsprojekts für Ihren für Apps aktivierten Ordner so konfiguriert hat, dass die Ressourcen aufgeführt werden, in denen die Logdaten Ihrer Anwendung gespeichert sind. Weitere Informationen finden Sie unter Anwendungsmonitoring einrichten.

Ihre Benachrichtigungsrichtlinien fehlen

Für registrierte Dienste und Arbeitslasten werden in Dashboards und in der Topologiekarte nur Vorfälle angezeigt, wenn die entsprechende Benachrichtigungsrichtlinie anwendungsspezifische Labels enthält. Diese Labels fügen Sie der Richtlinie hinzu. Für erkannte Dienste und Arbeitslasten werden in der Topologiekarte Vorfälle angezeigt, indem Ressourcenlabels gefiltert werden.

So verknüpfen Sie eine Benachrichtigungsrichtlinie mit einer Arbeitslast oder einem Dienst über die Console Google Cloud :

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

    Zu Benachrichtigungen

    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 Symbolleiste der Google Cloud Console Ihr App Hub-Hostprojekt oder das Verwaltungsprojekt für Ihren für Apps aktivierten Ordner aus.
  3. Suchen Sie die Benachrichtigungsrichtlinie, klicken Sie auf Mehr ansehen, wählen Sie Bearbeiten aus. Rufen Sie dann den Abschnitt Benachrichtigungen und Name auf.

  4. Wählen Sie im Abschnitt Anwendungslabels Ihre Anwendung und dann Ihren Dienst oder Ihre Arbeitslast aus:

    Auf der Seite „Benachrichtigungsrichtlinie“ wird gezeigt, wie eine Benachrichtigungsrichtlinie mit App Hub-Labels verknüpft wird.

  5. Klicken Sie auf Richtlinie speichern.

Nachdem Sie diese Schritte ausgeführt haben, werden Ihrer Benachrichtigungsrichtlinie Labels mit den folgenden Schlüsseln angehängt. Diese Labels identifizieren Ihre Anwendung und Ihren Dienst oder Ihre Arbeitslast:

  • apphub_application_location
  • apphub_application_id
  • apphub_service_id oder apphub_workload_id

Sie können einer Benachrichtigungsrichtlinie auch Nutzerlabels hinzufügen. Verwenden Sie dazu die Google Cloud CLI, Terraform oder die Cloud Monitoring API. Sie müssen jedoch die im vorherigen Beispiel gezeigten Labelschlüssel verwenden. Weitere Informationen finden Sie unter:

Sie haben Ihrer Benachrichtigungsrichtlinie Anwendungslabels hinzugefügt, aber die Richtlinie wird nicht aufgeführt

Prüfen Sie, ob die Richtlinie die folgenden Labels enthält, um diesen Fehler zu beheben:

  • apphub_application_location
  • apphub_application_id
  • apphub_service_id oder apphub_workload_id

Die Dashboards für Ihre Dienste und Arbeitslasten unterscheiden sich

Sie müssen nichts tun.

Die Ressourcen, die von einem Dienst oder einer Arbeitslast verwendet werden, bestimmen, welche Daten für diesen Dienst oder diese Arbeitslast angezeigt werden.

Sie können keine Änderungen am angezeigten Dashboard speichern

Sie untersuchen Daten, die in einem Dashboard für einen Dienst oder eine Arbeitslast angezeigt werden, und möchten Ihre Änderungen speichern. In der Symbolleiste wird die Schaltfläche Im Dashboard speichern angezeigt. Wenn Sie diese Schaltfläche auswählen, können Sie die Änderungen jedoch nicht in Ihrem aktuellen Dashboard speichern.

Die Schaltfläche Im Dashboard speichern wird nur angezeigt, wenn das angezeigte Dashboard schreibgeschützt ist. Sie können diese Schaltfläche jedoch verwenden, um Ihre Änderungen in einem benutzerdefinierten Dashboard zu speichern. Weitere Informationen finden Sie unter Dashboards – Übersicht.

Sie können Ihr Diagramm nicht speichern

Wenn Sie Telemetriedaten untersuchen, ist die Schaltfläche Im Dashboard speichern in der Symbolleiste deaktiviert.

Prüfen Sie, ob Sie ausreichende Berechtigungen haben, um diesen Fehler zu beheben.

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Monitoring Editor (roles/monitoring.editor) für Ihr App Hub-Hostprojekt oder das Verwaltungsprojekt für Ihren für Anwendungsverwaltung konfigurierten Ordner zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Speichern von Änderungen an einem benutzerdefinierten Dashboard benötigen.

Unerwartete Vorfälle werden geöffnet

Mit der Veröffentlichung des Anwendungsmonitorings wurde das Label metadata.system_labels.apphub_host_project_id in metadata.system_labels.apphub_application_container umbenannt. Diese Änderung kann dazu führen, dass einige neue Vorfälle generiert werden und einige offene Vorfälle nicht geschlossen werden. Bei Richtlinien für fehlende Messwerte werden Sie beispielsweise möglicherweise benachrichtigt, da die Änderung der Labels dazu führen kann, dass in einer überwachten Zeitreihe keine Stichproben mehr gemeldet werden.

Sie müssen nichts tun. Vorfälle werden automatisch geschlossen, wenn nach Ablauf der automatischen Schließungsdauer keine Daten mehr eingehen. Weitere Informationen finden Sie unter Teilweise Messwertdaten.

Sie können nicht auf die Logs in Ihrem für Apps aktivierten Ordner zugreifen

Sie haben in der Google Cloud Console mit der Ressource auswahl einen für Apps aktivierten Ordner ausgewählt. Wenn Sie dann eine Google Cloud Observability-Seite wie die Seite Log-Explorer öffnen, wird die Ressourcenauswahl auf ein Projekt zurückgesetzt.

Das ist beabsichtigt. Wenn Sie einen für Apps aktivierten Ordner ausgewählt haben und dann auf eine Google Cloud Observability-Seite zugreifen, wird die ausgewählte Ressource auf das Verwaltungsprojekt des Ordners zurückgesetzt. Normalerweise möchten Sie das Projekt auswählen, wenn Sie die Telemetriedaten für eine Anwendung aufrufen möchten.

Wenn Sie auf die Logs im für Apps aktivierten Ordner zugreifen möchten, wählen Sie den Ordner manuell mit der Ressourcenauswahl aus.

In der Topologiekarte Ihrer Anwendung werden keine Kanten angezeigt

Sie können Ihre Anwendungsdienste und Arbeitslasten in der Topologiekarte des Anwendungsmonitorings visualisiert sehen, aber es werden keine Kanten angezeigt, die sie miteinander verbinden. Möglicherweise wird auch eine Meldung wie „No trace connections detected for the topology graph.“ (Für das Topologiediagramm wurden keine Trace-Verbindungen erkannt.) angezeigt. Instrumentieren Sie für Trace, um die vollständige Topologie zu nutzen.

Kanten in der Topologiekarte stellen Traffic in Ihrer Anwendung dar und werden aus Daten von Cloud Trace generiert. Versuchen Sie Folgendes, um dieses Problem zu beheben:

  1. Konfigurieren Sie Ihre Anwendung für die Verwendung von Trace:

  2. Prüfen Sie, ob Sie den Standard-Trace-Bereich konfiguriert und festgelegt haben. Weitere Informationen finden Sie unter Anwendungsmonitoring einrichten.

  3. Prüfen Sie, ob die Trace-Spans Ihrer Anwendung mit anwendungsspezifischen Ressourcenattributen gekennzeichnet sind. Weitere Informationen finden Sie unter Trace-Spans Anwendungsattribute hinzufügen.