Analysedatenansichten erstellen, abfragen und verwalten

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

In diesem Dokument wird beschrieben, wie Sie Analysedatenansichten erstellen, verwalten und abfragen. Eine konzeptionelle Übersicht finden Sie unter Analysenansichten.

Hinweise

Hinweis: Es gibt keine vordefinierten Cloud Logging Identity and Access Management (IAM)-Rollen, die die Berechtigungen zum Erstellen oder Abfragen einer Analyseansicht enthalten.

Da in Analyseansichten Protokollansichten abgefragt werden, müssen Sie mit Ihren IAM-Rollen Protokollansichten abfragen und Log Analytics verwenden können, um Analyseansichten erstellen und abfragen zu können. In diesem Abschnitt werden die IAM-Rollen aufgeführt, die zum Erstellen von Analysedatenansichten und zum Abfragen von Protokolldatenansichten und zum Verwenden von Log Analytics erforderlich sind:

• Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Observability Analytics User (roles/observability.analyticsUser) für Ihr Projekt zu erteilen, um die Berechtigungen zu erhalten, die Sie zum Erstellen, Verwalten und Verwenden von Analyseansichten benötigen.

  Diese vordefinierte Rolle enthält die Berechtigungen, die zum Erstellen, Verwalten und Verwenden von Analyseansichten erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

  Erforderliche Berechtigungen

  Die folgenden Berechtigungen sind erforderlich, um Analysedatenansichten zu erstellen, zu verwalten und zu verwenden:

  • observability.analyticsViews.get
  • observability.analyticsViews.list
  • observability.analyticsViews.create
  • observability.analyticsViews.update
  • observability.analyticsViews.delete

• Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Abfragen einer Protokollansicht und zur Verwendung von Log Analytics benötigen:

  • So rufen Sie die Log-Buckets _Required und _Default ab: Loganzeige (roles/logging.viewer)
  • So rufen Sie alle Logansichten in einem Projekt ab: Zugriffsberechtigter für Logbetrachtung (roles/logging.viewAccessor)

  Sie können ein Hauptkonto auf eine bestimmte Protokollansicht beschränken, indem Sie der Rolle „Zugriff auf Protokollansicht“ auf Projektebene eine IAM-Bedingung hinzufügen oder der Richtliniendatei der Protokollansicht eine IAM-Bindung hinzufügen. Weitere Informationen finden Sie unter Zugriff auf eine Logansicht steuern.

  Informationen zu zusätzlichen Rollen, die Sie benötigen, um Ansichten in benutzerdefinierten Bucket oder die Ansicht _AllLogs des Log-Buckets _Default abzufragen, finden Sie unter Cloud Logging-Rollen.

Analysedatenansicht erstellen

Hinweis :In einer Analyseansicht können nur Logansichten abgefragt werden. Wenn mehrere Logansichten abgefragt werden, müssen sich die Log-Buckets, in denen diese Logansichten gehostet werden, an einem Ort befinden. Wenn Sie beispielsweise zwei Log-Buckets im Speicherort us-east1 haben, erstellen Sie eine Analyseansicht, in der Logansichten für diese Log-Buckets abgefragt werden.

So erstellen Sie eine Analyseansicht:

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

   Zu Log Analytics

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

2. Gehen Sie im Menü Ansichten zum Bereich Segment Protokolle und wählen Sie die zu abfragende Protokollansicht aus.

   Sie können die Filter-Leiste verwenden oder durch die Liste der Logansichten scrollen. Jeder Eintrag in der Liste hat das Format BUCKET_ID.LOG_VIEW_ID. Die Felder beziehen sich auf die IDs des Log-Buckets und der Log-Ansicht.

3. Klicken Sie in der Symbolleiste Schema auf Abfrage.

   Der Bereich Abfrage wird mit einer SQL-Abfrage aktualisiert.

4. Achten Sie darauf, dass in der Symbolleiste Abfrage ausführen angezeigt wird.

   Wenn in der Symbolleiste In BigQuery ausführen angezeigt wird, klicken Sie auf  Einstellungen und wählen Sie Log Analytics (Standard) aus.

