SQL-Abfrageergebnisse in Diagrammen darstellen

In diesem Dokument wird beschrieben, wie Sie die Ergebnisse Ihrer Log Analytics-Abfragen, die SQL-Abfragen ausgeben, in Diagrammen darstellen. Wenn Sie Ihre Log- und Tracedaten mit SQL analysieren, können Sie Muster und Trends erkennen. Sie können die Abfrageergebnisse als Tabelle ansehen oder visualisieren, indem Sie ein Diagramm erstellen. Sie können ein Diagramm auch in einem benutzerdefinierten Dashboard speichern.

Der folgende Screenshot zeigt die Ergebnisse der Beispielabfrage für den Trace, die weiter unten in diesem Dokument zu sehen ist. Der Screenshot zeigt den von Spans gemeldeten Status nach der Aggregation der Antworten nach Zeit und nach service_name:

Hinweis

Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Aktivieren Sie die Observability 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

API aktivieren

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Aktivieren Sie die Observability 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

API aktivieren

1. Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Laden der Seite Loganalysen, zum Schreiben und Ausführen von Abfragen für Ihre Log- und Tracedaten sowie zum Speichern von Diagrammen in benutzerdefinierten Dashboards benötigen:

   • Monitoring-Bearbeiter (roles/monitoring.editor) für Ihr Projekt
   • Observability View Accessor (roles/observability.viewAccessor) für die Observability-Ansichten, die Sie abfragen möchten. Diese Rolle unterstützt IAM-Bedingungen, mit denen Sie die Zuweisung auf eine bestimmte Ansicht beschränken können. Wenn Sie der Rollenzuweisung keine Bedingung hinzufügen, kann das Hauptkonto auf alle Ansichten für die Beobachtbarkeit zugreifen. Ansichten für die Beobachtbarkeit sind in der öffentlichen Vorschau verfügbar.
   • Loganzeige (roles/logging.viewer) für Ihr Projekt
   • Zugriffsberechtigter für Logbetrachtung (roles/logging.viewAccessor) für das Projekt, in dem die Logansichten gespeichert sind, die Sie abfragen möchten.

   Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

   Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Daten für das Diagramm auswählen

Wenn Sie konfigurieren möchten, welche Daten in einem Diagramm angezeigt werden, erstellen Sie eine Abfrage mit SQL. Wenn Sie den Tab Diagramm auswählen, werden die Ergebnisse Ihrer Abfrage in einem Diagramm dargestellt. Nachdem die Abfrage ausgeführt und ein Diagramm generiert wurde, können Sie die Diagrammkonfiguration anpassen, indem Sie den Diagrammtyp ändern und Spalten auswählen, um verschiedene Daten anzusehen.

So rufen Sie die Abfrageergebnisse als Diagramm auf:

1. Rufen Sie in der Google Cloud -Console die Seite Loganalysen auf.

   Zu Loganalysen

   Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis mit der Zwischenüberschrift Logging aus.

2. Geben Sie im Bereich Abfrage eine Abfrage ein und klicken Sie auf Ausführen.

3. Nachdem die Abfrage abgeschlossen ist, wählen Sie auf dem Tab Ergebnisse aus, wie Sie die Abfrageergebnisse ansehen möchten:

   • Tabelle: Nur tabellarisches Format.

   • Diagramm: Nur Diagrammformat

   • Beide: Diagramm und Tabellenformat.

     Nachdem Sie ausgewählt haben, wie die Abfrageergebnisse dargestellt werden sollen, können Sie alle Felder für die ausgewählte Visualisierung konfigurieren und dann die Abfrage und die Ergebnisse in einem benutzerdefinierten Dashboard speichern. Das gespeicherte Format ist tabellarisch, wenn Sie die Option Tabelle ausgewählt haben. Andernfalls ist das Format ein Diagramm.

     Bei Diagrammen können Sie mit den Visualisierungsoptionen den Diagrammtyp und die darzustellenden Zeilen und Spalten auswählen. Weitere Informationen zur Diagrammkonfiguration finden Sie unter Diagrammkonfiguration anpassen.

Diagrammkonfiguration anpassen

Sie können die Diagrammkonfiguration anpassen, indem Sie den Diagrammtyp ändern, die darzustellende Dimension und den darzustellenden Messwert auswählen und einen Aufschlüsselungsvorgang anwenden. Mit der Dimension werden Zeilen gruppiert oder kategorisiert. Sie ist der Wert auf der X-Achse. Der Messwert oder Y-Achsenwert ist eine Datenreihe, die auf der Y-Achse dargestellt wird.

