Fehlerbehebung bei Diagrammen

Wenn Sie Fehlermeldungen oder unerwartete Ergebnisse in Diagrammen und Dashboard-Widgets in Cloud Monitoring beheben möchten, können Sie Ihre Abfragen, Ausrichtungszeiträume und Berechtigungen anpassen, damit Ihre Telemetriedaten korrekt dargestellt werden. In diesem Dokument erfahren Sie, wie Sie häufige Probleme im Metrics Explorer und in benutzerdefinierten Dashboards diagnostizieren, z. B. Datenlücken, Anzeigebeschränkungen für Zeitreihen, nicht übereinstimmende Einheiten auf der Y-Achse und Fehler bei der Widget-Konfiguration.

Diagrammfehler

In diesem Abschnitt werden Fehler beschrieben, die beim Konfigurieren eines Diagramms auftreten können. Sie können Diagramme mit dem Metrics Explorer konfigurieren oder sie einem Dashboard hinzufügen.

Lücken in Diagrammdaten

Diagramme weisen gelegentlich Lücken in den Daten auf. Folgender Screenshot zeigt dieses Verhalten für den Messwert loadbalancing.googleapis.com/https/total_latencies:

Beispiel für ein Diagramm mit Wertelücken.

Lücken in den Daten können auftreten, wenn Daten nur sehr selten geschrieben werden. Cloud Monitoring erfasst Messwerte durch Stichprobenerhebung. Bei sehr dünnbesetzten Daten sind möglicherweise keine Daten verfügbar, wenn eine Stichprobe erhoben wird. Lücken in Load-Balancer-Messwerten können beispielsweise auftreten, wenn die Anzahl der Anfragen 0,05 Abfragen pro Sekunde (QPS) oder weniger beträgt. Wenn die Abfragerate steigt, verschwinden die Lücken.

Sie können visuelle Lücken entfernen, indem Sie das Ausrichtungsintervall erhöhen. Wenn das System eine neue Zeitreihe mit regelmäßig verteilten Datenpunkten generiert, wird das Ausrichtungsintervall verwendet, um das Zeitfenster zu bestimmen, in dem Rohdatenpunkte kombiniert werden. Weitere Informationen finden Sie unter Ausrichtung: Regularisierung innerhalb einer Reihe.

Wenn Sie ein Mindestausrichtungsintervall festlegen möchten, bearbeiten Sie die Abfrage Ihres Diagramms. Wenn Sie beispielsweise den Metrics Explorer verwenden, rufen Sie den Abfragebereich auf und wählen Sie Abfrageelement hinzufügen aus. Wählen Sie im Menü Min. Intervall und dann ein Zeitintervall aus.

Der Ausrichtungszeitraum ändert sich, wenn der Zeitraum geändert wird.

Sie fügen einem Dashboard ein Diagramm hinzu. Wenn Sie den Zeitraum des Dashboards oder des Diagramms ändern, ändert sich manchmal der Ausrichtungszeitraum. Wenn Sie beispielsweise den Zeitraum von einer Stunde auf zwei Stunden ändern, wird der Ausrichtungszeitraum als 1 minute interval aufgeführt. Wenn Sie jedoch den Zeitraum von einer Stunde auf einen Tag ändern, wird der Ausrichtungszeitraum als 5 minute interval aufgeführt.

Dieses Verhalten ist so vorgesehen.

Die Anzahl der Datenpunkte, die in Diagrammen angezeigt werden können, ist begrenzt. Wenn die Anzahl der für den ausgewählten Zeitraum verfügbaren Datenpunkte größer als das Anzeigelimit ist, ändert Monitoring daher automatisch die Ausrichtungseinstellungen, um die Anzahl der anzuzeigenden Datenpunkte zu reduzieren.

Im Diagramm werden nicht alle Zeitreihen angezeigt

Sie konfigurieren ein Diagramm, aber es werden nicht alle Zeitreihen angezeigt.

Aus Leistungsgründen sind Diagramme so konfiguriert, dass maximal 50 Zeitreihen angezeigt werden.

Wenn Sie ein Diagramm konfigurieren und mehr als 50 Zeitreihen verfügbar sind, wird die Anzahl der angezeigten Zeitreihen im Diagramm begrenzt und der Symbolleiste ein Symbol mit einem roten Punkt hinzugefügt. In der Kurzinfo für das Symbol wird die folgende Meldung angezeigt:

