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 Beobachtbarkeitsansichten abfragen.

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

Hinweis

Melden Sie sich in Ihrem Google Cloud Konto an. Wenn Sie noch kein Konto bei Google Cloudhaben, 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.

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 Erstellen, Verwalten und Verwenden von Analyseansichten benötigen:

   • Observability View Accessor (roles/observability.viewAccessor) auf den 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 das Hauptkonto 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.

   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 müssen eine Beobachtbarkeitsansicht haben. Weitere Informationen finden Sie unter Speichermodell für Cloud Trace.

Analyseansicht erstellen

Hinweis: Eine Analyseansicht kann Beobachtbarkeitsansichten abfragen. Wenn eine Analyseansicht mehrere Ansichten abfragt, müssen sich diese am selben Speicherort befinden.

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. Achten Sie darauf, dass in der Symbolleiste Abfrage ausführen angezeigt wird. Wenn in der Symbolleiste In BigQuery ausführen angezeigt wird, dann klicken Sie auf Einstellungen und wählen Sie Loganalysen (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 Beobachtbarkeitsansicht laden und bearbeiten, die von Ihrer Analyseansicht abgefragt wird. So laden Sie die Standardabfrage:

   1. Rufen Sie im Menü Ansichten den Bereich 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 ist auf 100 Zeichen begrenzt und darf nur Buchstaben, Ziffern, Unterstriche und Bindestriche enthalten. Sie können den Namen nach dem Erstellen der Analyseansicht 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 Beobachtbarkeitsansichten ab. Verwenden Sie für die Abfrage von Analyseansichten 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 Analyseansicht. Sie ist auf 100 Zeichen begrenzt und darf nur Buchstaben, Ziffern, Unterstriche und Bindestriche enthalten.

Weitere Informationen finden Sie unter Traces abfragen und analysieren.

Analyseansichten auflisten

So listen Sie die 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. Achten Sie darauf, dass in der Symbolleiste Abfrage ausführen angezeigt wird. Wenn in der Symbolleiste In BigQuery ausführen angezeigt wird, dann klicken Sie auf Einstellungen und wählen Sie Loganalysen (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 Analyseansichten abrufen

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

• Name
• Erstellungsdatum
• Letzte Aktualisierung
• Schema
• Abfrage

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 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. Achten Sie darauf, dass in der Symbolleiste Abfrage ausführen angezeigt wird. Wenn in der Symbolleiste In BigQuery ausführen angezeigt wird, dann klicken Sie auf Einstellungen und wählen Sie Loganalysen (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 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. Achten Sie darauf, dass in der Symbolleiste Abfrage ausführen angezeigt wird. Wenn in der Symbolleiste In BigQuery ausführen angezeigt wird, dann klicken Sie auf Einstellungen und wählen Sie Loganalysen (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:

• Eine Analyseansicht kann nur Beobachtbarkeitsansichten abfragen.
• 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 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

• Traces abfragen und analysieren.
• SQL-SQL-Abfrage darstellen.
• Informationen zum Speichern und Teilen von Abfragen.
• SQL-Beispielabfragen.