Diagrammtyp ändern

Je nachdem, welche Zeilen und Spalten Sie als Dimension und Messwert ausgewählt haben und wie Sie die Daten visualisieren möchten, können Sie einen der folgenden Diagrammtypen auswählen.

• Balkendiagramm (Standard): In Balkendiagrammen werden Daten auf zwei Achsen dargestellt. Wenn in Ihrem Diagramm eine Kategorie oder ein String als Dimension verwendet wird, können Sie die Diagrammkonfiguration für ein Balkendiagramm auf horizontal oder vertikal festlegen. In diesem Fall werden die Achsen für Dimension und Messwert getauscht.

• Liniendiagramm: Mit Liniendiagrammen lassen sich Datenänderungen im Zeitverlauf darstellen. In einem Liniendiagramm wird jede Zeitreihe durch eine andere Linie dargestellt, die den ausgewählten Messwerten entspricht.

  Wenn die X-Achse zeitbasiert ist, wird jeder Datenpunkt am Anfang eines Zeitintervalls platziert. Jeder Datenpunkt wird durch lineare Interpolation verbunden.

• Gestapeltes Flächendiagramm: Ein Flächendiagramm basiert auf einem Liniendiagramm. Der Bereich unter jeder Linie ist schattiert. In Flächendiagrammen werden die Datenreihen gestapelt. Wenn Sie beispielsweise zwei identische Reihen haben, überlappen sie sich in einem Liniendiagramm, aber der schattierte Bereich wird in einem Flächendiagramm gestapelt.

• Kreis- oder Ringdiagramm: In einem Kreisdiagramm wird dargestellt, wie sich die Kategorien in einem Datensatz auf den gesamten Datensatz beziehen. Dazu wird ein Kreis verwendet, der den gesamten Datensatz repräsentiert, und Segmente im Kreis, die die Kategorien im Datensatz repräsentieren. Die Größe eines Segmentes gibt an, wie viel die Kategorie zum Ganzen beiträgt, oft als Prozentsatz.

• Tabelle: In einer Tabelle wird für jede Zeile im Abfrageergebnis eine Zeile angezeigt. Die Spalten in der Tabelle werden durch die SELECT-Klausel definiert. Wenn Sie Daten in tabellarischer Form in einem Dashboard präsentieren möchten, verwenden Sie eine LIMIT-Klausel, um die Anzahl der Zeilen im Ergebnis auf einige Hundert zu beschränken.

