SQL-Abfrageergebnisse in Diagrammen darstellen

Vorschau

Dieses Produkt oder Feature unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der Dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Features sind „im Ist-Zustand“ verfügbar und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

In diesem Dokument wird beschrieben, wie Sie die Ergebnisse von SQL-Abfragen, die Sie auf der Seite Loganalysen ausführen, in Diagrammen darstellen. Diagramme können Ihnen helfen, Muster und Trends in Ihren Daten zu erkennen. Außerdem wird beschrieben, wie Sie Ihr Diagramm in einem benutzerdefinierten Dashboard speichern.

Der folgende Screenshot zeigt die Ergebnisse einer Beispielabfrage, die weiter unten in diesem Dokument beschrieben wird. Der Screenshot zeigt den von Spans gemeldeten Status, nachdem die Antworten nach Zeit und nach service_name aggregiert wurden:

Hinweis

Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie noch kein Google Cloud-Konto haben, erstellen Sie ein Konto, um die Leistung 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.

Enable the Observability API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

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.

Enable the Observability API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

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

   • 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 Observability-Ansichten zugreifen.
   • Loganzeige (roles/logging.viewer) für Ihr Projekt.
   • Monitoring Editor (roles/monitoring.editor) für Ihr Projekt.

   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 Diagramm auswählen

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

So rufen Sie Ihre Abfrageergebnisse als Diagramm auf:

1. Rufen Sie in der Google Cloud Console die Loganalysen Seite 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 dann auf Ausführen.

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

   • Tabelle: Nur Tabellenformat.

   • Diagramm: Nur Diagrammformat.

   • Beide: Diagramm- und Tabellenformat.

     Nachdem Sie ausgewählt haben, wie Sie Ihre Abfrageergebnisse ansehen möchten, 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 Zeilen und Spalten auswählen, die in Diagrammen dargestellt werden sollen. Weitere Informationen zur Diagrammkonfiguration finden Sie unter Diagrammkonfiguration anpassen.

Diagrammkonfiguration anpassen

Sie können die Diagrammkonfiguration anpassen, indem Sie den Diagrammtyp ändern, die Dimension und den Messwert für das Diagramm auswählen und eine Aufschlüsselung anwenden. Die Dimension wird verwendet, um Zeilen zu gruppieren oder zu kategorisieren, und ist der Wert der X-Achse. Der Messwert oder der Wert der Y-Achse ist eine Datenreihe, die auf der Y-Achse dargestellt wird.

Diagrammtyp ändern

Je nachdem, welche Art von Zeilen und Spalten Sie als Dimension und Messwert ausgewählt haben und wie Sie diese Daten visualisieren möchten, können Sie aus den 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, wobei die Achsen für Dimension und Messwert vertauscht werden.

• Liniendiagramm: Liniendiagramme können verwendet werden, um Datenänderungen im Zeitverlauf darzustellen. Wenn Sie ein Liniendiagramm verwenden, wird jede Zeitreihe durch eine andere Linie dargestellt, die den von Ihnen ausgewählten Messwerten entspricht.

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

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

• Kreis- oder Ringdiagramm: Ein Kreisdiagramm zeigt, wie sich Kategorien in einem Dataset auf das gesamte Dataset beziehen. Dazu wird ein Kreis verwendet, um das gesamte Dataset darzustellen, und Kreissegmente im Kreis, um die Kategorien im Dataset darzustellen. Die Größe eines Kreissegments 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 Tabellenform in einem Dashboard anzeigen 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 liefern den letzten Wert zusammen mit einer grünen, gelben oder roten Anzeige, je nachdem, wie dieser Wert im Vergleich zu einer Reihe von Grenzwerten abschneidet. Anders als Gauges, die nur Informationen zum letzten Wert enthalten, können Kurzübersichten auch Informationen zu früheren Werten enthalten.

  In Gauges und Kurzübersichten kann das Abfrageergebnis nur angezeigt werden, wenn es mindestens eine Zeile enthält und diese Zeile 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 als Teil Ihrer Abfrage ausführen möchten, gehen Sie so vor:

  • Konfigurieren Sie Ihre Abfrage so, dass Daten über ein Zeitintervall 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.

    Die folgende Abfrage fragt beispielsweise Ihre Trace-Daten ab, aggregiert die Daten in Intervallen von einer Stunde, wendet ein Limit an und sortiert die Ergebnisse:

    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 erstellt. In dieser Abbildung ist auch die Diagrammkonfiguration zu sehen.

  • Legen Sie für die Dimension die Spalte fest, in der die Zeiteinheit angegeben ist. Wenn Ihre Abfrage beispielsweise Daten nach Stunden aggregiert und eine Spalte mit dem Namen hour erstellt, legen Sie das Menü Dimension auf hour fest.

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

  • Legen Sie für den Messwert die numerische Spalte fest und setzen Sie die Funktion auf keine.

    Hinweis: Wenn Ihre Abfrage eine zeitbasierte Aggregation ausführt, müssen Sie sicherstellen, dass Sie die vorherigen Anweisungen befolgen. Bei anderen Einstellungen führen sowohl Ihre Abfrage als auch Loganalysen Aggregationsvorgänge aus, was dazu führt, dass in der Anzeige oder Kurzübersicht unerwartete Werte angezeigt werden.

  Wenn Sie die zeitbasierte Aggregation von Loganalysen ausführen lassen möchten, gehen Sie so vor:

  • Konfigurieren Sie die Zeitraumauswahl, die sich auf die Anzahl der Zeilen im Abfrageergebnis auswirkt.
  • Legen Sie für die Dimension die Spalte fest, 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 für den Messwert die numerische Spalte fest und wählen Sie eine Funktion wie Summe aus.