To improve performance, we've limited the time series displayed in this chart.

Wenn Sie alle Zeitreihen anzeigen möchten, maximieren Sie die Kurzinfo und wählen Sie den Button Alle Zeitreihen anzeigen aus.

Im Diagramm werden keine Daten angezeigt

Sie konfigurieren ein Diagramm, aber es wird eine Fehlermeldung anstelle von Daten angezeigt:

  • Wenn für den für Ihr Diagramm angegebenen Zeitraum keine Daten verfügbar sind, wird die folgende Meldung angezeigt:

    No data is available for the selected time frame.

    Versuchen Sie Folgendes, um das Problem zu beheben:

    • Vergrößern Sie den Zeitraum für das Diagramm. Einige Messwerttypen, z. B. solche, die die Kontingentnutzung melden, liefern nur eine Stichprobe pro Tag.

    • Ändern Sie den ausgewählten Messwerttyp für Ihr Diagramm. Möglicherweise ist der von Ihrem Diagramm angegebene Messwerttyp inaktiv. Ein Messwerttyp ist inaktiv, wenn es keine Zeitreihen für den Typ gibt.

  • Wenn der in der Abfrage angegebene Messwerttyp oder Ressourcentyp nicht erkannt wird, wird die folgende Meldung angezeigt:

    An error occurred requested data. One or more resources could not be found.

    Versuchen Sie Folgendes, um dieses Problem zu beheben:

    • Prüfen Sie, ob der in der Abfrage angegebene Messwerttyp und Ressourcentyp definiert sind. Sie können die menügesteuerte Oberfläche für Diagramme verwenden, um nach dem Messwerttyp zu suchen.

    • Prüfen Sie die Schreibweise des Messwert- und Ressourcentyps in der Abfrage.

Im Diagramm wird eine Warnung zu sensiblen Metadaten angezeigt

Sie öffnen ein benutzerdefiniertes Dashboard und erwarten, dass alle Widgets Daten anzeigen. In einem oder mehreren Widgets, die SQL-Abfragen enthalten, werden jedoch Meldungen wie die folgenden angezeigt:

This SQL query is configured to run on the BigQuery engine using [PROJECT_ID],
and references resources from [RESOURCE, ...]. Sensitive metadata,
including table contents, may be written to [PROJECT_ID].

Die Warnmeldung weist darauf hin, dass die Abfrage die Eigentumsgrenzen überschreitet, und bietet Ihnen die Möglichkeit, die Abfrage vor der Ausführung zu überprüfen. Die Eigentumsgrenzen werden durch mehrere Faktoren bestimmt, darunter die Hierarchie der von der Abfrage verwendeten Ressourcen.

Das System führt bei jedem Öffnen eines Dashboards Grenzprüfungen durch. Sie können diese Warnungen nicht verhindern oder schließen.

Wenn in einem Widget die Warnmeldung angezeigt wird, haben Sie folgende Möglichkeiten:

  • Wenn Sie wissen, dass die Abfrage sicher ausgeführt werden kann, und Sie die Abfrageergebnisse sehen möchten, klicken Sie auf Bestätigen und ausführen.

  • Ignorieren Sie die Fehlermeldung. In diesem Widget werden keine Daten für deine aktuelle Sitzung angezeigt.

  • Analysieren Sie die Abfrage und deaktivieren Sie sie gegebenenfalls. Sie können beispielsweise Folgendes tun:

    1. Prüfen Sie die Abfrage und die abgefragten Daten.
    2. Sehen Sie sich den Verlauf des Dashboards an, um festzustellen, wer das Widget wann hinzugefügt hat.
    3. Wenn Sie einen Dashboard-Link erhalten haben, prüfen Sie, ob der Absender eine vertrauenswürdige Quelle ist.
    4. Speichern Sie Ihre Analyse zur späteren Verwendung im Dashboard, indem Sie ein Text-Widget hinzufügen.

Google Cloud bietet einige Funktionen, mit denen Sie die Daten-Exfiltration durch Phishing, Insider-Angriffe oder externe Entitäten verhindern können. Weitere Informationen finden Sie unter Datensicherheit mit Observability Analytics.