5. Aktualisieren Sie die SQL-Abfrage im Bereich Abfrage, bis Sie mit den Ergebnissen zufrieden sind.

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

7. Geben Sie einen Namen und eine Beschreibung für die Analyseansicht ein und klicken Sie auf Speichern.

   Der Name darf maximal 100 Zeichen lang sein und nur Buchstaben, Ziffern, Unterstriche und Bindestriche enthalten.

   Hinweis: Der Name einer Analyseansicht kann nach dem Erstellen nicht mehr geändert werden. Sie können die Beschreibung und die Abfrage ändern.

   Die Analytics-Datenanzeige wird erstellt und im Bereich Datenansichten unter data_table Analytics-Datenansichten aufgeführt. Jeder Eintrag in der Liste hat das folgende Format: LOCATION.ANALYTICS_VIEW_ID. Die Felder beziehen sich auf den Speicherort und die ID einer Analyseansicht. Wenn Sie beispielsweise eine Analytics-Datenansicht mit dem Namen my-analytic-view erstellt haben, die eine Protokolldatenansicht abfragt, deren Protokoll-Bucket sich in der Region global befindet, wird in diesem Abschnitt global.my-analytic-view angezeigt.

Analyseansicht abfragen

Nachdem eine Analyseansicht vorhanden ist, können Sie sie ähnlich wie eine Protokollansicht abfragen. Eine Liste der Dokumente zur Verwendung der Seite Log Analytics finden Sie im Abschnitt Nächste Schritte dieses Dokuments.

So führen Sie die Standardabfrage für eine Analyseansicht aus:

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

   Zu Log Analytics

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

