Fehlerbehebung beim Anwendungsmonitoring

In diesem Dokument finden Sie Informationen dazu, welche Daten auf der Seite Anwendungsüberwachung 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 aufrufen können.

Bekannte Probleme

In diesem Abschnitt werden bekannte Probleme im Zusammenhang mit der Anwendungsüberwachung aufgeführt:

  • Die Trace-Latenz ist im Anwendungsmonitoring nicht verfügbar. Sie müssen die Seite Trace-Explorer verwenden, um Ihre Trace-Daten aufzurufen. Weitere Informationen finden Sie unter Traces suchen und analysieren.

Fehlerbehebung

In diesem Abschnitt wird beschrieben, wie Sie Probleme im Zusammenhang mit der Anwendungsüberwachung beheben.

Sie werden aufgefordert, eine Anwendung zu erstellen.

Sie öffnen in der Google Cloud Console die Seite Anwendungsüberwachung und sehen die Meldung „Erstellen Sie eine Anwendung, um loszulegen“. Sie sollten diese Meldung nicht sehen, da Sie eine App Hub-Anwendung registriert haben.

Um diesen Fehler zu beheben, muss die Ressourcenauswahl auf Ihr App Hub-Hostprojekt oder das Verwaltungsprojekt für Ihren Ordner für Anwendungen festgelegt sein.

Ihre App enthält keine Daten für einige Goldene Signale

Es kann verschiedene Gründe dafür geben, dass Sie keinen Wert für ein Goldenes Signal sehen:

  • Der Messwerttyp wird von der Infrastruktur nicht unterstützt. Netzwerk-Load Balancer unterstützen beispielsweise keine Systemmesswerte. Weitere Informationen finden Sie unter Vom App Hub unterstützte Ressourcen.

  • 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 für die Golden Signals keine Daten zu sehen.

Eine Liste der Ressourcen, die App Hub-Labels generieren, finden Sie unter Vom App Hub unterstützte Ressourcen.

Die Messwertdaten Ihrer Anwendung fehlen oder sind unvollständig.

In einem Diagramm für einen Dienst oder eine Arbeitslast werden entweder keine Messwertdaten oder einige Daten fehlen.

Möglicherweise müssen Sie nichts unternehmen. Die Diagramme, die dem vordefinierten Dashboard für einen Dienst oder eine Arbeitslast hinzugefügt werden, werden basierend auf den von diesem Dienst oder dieser Arbeitslast verwendeten Ressourcen ausgewählt. Bei einigen Ressourcen werden jedoch möglicherweise keine Daten für einen bestimmten Messwerttyp generiert. Eine Liste der Ressourcen, die App Hub-Labels generieren, finden Sie unter Vom App Hub unterstützte Ressourcen.

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

  1. Achten Sie darauf, dass in der Projektauswahl Ihr App Hub-Hostprojekt oder das Verwaltungsprojekt für den für Anwendungen aktivierten Ordner festgelegt ist.

  2. Der Administrator der Organisation muss den Messwertbereich für Ihr App Hub-Hostprojekt oder das Verwaltungsprojekt für Ihren Ordner für Anwendungen so konfiguriert haben, dass die Projekte aufgelistet werden, in denen die Messwertdaten Ihrer Anwendung gespeichert werden. Weitere Informationen finden Sie unter Anwendungsüberwachung einrichten.

Die Protokolldaten Ihrer Anwendung fehlen oder sind unvollständig.