Diagramm mit mehreren Messwerten zeigt eine Fehlermeldung an

Sie konfigurieren ein Diagramm so, dass mehrere Messwerte angezeigt werden, und im Diagramm wird die folgende Fehlermeldung angezeigt:

    The units for queries using the same Y-axis must be the same for the chart
    to render correctly.

In Diagrammen können mehrere Messwerttypen dargestellt werden. Sie können einen Messwerttyp entweder der linken oder der rechten Y-Achse zuordnen. Die Einheiten aller Messwerttypen, die der linken Y-Achse zugeordnet sind, müssen identisch sein. Andernfalls wird die vorherige Fehlermeldung angezeigt. Ebenso müssen die Einheiten aller Messwerttypen, die der rechten Y-Achse zugeordnet sind, identisch sein. Andernfalls wird die vorherige Fehlermeldung angezeigt.

So beheben Sie diesen Fehler:

  1. Wenn Ihr Diagramm Messwerte mit mehr als zwei Einheitentypen enthält, entfernen Sie Messwerte, bis Sie nur noch zwei Einheitentypen haben.

  2. Weisen Sie alle Messwerte mit dem einen Einheitstyp der linken Y-Achse und alle Messwerte mit dem anderen Einheitentyp der rechten Y-Achse zu.

Diagramm mit mehreren Messwerten zeigt unerwartete Daten an

Ein Diagramm ist so konfiguriert, dass mehrere Messwerte angezeigt werden, und es wurden Filter hinzugefügt, um nur bestimmte Zeitachsen anzuzeigen. Das Diagramm zeigt jedoch Zeitachsen an, die den Filtern nicht genügen.

Um dieses Problem zu beheben, wenden Sie die Filter auf alle im Diagramm aufgeführten Messwert an.

Der folgende Screenshot zeigt beispielsweise den Konfigurationsbereich des Metrics Explorer für ein Diagramm, in dem die Anzahl der von VM-Instanzen gelesenen und geschriebenen Bytes angezeigt wird:

Beispiel für den Metrics Explorer mit zwei Messwerttypen

Im Screenshot gibt es für jeden Messwerttyp, der im Diagramm angezeigt wird, eine Überschrift.

Wenn Sie beispielsweise möchten, dass im Diagramm nur Zeitreihen für VMs in der Zone us-central1-a angezeigt werden, fügen Sie jeder Abfrage den Filter zone = us-central1-a hinzu.

Filterwerte für PromQL-definierte Diagramme können nicht ausgewählt werden

Sie erstellen Diagramme in einem benutzerdefinierten Dashboard und konfigurieren diese Diagramme mit PromQL. Anschließend erstellen Sie dauerhafte Dashboard-Filter. Wenn Sie das Dashboard aufrufen, versuchen Sie, den Standardwert des Filters zu ändern, aber das Menü mit den Labelwerten wird nicht angezeigt oder ist nicht korrekt:

Werte für einen dashboardweiten Filter werden nicht geladen.

Geben Sie den Filterwert ein und wählen Sie dann Übernehmen aus, um dieses Problem zu beheben. Wenn der Filterschlüssel beispielsweise zone ist, können Sie us-central1-a eingeben.

Labels für Nutzermetadaten fehlen in Filter- oder Gruppierungsmenüs

Sie konfigurieren ein Diagramm über Menüs. In den Menüs Filter und Aggregation werden jedoch keine Nutzermetadatenlabels wie goog-dataproc-* oder dataflow-* aufgeführt.

Wenn Sie Zeitreihen filtern oder gruppieren möchten, wenn keine Nutzermetadatenlabels in den Menüs angezeigt werden, fragen Sie die Zeitreihen mit PromQL oder dem direkten Filtermodus ab:

  • Stellen Sie in PromQL dem Schlüssel des Nutzermetadatenlabels metadata_user_ voran und setzen Sie den Schlüssel in doppelte Anführungszeichen, wenn er Sonderzeichen wie Bindestriche enthält. Mit der folgenden PromQL-Abfrage wird beispielsweise die CPU-Auslastung von Compute Engine-VMs nach Zeitreihen gefiltert, die ein nicht leeres Nutzermetadatenlabel goog-dataproc-cluster-name haben:

    {"compute.googleapis.com/instance/cpu/utilization", monitored_resource="gce_instance", "metadata_user_goog-dataproc-cluster-name"!=""}

  • Im direkten Filtermodus nach metadata.user_labels filtern. Wenn Sie beispielsweise nach einem nicht leeren Nutzermetadatenlabel goog-dataproc-cluster-name filtern möchten, geben Sie metadata.user_labels."goog-dataproc-cluster-name"!="" ein.

