Analytics-Ansichten erstellen, abfragen und verwalten

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 Analyseansichten erstellen und verwalten. Nachdem Sie eine Analyseansicht erstellt haben, können Sie sie ähnlich wie Logansichten und Beobachtbarkeitsansichten abfragen.

Eine Übersicht über Analyseansichten finden Sie unter Informationen zu Analyseansichten.

Hinweis

1. 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

2. Verify that billing is enabled for your Google Cloud project.

3. Enable the Observability API.

   Roles required to enable APIs

   To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

   Enable the API

4. 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 Beobachtbarkeitsansichten, 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 der Prinzipal auf alle Beobachtbarkeitsansichten zugreifen. Beobachtbarkeitsansichten sind im Rahmen des Programms „Öffentliche 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 diese Rollenzuweisung 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.

5. Sie benötigen mindestens eine der folgenden Ressourcen:
   • Ein Log-Bucket, das für die Verwendung von Observability Analytics aktualisiert wurde. Weitere Informationen finden Sie unter Log-Buckets konfigurieren.
   • Eine Beobachtbarkeitsansicht. Weitere Informationen finden Sie unter Cloud Trace-Speichermodell.

Analyseansicht erstellen

Hinweis: Mit einer Analyseansicht können Logansichten und Beobachtbarkeitsansichten abgefragt werden. Wenn eine Analyseansicht mehrere Ansichten abfragt, müssen sich diese am selben Speicherort befinden. Wenn Sie beispielsweise zwei Log-Buckets am Standort 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 Observability Analytics Seite auf:

   Zu Observability Analytics

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

2. Konfigurieren Sie die Seite Observability Analytics :
   1. In der Symbolleiste muss Abfrage ausführen angezeigt werden. Wenn in der Symbolleiste In BigQuery ausführen angezeigt wird, dann klicken Sie auf Einstellungen und wählen Sie Observability Analytics (Standard) aus.
   2. Wenn das Menü Ansichten nicht angezeigt wird, rufen Sie den Navigationsbereich auf und klicken Sie 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 Logansicht oder Beobachtbarkeitsansicht laden und bearbeiten, die von Ihrer Analyseansicht abgefragt wird. So laden Sie die Standardabfrage:

   1. Führen Sie im Menü Ansichten einen der folgenden Schritte aus:

      • Rufen Sie den Abschnitt Logs auf und wählen Sie eine Logansicht aus.
      • Rufen Sie den Abschnitt Traces auf 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 Abfrageergebnissen zufrieden sind.

4. Analyseansicht erstellen:

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

   2. Geben Sie einen Namen und eine Beschreibung für die Analyseansicht ein.

      Der Name darf maximal 100 Zeichen lang sein und nur Buchstaben, Ziffern, Unterstriche und Bindestriche enthalten. Nachdem Sie die Analyseansicht erstellt haben, können Sie den Namen nicht mehr ändern.

   3. Klicken Sie auf Speichern.

   Das System erstellt Ihre Analyseansicht und listet sie im Bereich Ansichten auf, im Abschnitt data_table Analyseansichten.

Analyseansicht abfragen

Sie fragen eine Analyseansicht ähnlich wie Logansichten und Beobachtbarkeitsansichten ab. Verwenden Sie für die FROM-Klausel das folgende Format, um Analyseansichten abzufragen:

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 Analyseansicht. Sie darf maximal 100 Zeichen lang sein und nur Buchstaben, Ziffern, Unterstriche und Bindestriche enthalten.

Weitere Informationen finden Sie unter Observability Analytics.

Analyseansichten auflisten

So listen Sie die Analyseansichten in Ihrem Google Cloud Projekt auf:

1. Rufen Sie in der Google Cloud Console die Observability Analytics Seite auf:

   Zu Observability Analytics

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

2. Konfigurieren Sie die Seite Observability Analytics :
   1. In der Symbolleiste muss Abfrage ausführen angezeigt werden. Wenn in der Symbolleiste In BigQuery ausführen angezeigt wird, dann klicken Sie auf Einstellungen und wählen Sie Observability Analytics (Standard) aus.
   2. Wenn das Menü Ansichten nicht angezeigt wird, rufen Sie den Navigationsbereich auf und klicken Sie auf Ansichten und Schema.

3. Rufen Sie im Menü Ansichten den data_table Analyseansichten Abschnitt 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 Analyseansicht aus, deren Informationen Sie aufrufen möchten.
2. Klicken Sie in der Symbolleiste Schema auf Optionen zum Ansehen von Analysen aufrufen, und wählen Sie Details ansehen aus.

Analyseansicht ändern

So ändern Sie eine Analyseansicht:

1. Rufen Sie in der Google Cloud Console die Observability Analytics Seite auf:

   Zu Observability Analytics

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

2. Konfigurieren Sie die Seite Observability Analytics :
   1. In der Symbolleiste muss Abfrage ausführen angezeigt werden. Wenn in der Symbolleiste In BigQuery ausführen angezeigt wird, dann klicken Sie auf Einstellungen und wählen Sie Observability Analytics (Standard) aus.
   2. Wenn das Menü Ansichten nicht angezeigt wird, rufen Sie den Navigationsbereich auf und klicken Sie auf Ansichten und Schema.

3. Rufen Sie im Menü Ansichten den data_table Analyseansichten Abschnitt auf und wählen Sie die Analyseansicht aus, die Sie ändern möchten.

4. Klicken Sie in der Symbolleiste Schema auf Optionen zum Ansehen von Analysen aufrufen und wählen Sie Ansicht bearbeiten aus.

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

5. Klicken Sie nach Abschluss der Änderungen auf Gespeicherte Ansicht überschreiben.

Analyseansicht löschen

Hinweis: Wenn Sie Abfragen für eine Analyseansicht geschrieben und die Analyseansicht gelöscht haben, schlagen diese Abfragen fehl.

So löschen Sie eine Analyseansicht:

1. Rufen Sie in der Google Cloud Console die Observability Analytics Seite auf:

   Zu Observability Analytics

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

2. Konfigurieren Sie die Seite Observability Analytics :
   1. In der Symbolleiste muss Abfrage ausführen angezeigt werden. Wenn in der Symbolleiste In BigQuery ausführen angezeigt wird, dann klicken Sie auf Einstellungen und wählen Sie Observability Analytics (Standard) aus.
   2. Wenn das Menü Ansichten nicht angezeigt wird, rufen Sie den Navigationsbereich auf und klicken Sie auf Ansichten und Schema.

3. Rufen Sie im Menü Ansichten den data_table Analyseansichten Abschnitt auf und wählen Sie die Analyseansicht aus, die Sie löschen möchten.
4. Klicken Sie in der Symbolleiste Schema auf Optionen zum Ansehen von Analysen aufrufen und wählen Sie Ansicht löschen aus. Führen Sie dann die Schritte im Dialogfeld aus.

Beschränkungen

Für Analyseansichten gelten die folgenden Einschränkungen:

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

Nächste Schritte

• Telemetriedaten mit Observability Analytics abfragen und analysieren.
• SQL-SQL-Abfrage darstellen.
• Informationen zum Speichern und Teilen von Abfragen.
• SQL-Beispielabfragen.