Im Bereich „Protokolle“ eines Dashboards werden keine oder 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 Protokolldaten benötigen:

    • Loganzeige (roles/logging.viewer) im App Hub-Hostprojekt oder im Verwaltungsprojekt für den app-fähigen Ordner und alle anderen Projekte, für die der Standardlogbereich angegeben ist Diese Rolle gewährt Zugriff auf die meisten Logeinträge im _Default-Log-Bucket. Weitere Informationen finden Sie unter Rollen für die Protokollierung.
    • Zugriffsberechtigter für Logbetrachtung (roles/logging.viewAccessor) für die Logansichten, die im Standardlogbereich Ihres App Hub-Hostprojekts oder des Verwaltungsprojekts für Ihren App-fähigen Ordner aufgeführt sind. Weitere Informationen zum Gewähren des Zugriffs auf eine Logansicht finden Sie unter Zugriff auf eine Logansicht steuern.

  2. Der Administrator der Organisation muss den Standard-Log-Umfang Ihres App Hub-Hostprojekts oder des Verwaltungsprojekts für Ihren App-fähigen Ordner so konfiguriert haben, dass die Ressourcen aufgeführt werden, in denen die Protokolldaten Ihrer Anwendung gespeichert werden. Weitere Informationen finden Sie unter Anwendungsüberwachung einrichten.

Ihre Benachrichtigungsrichtlinien fehlen

Damit eine Benachrichtigungsrichtlinie in einem Dashboard für das Anwendungsmonitoring angezeigt wird, müssen Sie sie mit einem Dienst oder einer Arbeitslast verknüpfen. Fügen Sie dazu der Richtlinie bestimmte Labels hinzu.

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

  1. Rufen Sie in der Google Cloud Console die Seite  Benachrichtigungen 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 den appfähigen Ordner aus.
  3. Suchen Sie die Benachrichtigungsrichtlinie, klicken Sie auf  Mehr anzeigen, wählen Sie Bearbeiten aus und gehen Sie dann zum Bereich Benachrichtigungen und Name.
  4. Wählen Sie im Bereich Anwendungslabels Ihre Anwendung und dann Ihre Arbeitslast oder Ihren Dienst aus.
  5. Klicken Sie auf Richtlinie speichern.

Nachdem Sie diese Schritte ausgeführt haben, werden Labels mit den folgenden Schlüsseln an Ihre Benachrichtigungsrichtlinie angehängt. Mit diesen Labels werden Ihre Anwendung und Ihr Dienst oder Ihre Arbeitslast identifiziert:

  • 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. Hier finden Sie weitere Informationen:

Sie haben Ihrer Benachrichtigungsrichtlinie Anwendungslabels hinzugefügt, die Richtlinie wird aber 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 unternehmen.

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

Sie können keine Änderungen am angezeigten Dashboard speichern.

Sie analysieren Daten in einem Dashboard für Dienste oder Arbeitslasten 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 für das aktuelle Dashboard speichern.

Die Schaltfläche Im Dashboard speichern wird nur angezeigt, wenn das Dashboard, das Sie sich ansehen, nur lesend geöffnet ist. Mit dieser Schaltfläche können Sie Ihre Änderungen jedoch in einem benutzerdefinierten Dashboard speichern. Weitere Informationen finden Sie unter Dashboards – Übersicht.

Das Diagramm kann nicht gespeichert werden

Wenn Sie Telemetriedaten untersuchen, ist die Schaltfläche In 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 App-fähigen 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 Einführung 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 und einige offene Vorfälle nicht geschlossen werden. Bei Richtlinien für fehlende Messwerte werden Sie beispielsweise benachrichtigt, wenn die Änderung der Labels dazu führt, dass für eine beobachtete Zeitreihe keine Daten mehr erfasst werden.

Sie müssen nichts unternehmen. Vorfälle werden automatisch geschlossen, wenn keine Daten mehr eingehen, nachdem die Dauer für die automatische Schließung abgelaufen ist. Weitere Informationen finden Sie unter Teilweise Messwertdaten.

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

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

Das ist so gewollt. Wenn Sie einen Ordner mit aktivierter App auswählen und dann eine Google Cloud Observability-Seite aufrufen, wird die ausgewählte Ressource auf das Verwaltungsprojekt des Ordners zurückgesetzt. Normalerweise sollte das Projekt ausgewählt sein, wenn Sie die Telemetriedaten für eine Anwendung aufrufen möchten.

Wenn Sie auf die Protokolle im App-Ordner zugreifen möchten, wählen Sie den Ordner manuell in der Ressourcenauswahl aus.