Dashboard-Fehler

In diesem Abschnitt werden Fehler beschrieben, die beim Erstellen oder Bearbeiten von Dashboards auftreten können.

Dashboard-Erstellung schlägt fehl

Sie erstellen ein Dashboard mithilfe einer JSON- oder YAML-Beschreibung des Dashboards. Diese Beschreibung enthält ein name-Feld. Sie ändern den Anzeigenamen und versuchen, ein zweites Dashboard zu erstellen, erhalten aber eine Fehlermeldung. Wenn Sie beispielsweise die Google Cloud CLI verwenden, erhalten Sie den folgenden Fehler:

ERROR: (gcloud.alpha.monitoring.dashboards.create) Resource in projects [xxxxxxx] is the subject of a conflict: Requested entity already exists.

Die Ursache des Fehlers ist, dass die Dashboard-ID, die dieses Dashboard im Wert des Felds name identifiziert, bereits vorhanden ist. Daher kann das Dashboard nicht erstellt werden.

Wenn Sie beim Erstellen eines Dashboards das Feld name angeben, muss der angegebene Wert global eindeutig sein. Das Feld name hat die folgende Syntax:

"name": "projects/PROJECT_ID_OR_NUMBER/dashboards/DASHBOARD_ID"

Der Anzeigename muss nicht eindeutig sein.

Im Dashboard werden nicht alle Ereignisse angezeigt

Sie konfigurieren ein Dashboard zum Anzeigen von Ereignissen. Es werden jedoch nur die letzten Ereignisse angezeigt. Ältere Termine werden nicht angezeigt.

Führen Sie einen der folgenden Schritte aus, um das Problem zu lösen:

  • Verwenden Sie einen kürzeren Zeitraum. Sie können beispielsweise Daten für die letzte Stunde statt für den letzten Tag anzeigen lassen oder einen benutzerdefinierten Zeitraum auswählen.

  • Fügen Sie Filter hinzu.

Aus Leistungsgründen ist die Anzahl der Ereignisse, die auf Dashboards angezeigt werden können, begrenzt. Wenn diese Limits erreicht sind, werden in den Dashboards nur die neuesten Ereignisse angezeigt.

Das von Terraform erstellte Dashboard wird neu skaliert

Sie haben ein Dashboard mit Terraform erstellt und es dann über die Google Cloud Console bearbeitet. Sie haben erwartet, dass das Dashboard bis auf Ihre Änderungen unverändert bleibt. Stattdessen wird das Dashboard neu skaliert. Ihr Dashboard hatte beispielsweise 12 Spalten und hat jetzt 48 Spalten.

Verwenden Sie nicht die Google Cloud Console, um Dashboards zu bearbeiten, die mit Terraform erstellt wurden. Wenn das Dashboard bearbeitet wird, wird die Größe um den Faktor vier skaliert.

Widget für Benachrichtigungsrichtlinien zeigt keine Daten an

Ein Dashboard enthält ein Diagramm für eine Benachrichtigungsrichtlinie, aber im Diagramm werden keine Daten angezeigt.