Dimension und Messwert ändern

Sie können auswählen, welche Zeilen und Spalten in Diagrammen dargestellt werden sollen, indem Sie die Felder für Dimension und Messwert auswählen.

Hinweis: Wenn Ihre Abfrageergebnisse eine Spalte mit langen Strings wie Fehlermeldungen enthalten und Sie diese Spalte als Dimension oder Aufschlüsselung auswählen, kann Ihr Diagramm Fehler oder unerwartete Werte enthalten.

• Dimension

  Die Dimension muss eine Zeitstempel-, numerische oder Stringspalte 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 im Bereich Diagrammanzeige anpassen, was die Dimension ist. Wenn eine Zeitstempelspalte als Dimension ausgewählt ist, zeigt das Diagramm, 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, wodurch die Dimension in lexikografischer Reihenfolge sortiert wird. Sie können auch die Standardsortierreihenfolge `default` beibehalten, bei der die Dimension basierend auf den Werten des entsprechenden Messwerts in absteigender Reihenfolge sortiert wird.

  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 basierend auf der Zeitraumauswahl geändert, um ähnlich große Gruppen 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 Messwerte auf none gesetzt. 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 CAST() Funktion verwenden, um die Datentypen in TIMESTAMP zu konvertieren.

• Messen

  Sie können im Bereich Diagrammanzeige 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 Option für 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 setzen, wird das Intervall jedoch auch deaktiviert.

Aufschlüsselung hinzufügen

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

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

Wenn Sie eine Aufschlüsselung auswählen, wählen Sie Spalten mit einer kleinen Anzahl kurzer und aussagekräftiger Labels wie region_name anstelle von Feldern aus, die eine große Anzahl von Strings oder lange Strings enthalten können, z. B. textPayload.

Das folgende Diagramm zeigt beispielsweise die Anzahl der Spans, die von jedem Dienst erstellt wurden, zusammen mit den nach Spannamen aufgeschlüsselten Daten:

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 mithilfe verschiedener Widget-Typen Informationen anzeigen und organisieren, die für Sie nützlich sind. Mit diesen Dashboards können Sie auch Variablen definieren. Das sind Filter auf Dashboard-Ebene, die nur auf bestimmte Widgets angewendet werden. 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 sich die abgefragten Ressourcen nicht in derselben Eigentümerschaftsgrenze befinden. Eigentümerschaftsgrenzen werden durch mehrere Faktoren bestimmt, darunter die Hierarchie der Ressourcen, die von der Abfrage verwendet werden. Wenn Sie diese Warnungen vermeiden möchten, richten Sie einen Dienstperimeter ein.

So speichern Sie Ihr Diagramm in einem Dashboard:

1. Rufen Sie in der Google Cloud Console die Loganalysen Seite 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 In 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 in der Benachrichtigung auf Dashboard ansehen.

Eine Liste der benutzerdefinierten Dashboards, die Diagramme enthalten, die mit SQL-Abfragen erstellt wurden, finden Sie unter der Schaltfläche Diagramm speichern. Klicken Sie 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 Widgetkonfiguration ändern. Im Dialogfeld Widget konfigurieren haben Sie folgende Möglichkeiten:

• Die Daten ändern, die Sie abfragen.
• Die Abfrage bearbeiten, mit der ein Diagramm erstellt wird.
• Die Diagrammkonfiguration anpassen, 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 erstellten Diagramme nicht in einem benutzerdefinierten Dashboard angezeigt werden.

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

• 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 unterscheiden, die automatisch von Loganalysen angewendet werden.

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

Nächste Schritte

• SQL-Abfrage speichern und freigeben.
• SQL-Beispielabfragen.
• Verknüpftes Dataset in BigQuery abfragen.