• Gauge oder Kurzübersicht: Gauges und Kurzübersichten zeigen den aktuellen Wert zusammen mit einer grünen, gelben oder roten Anzeige an, je nachdem, wie hoch der Wert im Vergleich zu einer Reihe von Grenzwerten ist. Im Gegensatz zu Messinstrumenten, in denen nur Informationen zum letzten Wert angezeigt werden, können Kurzübersichten auch Informationen zu vergangenen Werten enthalten.

  Messgeräte und Scorecards können das Abfrageergebnis nur anzeigen, wenn es mindestens eine Zeile enthält, die eine Spalte mit einem Zeitstempel und eine Spalte mit numerischen Daten enthält. Das Abfrageergebnis kann mehrere Zeilen und mehr als zwei Spalten enthalten.

  Wenn Sie die zeitbasierte Aggregation im Rahmen Ihrer Abfrage durchführen möchten, gehen Sie so vor:

  • Konfigurieren Sie Ihre Abfrage so, dass Daten über ein Zeitintervall hinweg aggregiert werden, die Ergebnisse nach absteigenden Zeitstempeln sortiert werden und die Anzahl der Zeilen in den Ergebnissen begrenzt wird. Sie können die LIMIT-Klausel oder die Zeitraumauswahl verwenden, um die Anzahl der Zeilen im Abfrageergebnis zu begrenzen.

    Logdaten

    Im folgenden Beispiel wird eine Log-Ansicht abgefragt. Die Daten werden nach Stunde aggregiert, ein Limit wird angewendet und die Ergebnisse werden sortiert:

    SELECT TIMESTAMP_TRUNC(timestamp, HOUR) AS hour, severity, COUNT(*) AS count
    FROM `PROJECT_ID.LOCATION.BUCKET_ID.LOG_VIEW_ID`
    WHERE severity IS NOT NULL AND severity = "DEFAULT"
    GROUP BY hour,severity
    ORDER BY hour DESC
    LIMIT 10
    

    Im Folgenden wird die Bedeutung der Felder im vorherigen Ausdruck beschrieben:

    • PROJECT_ID: Die Kennung des Projekts.
    • LOCATION: Der Speicherort der Logansicht oder der Analyseansicht.
    • BUCKET_ID: Der Name oder die ID des Log-Buckets.
    • LOG_VIEW_ID: Die Kennung der Logansicht. Sie ist auf 100 Zeichen begrenzt und darf nur Buchstaben, Ziffern, Unterstriche und Bindestriche enthalten.

    Trace-Daten

    Vorschau

    Dieses Produkt oder diese Funktion unterliegt den Bedingungen für Pre‑GA-Angebote im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und ‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie in den Beschreibungen der Produkteinführungsphasen.

    Mit den folgenden Abfragen werden beispielsweise Ihre Trace-Daten abgefragt. Die Daten werden in Ein-Stunden-Intervallen zusammengefasst, ein Grenzwert wird angewendet und die Ergebnisse werden sortiert:

    SELECT TIMESTAMP_TRUNC(start_time, HOUR) AS hour,
       COALESCE(
          JSON_VALUE(resource.attributes, '$."service.name"'),
          JSON_VALUE(attributes, '$."service.name"'),
          JSON_VALUE(attributes, '$."g.co/gae/app/module"')) AS service_name,
       status.code AS status,
       COUNT(*) AS count
    FROM `PROJECT_ID.LOCATION._Trace.Spans._AllSpans`
    GROUP BY hour, service_name, status
    ORDER BY hour DESC
    LIMIT 1000
    

    Im Folgenden wird die Bedeutung der Felder im vorherigen Ausdruck beschrieben:

    • PROJECT_ID: Die Kennung des Projekts.
    • LOCATION: Der Speicherort des Observability-Buckets.

    Mit der vorherigen Abfrage wurde die Abbildung am Anfang dieses Dokuments generiert. In dieser Abbildung ist auch die Diagrammkonfiguration zu sehen.

  • Legen Sie die Dimension so fest, dass sie mit der Spalte übereinstimmt, in der die Zeiteinheit angegeben ist. Wenn in Ihrer Abfrage beispielsweise Daten nach Stunde aggregiert und eine Spalte mit dem Namen hour erstellt wird, legen Sie das Menü Dimension auf hour fest.

  • Wählen Sie Intervall deaktivieren aus, da in Ihrer Abfrage bereits das Aggregationsintervall angegeben ist. Im Beispiel beträgt dieses Intervall eine Stunde.

  • Legen Sie den Messwert auf die numerische Spalte und die Funktion auf none fest.

    Hinweis: Wenn in Ihrer Abfrage eine zeitbasierte Aggregation erfolgt, sollten Sie die vorherigen Empfehlungen beachten. Bei anderen Einstellungen werden sowohl in Ihrer Abfrage als auch in Log Analytics Aggregationsvorgänge ausgeführt. Dadurch werden im Messgerät oder in der Kurzübersicht unerwartete Werte angezeigt.

  Wenn Sie die zeitbasierte Aggregation von Log Analytics durchführen lassen möchten, gehen Sie so vor:

  • Konfigurieren Sie die Zeitraumauswahl, die sich auf die Anzahl der Zeilen im Abfrageergebnis auswirkt.
  • Legen Sie die Dimension so fest, dass sie mit der Spalte übereinstimmt, in der die Zeiteinheit angegeben ist. Sie können dieses Menü beispielsweise auf timestamp festlegen.
  • Legen Sie im Menü Intervall das Aggregationsintervall auf ein bestimmtes Intervall fest. Legen Sie beispielsweise den Wert dieses Felds auf 1 hour fest. Wählen Sie nicht Automatisches Intervall aus.
  • Legen Sie den Messwert auf die numerische Spalte fest und wählen Sie eine Funktion wie sum aus.

Dimension und Messwert ändern

Sie können auswählen, welche Zeilen und Spalten im Diagramm dargestellt werden sollen, indem Sie die Dimensions- und Messwertfelder auswählen.

