Analytics-Ansichten erstellen, abfragen und verwalten

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.

In diesem Dokument wird beschrieben, wie Sie Analyseansichten erstellen und verwalten. Nachdem Sie eine Analyseansicht erstellt haben, können Sie sie ähnlich wie Protokollansichten und Observability-Ansichten abfragen.

Eine Übersicht über Analytics-Ansichten finden Sie unter Analytics-Ansichten.

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 Erstellen, Verwalten und Verwenden von Analyseansichten 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 Ansichten für die Beobachtbarkeit zugreifen. Ansichten für die Beobachtbarkeit sind in der öffentlichen Vorschau verfügbar.
   • Observability Analytics User (roles/observability.analyticsUser) für Ihr Projekt. Diese Rolle enthält die Berechtigungen, die zum Speichern und Ausführen privater Abfragen sowie zum Ausführen freigegebener Abfragen erforderlich sind.
   • 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. Sie können die Zuweisung dieser Rolle auf eine bestimmte Ansicht beschränken, indem Sie eine IAM-Bedingung hinzufügen.

   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.

2. Sie benötigen mindestens eines der folgenden Elemente:
   • Ein Log-Bucket, für den ein Upgrade zur Verwendung von Loganalysen durchgeführt wurde. Weitere Informationen finden Sie unter Log-Buckets konfigurieren.
   • Eine Beobachtbarkeitsansicht. Weitere Informationen finden Sie unter Cloud Trace-Speichermodell.

Analytics-Ansicht erstellen

Hinweis :Mit einer Analytics-Ansicht können Log-Ansichten und Observability-Ansichten abgefragt werden. Wenn in einer Analytics-Ansicht mehrere Ansichten abgefragt werden, müssen sich diese am selben Speicherort befinden. Wenn Sie beispielsweise zwei Log-Buckets am Speicherort us-east1 haben, können Sie eine Analyseansicht erstellen, mit der Logansichten in diesen beiden Log-Buckets abgefragt werden.

So erstellen Sie eine Analyseansicht:

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. Konfigurieren Sie die Seite Loganalysen:
   1. In der Symbolleiste muss Abfrage ausführen angezeigt werden. Wenn in der Symbolleiste In BigQuery ausführen angezeigt wird, klicken Sie auf  Einstellungen und wählen Sie Loganalysen (Standard) aus.
   2. Wenn das Menü Ansichten nicht angezeigt wird, klicken Sie im Navigationsbereich auf Ansichten und Schema.

3. Geben Sie die Abfrage ein, die Sie als Analyseansicht speichern möchten, und bestätigen Sie sie.

   Möglicherweise möchten Sie die Standardabfrage für die Protokollansicht oder die Observability-Ansicht laden und bearbeiten, die von Ihrer Analyseansicht abgefragt wird. So laden Sie die Standardabfrage:

   1. Klicken Sie im Menü Ansichten auf eine der folgenden Optionen:

      • Rufen Sie den Bereich Segment Logs auf und wählen Sie eine Logansicht aus.
      • Gehen Sie zum Bereich Traces (Traces) und wählen Sie _Trace.Spans._AllSpans aus.

   2. Klicken Sie in der Symbolleiste Schema auf Abfrage und dann auf Überschreiben.

      Der Bereich Abfrage wird mit einer SQL-Abfrage aktualisiert.

   3. Aktualisieren Sie die Abfrage, bis Sie mit den Ergebnissen zufrieden sind.

4. Analytics-Ansicht erstellen:

   1. Klicken Sie in der Symbolleiste auf Speichern Speichern und wählen Sie dann Als Analytics-Ansicht speichern aus.

   2. Geben Sie einen Namen und eine Beschreibung für die Analytics-Ansicht ein.

      Der Name darf maximal 100 Zeichen lang sein und nur Buchstaben, Ziffern, Unterstriche und Bindestriche enthalten. Nach dem Erstellen der Analyseansicht können Sie den Namen nicht mehr ändern.

   3. Klicken Sie auf Speichern.

   Das System erstellt die Analytics-Ansicht und listet sie im Bereich Ansichten im Abschnitt Analytics-Ansichten der data_table auf.

Analyseansicht abfragen

Sie fragen eine Analyseansicht auf ähnliche Weise ab wie Protokollansichten und Ansichten zur Beobachtbarkeit. Wenn Sie Analyseansichten abfragen möchten, verwenden Sie das folgende Format für die FROM-Klausel:

FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`

Die Felder in den vorherigen Ausdrücken haben die folgende Bedeutung:

• PROJECT_ID: Die Kennung des Projekts.
• LOCATION: Der Speicherort der Analyseansicht.
• ANALYTICS_VIEW_ID: Die ID der Analytics-Ansicht. Sie ist auf 100 Zeichen begrenzt und darf nur Buchstaben, Ziffern, Unterstriche und Bindestriche enthalten.

Weitere Informationen finden Sie unter Log Analytics.

Analytics-Datenansichten auflisten

So rufen Sie eine Liste der Analyseansichten in Ihrem Google Cloud Projekt 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. Konfigurieren Sie die Seite Loganalysen:
   1. In der Symbolleiste muss Abfrage ausführen angezeigt werden. Wenn in der Symbolleiste In BigQuery ausführen angezeigt wird, klicken Sie auf  Einstellungen und wählen Sie Loganalysen (Standard) aus.
   2. Wenn das Menü Ansichten nicht angezeigt wird, klicken Sie im Navigationsbereich auf Ansichten und Schema.

3. Rufen Sie im Menü Ansichten den Abschnitt Analytics-Ansichten data_table auf.

Details zu einer Analyseansicht abrufen

Mit den Optionen im Bereich Schema können Sie die folgenden Informationen zu einer Analyseansicht anzeigen:

• Name
• Erstellungsdatum
• Letzte Aktualisierung
• Schema.
• Query.

Wenn Sie die Details für eine Analyseansicht aufrufen möchten, listen Sie die Analyseansichten in Ihrem Projekt auf und gehen Sie dann so vor:

1. Wählen Sie die Analytics-Ansicht aus, deren Informationen Sie aufrufen möchten.
2. Klicken Sie in der Symbolleiste Schema auf  Optionen zum Ansehen von Analysen und wählen Sie Details ansehen aus.

Analytics-Ansicht ändern

So ändern Sie eine Analytics-Ansicht:

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. Konfigurieren Sie die Seite Loganalysen:
   1. In der Symbolleiste muss Abfrage ausführen angezeigt werden. Wenn in der Symbolleiste In BigQuery ausführen angezeigt wird, klicken Sie auf  Einstellungen und wählen Sie Loganalysen (Standard) aus.
   2. Wenn das Menü Ansichten nicht angezeigt wird, klicken Sie im Navigationsbereich auf Ansichten und Schema.

3. Rufen Sie im Menü Datenansichten den Abschnitt Analytics-Datenansichten data_table auf und wählen Sie die Analytics-Datenansicht aus, die Sie ändern möchten.

4. Klicken Sie in der Symbolleiste Schema auf  Optionen für Analyseansicht ansehen und wählen Sie Ansicht bearbeiten aus.

   Ein Dialogfeld mit Informationen zur Analytics-Ansicht wird geöffnet. Sie können die Beschreibung und die Abfrage ändern.

5. Wenn Sie alle Änderungen vorgenommen haben, klicken Sie auf Gespeicherte Ansicht überschreiben.

Analytics-Ansicht löschen

Hinweis :Wenn Sie Abfragen für eine Analytics-Ansicht geschrieben haben und diese Ansicht löschen, schlagen die Abfragen fehl.

So löschen Sie eine Analytics-Ansicht:

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. Konfigurieren Sie die Seite Loganalysen:
   1. In der Symbolleiste muss Abfrage ausführen angezeigt werden. Wenn in der Symbolleiste In BigQuery ausführen angezeigt wird, klicken Sie auf  Einstellungen und wählen Sie Loganalysen (Standard) aus.
   2. Wenn das Menü Ansichten nicht angezeigt wird, klicken Sie im Navigationsbereich auf Ansichten und Schema.

3. Rufen Sie im Menü Ansichten den Abschnitt Analytics-Ansichten der data_table auf und wählen Sie die Analytics-Ansicht aus, die Sie löschen möchten.
4. Klicken Sie in der Symbolleiste Schema auf  Optionen für Analytics-Ansicht ansehen, wählen Sie Ansicht löschen aus und füllen Sie das Dialogfeld aus.

Beschränkungen

Für Analyseansichten gelten die folgenden Einschränkungen:

• In einer Analyseansicht können nur Log- und Observability-Ansichten abgefragt werden.
• Die übergeordnete Ressource einer Analyseansicht muss ein Google Cloud -Projekt sein.
• Sie können eine Analyseansicht nur über die Seite Loganalysen abfragen und nur, wenn Sie die Abfrage-Engine Loganalysen (Standard) verwenden.
• Alle Ansichten, die von einer Analytics-Ansicht abgefragt werden, müssen sich am selben Standort befinden.
• Sie müssen die Google Cloud Console verwenden, um Ihre Analyseansichten zu erstellen oder zu verwalten.
• Sie können maximal 100 Analytics-Ansichten pro Google Cloud Projekt erstellen.
• Sie können maximal 50 Analytics-Ansichten pro Region erstellen.
• Pro Google Cloud Projekt können maximal 10 Regionen eine Analyseansicht enthalten.

Nächste Schritte

• Telemetriedaten mit Loganalysen abfragen und analysieren
• SQL-SQL-Abfrage darstellen
• Abfragen speichern und freigeben
• SQL-Beispielabfragen