Versuchen Sie Folgendes, um dieses Problem zu beheben:

  • Sehen Sie sich die Konfiguration des Diagramms an und prüfen Sie, ob eine Benachrichtigungsrichtlinie ausgewählt ist. Wenn keine Benachrichtigungsrichtlinie angezeigt wird, verknüpfen Sie das Diagramm mit einer Benachrichtigungsrichtlinie oder löschen Sie das Diagramm aus dem Dashboard.

    In Diagrammen auf Dashboards, in denen Daten für eine Benachrichtigungsrichtlinie angezeigt werden, werden keine Daten mehr angezeigt, wenn die referenzierte Benachrichtigungsrichtlinie gelöscht wird. Wenn Sie eine Benachrichtigungsrichtlinie löschen, werden Diagramme, die auf diese Richtlinie verweisen, nicht gelöscht.

  • Zeigen Sie die Details der Benachrichtigungsrichtlinie an und prüfen Sie, ob sie nur eine Bedingung enthält.

    In Diagrammen auf Dashboards, in denen Daten für eine Benachrichtigungsrichtlinie angezeigt werden, werden keine Daten mehr angezeigt, wenn die Benachrichtigungsrichtlinie so geändert wird, dass sie mehrere Bedingungen enthält. Verknüpfen Sie das Diagramm mit einer Benachrichtigungsrichtlinie mit einer einzelnen Bedingung oder löschen Sie das Diagramm aus dem Dashboard, um dieses Problem zu beheben.

  • Verlängern Sie den Zeitraum. Die Zeitraumauswahl muss auf einen Wert festgelegt werden, der länger als der Stichprobenzeitraum der Daten ist. Die meisten Messwerte werden alle 60 Sekunden abgerufen, einige jedoch nur selten. Der Messwert serviceruntime.googleapis.com/quota/limit wird beispielsweise alle 86.400 Sekunden (1 Tag) erfasst.

Im Bereich „Logs“ wird eine ungültige Abfrage gemeldet

Die Fehlermeldung „Fehler: Ungültige Abfrage“ wird angezeigt und im Logbereich werden keine Logeinträge angezeigt.

Reduzieren Sie die Anzahl der Projekte, deren Logs im Logbereich angezeigt werden, um dieses Problem zu beheben.

Weitere Informationen zu dieser Fehlerbedingung finden Sie unter Abfrage gibt einen Fehler zurück.

Log-Bereich meldet keine Einträge gefunden

In einem Logbereich wird die Fehlermeldung „Keine Einträge gefunden, die mit dem aktuellen Filter übereinstimmen“ angezeigt. Es gibt mehrere Gründe, warum Sie diese Nachricht sehen. Prüfen Sie Folgendes:

  • Für jedes Projekt, dessen Logeinträge Sie aufrufen möchten, muss eine der folgenden Bedingungen erfüllt sein:

    • Sie haben die Rolle Loganzeige (roles/logging.viewer).

    • Für benutzerdefinierte Rollen haben Sie die folgenden Berechtigungen:

      • logging.logs.list
      • logging.logServiceIndexes.list
      • logging.logServices.list

  • Achten Sie darauf, dass die Klauseln im Abfrageeditor nicht mit den Einstellungen im Logbereich in Konflikt stehen.

    Wenn das Feld Abfrageeditor beispielsweise severity=NOTICE enthält, werden im Logbereich alle Logs mit dem Schweregrad NOTICE abgerufen. Wenn das Menü Schweregrad im Logbereich auf „Warnung“ gesetzt ist, wird im Logbereich „Keine Einträge gefunden, die mit dem aktuellen Filter übereinstimmen“ angezeigt. Die Meldung wird angezeigt, weil keiner der abgerufenen Logeinträge mindestens den Schweregrad „Warnung“ hat.

    Wenn das Feld Abfrageeditor dagegen severity=WARNING enthält und das Menü Schweregrad für den Logbereich auf "Hinweis" festgelegt ist, werden möglicherweise Logeinträge angezeigt. Bei dieser Konfiguration ruft das Logbereich Logs ab, deren Schweregrad WARNING ist. Als Nächstes wird diese Liste von Logs so gefiltert, dass nur die Logs angezeigt werden, deren Schweregrad mindestens "Hinweis" ist. Alle abgerufenen Logs haben mindestens diesen Schweregrad.

Im Logbereich wird angezeigt, dass partielle Daten dargestellt werden

In einem Logbereich werden eine Warnanzeige und die Meldung "Es werden partielle Ergebnisse angezeigt" angezeigt.

Diese Anzeige wird eingeblendet, wenn Sie keine Berechtigung zum Aufrufen von Logs für ein Google Cloud Projekt haben, dessen Logs Sie anzeigen möchten. Führen Sie einen der folgenden Schritte aus, um den Warnanzeige zu entfernen:

  • Bitten Sie Ihren Systemadministrator, für jedes Google Cloud -Projekt, dessen Logs Sie aufrufen möchten, einen der folgenden Schritte auszuführen:

    • Ihnen die Rolle Loganzeige (roles/logging.viewer) zuweisen.

    • Weisen Sie für benutzerdefinierte Rollen die folgenden Berechtigungen zu:

      • logging.logs.list
      • logging.logServiceIndexes.list
      • logging.logServices.list

  • Ändern Sie die Konfiguration des Logbereichs so, dass nur Logs fürGoogle Cloud -Projekte angezeigt werden, für die Sie die Berechtigung zum Aufrufen von Logeinträgen haben.