Hinweis :Wenn die Ergebnisse Ihrer Abfrage eine Spalte mit langen Strings wie Fehlermeldungen enthalten und Sie diese Spalte als Dimension oder Aufschlüsselung auswählen, kann es sein, dass Ihr Diagramm Fehler oder unerwartete Werte enthält.

• Dimension

  Die Dimension muss eine Zeitstempel-, numerische oder String-Spalte sein. Standardmäßig ist die Dimension auf die erste zeitstempelbasierte Spalte im Schema festgelegt. Wenn in der Abfrage kein Zeitstempel vorhanden ist, wird die erste Stringspalte als Dimension ausgewählt. Sie können auch anpassen, welche Dimension im Bereich Diagrammdarstellung verwendet wird. Wenn eine Zeitstempelspalte als Dimension ausgewählt ist, wird im Diagramm dargestellt, wie sich die Daten im Zeitverlauf ändern. Wenn eine Stringspalte als Dimension für ein Balkendiagramm ausgewählt ist, können Sie die Daten aufsteigend oder absteigend sortieren. Die Dimension wird dann in lexikografischer Reihenfolge sortiert. Sie können auch die Standardsortierreihenfolge beibehalten. In diesem Fall wird die Dimension anhand der Werte des entsprechenden Messwerts in absteigender Reihenfolge sortiert.

  Standardmäßig wird das Intervall für Zeitstempel automatisch festgelegt. Sie können aber auch ein benutzerdefiniertes Intervall auswählen. Bei automatischen Intervallen werden die Werte anhand der Zeitbereichsauswahl geändert, um Gruppen ähnlicher Größe beizubehalten.

  Sie können das Intervall auch deaktivieren, um eigene Aggregationen und Zeiträume in der Abfrage für komplexere Analysen anzugeben. Wenn Sie das Intervall deaktivieren, wird die Aggregationsfunktion der Ergebnisse auf none festgelegt. Wenn das Dimensionsintervall deaktiviert ist, sind nur numerische Messwerte zulässig.

  Hinweis: Nur die Spalte TIMESTAMP kann als Zeitstempeldimension verwendet werden. Wenn Sie DATE und DATETIME verwenden möchten, müssen Sie die Funktion CAST() verwenden, um die Datentypen in TIMESTAMP zu konvertieren.

• Messen

  Sie können im Bereich Diagrammdarstellung mehrere Messwerte auswählen. Wenn Sie einen Messwert auswählen, müssen Sie auch die Aggregationsfunktion auswählen, die für die gruppierten Werte ausgeführt werden soll, z. B. count, sum, average und percentile-99. count-distinct gibt beispielsweise die Anzahl der eindeutigen Werte in einer bestimmten Spalte zurück.

  Wenn Sie das Kästchen Intervall deaktivieren für die Dimension auswählen, ist die Aggregationsfunktion none verfügbar. Wenn die Dimension ein Stringwert ist, wird das Kästchen Intervall deaktivieren nicht angezeigt. Wenn Sie die Aggregationsfunktionen eines Messwerts auf none festlegen, wird das Intervall jedoch auch deaktiviert.

Aufschlüsselung hinzufügen

Hinweis :Wenn Ihr Diagramm mehr als eine Messung enthält, können Sie keine Aufschlüsselung hinzufügen.

Wenn Sie eine einzelne Datenreihe anhand einer anderen Spalte in mehrere Datenreihen aufteilen möchten, fügen Sie einen Aufschlüsselung hinzu.

Wenn Sie einen Aufschlüsselung auswählen, sollten Sie Spalten mit einer kleinen Anzahl kurzer und aussagekräftiger Labels wie region_name verwenden, anstatt Felder, die eine große Anzahl von Strings oder lange Strings wie textPayload enthalten.

Logdaten

Sehen Sie sich beispielsweise die folgende Diagrammkonfiguration an, in der das Feld Dimension auf type, das Feld Messwert auf Count rows und das Feld Aufschlüsselung auf severity festgelegt ist:

Im vorherigen Screenshot sehen Sie eine gestapelte Datenreihe, in der der Ressourcentyp k8s_container in verschiedene severity-Typen unterteilt ist. So können Sie ermitteln, wie viele Logs der einzelnen Schweregrade von einer bestimmten Ressource generiert wurden.

Trace-Daten