2. Geben Sie eine Abfrage ein oder laden Sie die Standardabfrage für die Analyseansicht. Die FROM-Klausel für Ihre Abfrage sollte das folgende Format haben:

   FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`
   

   Im vorherigen Ausdruck haben die Felder folgende Bedeutung:

   • PROJECT_ID: Die Kennung des Projekts.
   • LOCATION: Der Speicherort der Analyseansicht. Der Speicherort einer Analytics-Datenquelle wird von der Ressource übernommen, die sie abfragt. Wenn in einer Analyseansicht beispielsweise eine Logdatenansicht abgefragt wird, die sich im Speicherort global befindet, ist der Speicherort der Analyseansicht ebenfalls global.
   • ANALYTICS_VIEW_ID: Die ID der Analyseansicht, die auf 100 Zeichen beschränkt ist und nur Buchstaben, Ziffern, Unterstriche und Bindestriche enthalten darf.

   So führen Sie die Standardabfrage aus:

   1. Gehen Sie im Menü Ansichten zum Bereich Analytics-Datenansichten von data_table und wählen Sie die Analytics-Datenansicht aus, die Sie abfragen möchten.

      Sie können die Datenanalyseansicht über die Leiste Filter oder durch Scrollen in der Liste der Datenanalyseansichten finden. Jeder Eintrag in der Liste hat das folgende Format: LOCATION.ANALYTICS_VIEW_ID. Die Felder beziehen sich auf den Speicherort und die ID einer Analyseansicht.

   2. Klicken Sie in der Symbolleiste Schema auf Abfrage.

      Der Bereich Abfrage wird mit einer SQL-Abfrage aktualisiert, die die ausgewählte Analyseansicht abfragt.

3. Klicken Sie auf Abfrage ausführen.

   Wenn in der Symbolleiste In BigQuery ausführen angezeigt wird, klicken Sie auf  Einstellungen und wählen Sie Log Analytics (Standard) aus.

Analysedatenansichten auflisten

So rufen Sie die Analysedatenansichten in Ihrem Google Cloud-Projekt auf:

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

   Zu Log Analytics

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

2. Gehen Sie im Menü Ansichten zum Bereich Analytics-Ansichten für data_table.

   Eine Liste der Analytics-Datenansichten wird angezeigt. Jeder Eintrag in der Liste hat das Format LOCATION.ANALYTICS_VIEW_ID. Die Felder beziehen sich auf den Standort und die ID einer Analysedatenansicht. Wenn Sie beispielsweise eine Analytics-Datenansicht mit dem Namen my-analytic-view erstellt haben, die eine Protokolldatenansicht abfragt, deren Protokoll-Bucket sich in der Region global befindet, wird in diesem Abschnitt global.my-analytic-view angezeigt.

3. So rufen Sie die Details einer bestimmten Analyseansicht auf:

   1. Wählen Sie die Analytics-Datenanalyse aus.

      Das Schema der Analyseansicht wird im Abschnitt Schema angezeigt.

   2. Klicken Sie in der Symbolleiste Schema auf  Optionen zum Ansehen von Analysen aufrufen und wählen Sie Details ansehen aus.

      Im Dialogfeld werden Informationen zur Analytics-Datenansicht angezeigt, darunter das Erstellungsdatum, das Schema und die Abfrage.

Analyseansicht ändern

So ändern Sie eine Analyseansicht:

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

   Zu Log Analytics

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

2. Gehen Sie im Menü Ansichten zum Bereich Analytics-Datenansichten von data_table und wählen Sie die Analytics-Datenansicht aus, die Sie abfragen möchten.

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

4. Nachdem Sie die gewünschten Änderungen vorgenommen haben, klicken Sie auf Gespeicherte Ansicht überschreiben.

Analyseansicht löschen

Hinweis: Wenn Sie Abfragen für eine Analysedatenansicht erstellt und diese gelöscht haben, schlagen diese Abfragen fehl.

So löschen Sie eine Analyseansicht:

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

   Zu Log Analytics

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

2. Gehen Sie im Menü Ansichten zum Bereich Analytics-Datenansichten von data_table und wählen Sie die Analytics-Datenansicht aus, die Sie abfragen möchten.
3. Klicken Sie in der Symbolleiste Schema auf  Optionen für die Datenanalyseansicht ansehen, wählen Sie Ansicht löschen aus und schließen Sie das Dialogfeld ab.

Beschränkungen

Für Analysedatenansichten gelten die folgenden Einschränkungen:

• Eine Analyseansicht kann nicht in einer anderen Analyseansicht abgefragt werden.
• In einer Analyseansicht können mehrere Logansichten abgefragt werden. Die Log-Buckets, in denen die abgefragten Log-Ansichten gehostet werden, müssen sich jedoch an einem Ort befinden. Angenommen, Sie haben zwei Log-Buckets, einen in us-east1 und den anderen in asia-east1. Sie können keine Analyseansicht erstellen, in der Logansichten für diese Log-Buckets abgefragt werden.
• Die übergeordnete Ressource einer Analyseansicht muss ein Google Cloud-Projekt sein. Sie können keine Analyseansicht in Ordnern oder Organisationen erstellen.
• Verknüpfte Datasets werden für Analyseansichten nicht unterstützt. Daher können Sie Analysedatenansichten nur über die Seite Loganalysen abfragen. Außerdem müssen Sie diese Abfragen über den Standard-Cloud Logging-Dienst ausführen.
• Das Erstellen oder Verwalten von Analysedatenansichten wird nicht über die API unterstützt.

• Für Analysedatenansichten gelten die folgenden Limits:

  • Maximale Anzahl von Analytics-Aufrufen pro Google Cloud-Projekt: 100
  • Maximale Anzahl von Analytics-Aufrufen pro Google Cloud-Projekt und Region: 50
  • Maximale Anzahl von Regionen pro Google Cloud-Projekt, in denen Analytics-Datenansichten gespeichert werden können: 10

Nächste Schritte

• Logs abfragen und analysieren
• SQL-Abfrage speichern und freigeben
• SQL-Abfrageergebnisse in Diagrammen darstellen
• Beispiel-SQL-Abfragen