Im Logbereich wird die Meldung „Berechtigung verweigert“ angezeigt

Im Logbereich-Widget auf einem Dashboard wird die folgende Meldung angezeigt, dass die Berechtigung verweigert wurde:

Error: Permission 'logging.views.access' denied on resource (or it may not exist).

So beheben Sie das Problem:

  1. Bearbeiten Sie das Widget für den Logbereich.

  2. Führen Sie einen der folgenden Schritte aus:

    • Setzen Sie das Menü Bereich nach auf Projekt und wählen Sie dann im Menü Projekte die Option Aktuelles Projekt aus.

    • Entfernen Sie aus dem Menü Speicheransichten die Logansichten, für die Sie keine Leseberechtigung haben. Informationen zu den IAM-Rollen, die für den Zugriff auf Logansichten erforderlich sind, finden Sie unter Zugriff auf eine Logansicht gewähren.

      Wenn das Widget für den Logbereich Logansichten durchsucht, müssen Sie die Berechtigung zum Lesen von Logeinträgen in allen aufgeführten Logansichten haben. Andernfalls wird eine Fehlermeldung angezeigt.

  3. Klicken Sie auf Übernehmen.

In der Tabelle werden nicht alle Zeitreihen angezeigt

Sie konfigurieren eine Tabelle, aber es werden nicht alle Zeitreihen angezeigt.

Aus Leistungsgründen sind Tabellen so konfiguriert, dass maximal 300 Zeilen angezeigt werden.

API-Aufruf zum Erstellen eines Dashboards mit einem Logbereich schlägt fehl

Es gibt mehrere Gründe, warum beim Erstellen eines Dashboards mit einem Logbereich eine Fehlermeldung angezeigt werden kann:

  • Wenn das Logfeld die Mindestanforderungen an Höhe oder Breite nicht erfüllt, wird der folgende Fehler angezeigt:

    Unable to save dashboard: Field mosaicLayout.tiles[0] has an invalid value: LogsPanel must have a minimum width of 3 and height of 3.

    Achten Sie zum Beheben dieses Fehlers darauf, dass in der JSON-Darstellung des Dashboards die Felder height und width des Logbereich-Widgets die Mindestanforderungen erfüllen.

  • Wenn das Feld logsPanel.filter mehr als 2.000 Zeichen enthält, wird der folgende Fehler angezeigt:

    Unable to save dashboard: filter cannot be greater than 2000 characters.

    Kürzen Sie den Filter, um dieses Problem zu beheben.

  • Wenn das Feld resourceNames fehlt, wird die folgende Fehlermeldung angezeigt:

    Unable to save dashboard: Dashboard is missing required field mosaicLayout.tiles[0].widget.logsPanel.resourceNames.

    Zur Behebung dieses Fehlers fügen Sie der Dashboard-JSON ein Feld resourceNames hinzu.

  • Wenn die Syntax für das Feld resourceNames falsch ist, wird ein Fehler wie der folgende angezeigt:

    Unable to save dashboard: Field mosaicLayout.tiles[0].widget.logsPanelWidget.resourceNames has an invalid value of "a-project": resource name must have the format `projects/{project}`.

    Ersetzen Sie in der JSON-Datei des Dashboards a-project durch projects/a-project, um dieses Problem zu beheben.

  • Informationen zum Beheben von Syntaxfehlern im Feld filter finden Sie unter Fehlerbehebung: Syntaxprobleme.

Ein Beispiel für eine korrekt formatierte JSON-Datei finden Sie unter Dashboard mit einem LogsPanel-Widget.

Grafana-Dashboards importieren

Informationen zur Verwendung und Fehlerbehebung des Dashboard-Importers finden Sie unter Grafana-Dashboards in Cloud Monitoring importieren.

Informationen zu Problemen bei der Konvertierung des Dashboard-Inhalts finden Sie in der Datei README des Importers.