Vorschau

Dieses Produkt oder diese Funktion unterliegt den Bedingungen für Pre‑GA-Angebote im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und ‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie in den Beschreibungen der Produkteinführungsphasen.

Im folgenden Diagramm wird beispielsweise die Anzahl der Spans angezeigt, die von jedem Dienst erstellt wurden, zusammen mit den Daten, die nach dem Spannennamen aufgeschlüsselt sind:

Diagramm in einem benutzerdefinierten Dashboard speichern

Nachdem ein Diagramm aus Ihrer Abfrage generiert wurde, können Sie es in einem benutzerdefinierten Dashboard speichern. Mit benutzerdefinierten Dashboards können Sie relevante Informationen mithilfe verschiedener Widget-Typen anzeigen und organisieren. In diesen Dashboards können Sie auch Variablen definieren. Das sind Filter auf Dashboard-Ebene, die nur für bestimmte Widgets gelten. Wenn Sie eine Variable auf ein Widget anwenden möchten, müssen Sie die Abfrage ändern. Weitere Informationen finden Sie unter Variable auf ein Widget anwenden.

In einem Dashboard wird eine Warnmeldung für ein Widget mit einer SQL-Abfrage angezeigt, wenn die Abfrage in der BigQuery-Engine ausgeführt wird und die abgefragten Ressourcen nicht zur selben Eigentümergrenze gehören. Die Grenzen für die Inhaberschaft werden durch mehrere Faktoren bestimmt, darunter die Hierarchie der Ressourcen, die in der Abfrage verwendet werden. Richten Sie einen Dienstperimeter ein, um diese Warnungen zu vermeiden.

So speichern Sie das Diagramm in einem Dashboard:

1. Rufen Sie in der Google Cloud -Console die Seite Loganalysen auf.

   Zu Loganalysen

   Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis mit der Zwischenüberschrift Logging aus.

2. Führen Sie eine Abfrage aus, um ein Diagramm zu erstellen, und klicken Sie dann auf dem Tab Diagramm auf Diagramm speichern.

3. Geben Sie im Dialogfeld Im Dashboard speichern einen Titel für das Diagramm ein und wählen Sie das Dashboard aus, in dem Sie das Diagramm speichern möchten.

4. Optional: Wenn Sie das benutzerdefinierte Dashboard aufrufen möchten, klicken Sie im Pop-up-Fenster auf Dashboard ansehen.

Wenn Sie eine Liste der benutzerdefinierten Dashboards aufrufen möchten, die von SQL-Abfragen generierte Diagramme enthalten, klicken Sie auf die Schaltfläche Diagramm speichern und dann auf  Menü.

In einem benutzerdefinierten Dashboard gespeichertes Diagramm bearbeiten

Sie können ein Diagramm ändern, nachdem es in einem Dashboard gespeichert wurde. Weitere Informationen finden Sie unter Widget-Konfiguration ändern. Im Dialogfeld Widget konfigurieren haben Sie folgende Möglichkeiten:

• Ändern Sie die Daten, die Sie abfragen.
• Bearbeiten Sie die Abfrage, mit der ein Diagramm generiert wird.
• Passen Sie die Diagrammkonfiguration an, um verschiedene Daten zu visualisieren.

Beschränkungen

• Wenn sich Ihr Google Cloud Projekt in einem Ordner befindet, in dem Assured Workloads verwendet wird, können die von Ihnen generierten Diagramme nicht in einem benutzerdefinierten Dashboard angezeigt werden.

• Filter auf Dashboard-Ebene werden nicht auf Diagramme angewendet, die aus einer SQL-Abfrage generiert werden.

• Die ausgewählten Spalten müssen mindestens eine Zeile mit einem Wert ungleich null enthalten.

• Wenn Sie eine Abfrage speichern und die Diagrammkonfiguration anpassen, wird die benutzerdefinierte Diagrammkonfiguration nicht gespeichert.

• Wenn Ihre Abfrage bereits Aggregationen enthält, kann sich das generierte Diagramm aufgrund zusätzlicher Aggregationen, die automatisch von Log Analytics angewendet werden, unterscheiden.

• JSON-Pfade müssen in Strings oder Zahlen umgewandelt werden, damit sie in Diagrammen dargestellt werden können.

Nächste Schritte

• Abfragen speichern und freigeben
• SQL-Beispielabfragen