Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

SQL-Abfragen speichern und freigeben

Mit Observability Analytics können Sie SQL-Abfragen speichern und freigeben, um häufige Cloud Logging-Prüfungen noch einmal auszuführen und mit Teammitgliedern in Ihrem Projekt zusammenzuarbeiten. Sie können gespeicherte Abfragen für Ihre eigene Verwendung privat halten oder sie für andere Projektmitglieder freigeben.

Wenn Sie noch keine Abfragen in Observability Analytics geschrieben haben, lesen Sie zuerst den Hilfeartikel Logs abfragen und analysieren. Informationen zum Erstellen von Diagrammen aus Abfrageergebnissen und zum Speichern dieser Diagramme in einem benutzerdefinierten Dashboard finden Sie unter SQL-SQL-Abfrage darstellen.

Unterschiede zwischen gespeicherten Abfragen und Analyseansichten

Eine gespeicherte Abfrage ist eine Abfrage, die Sie auf der Seite Observability Analytics ausführen und dann als Abfrage speichern. Mit der Speicheraktion können Sie diese Abfrage jederzeit noch einmal ausführen. Wenn Sie die Abfrage speichern, können Sie sie als privat festlegen oder für andere Nutzer sichtbar machen, die die erforderlichen Berechtigungen zur Verwendung von Observability Analytics haben. Sie können keine SQL-Abfrage schreiben, bei der in der FROM-Klausel eine gespeicherte Abfrage angegeben ist.

Eine Analyseansicht enthält eine Abfrage, die Sie nach Bedarf noch einmal ausführen können. Sie erstellen eine Analyseansicht, indem Sie eine SQL-Abfrage für eine Logansicht schreiben und das Ergebnis dann als Ansicht speichern. Im Gegensatz zu gespeicherten Abfragen können Sie eine Analyseansicht nicht als privat festlegen. Sie können eine Analyseansicht abfragen. Mit dieser Funktion können Sie Ihre Logdaten aus dem LogEntry-Format in ein anderes Format umwandeln, das für Sie besser geeignet ist. Anstatt Ihre Abfragen für eine Logansicht zu schreiben, fragen Sie dann die Analyseansicht ab.

Sie können Abfragen speichern, die eine Logansicht oder eine Analyseansicht abfragen.

Hinweis

In diesem Abschnitt werden die Schritte beschrieben, die Sie ausführen müssen, bevor Sie Observability Analytics verwenden können.

Log-Buckets konfigurieren

Prüfen Sie, ob für Ihre Log-Buckets ein Upgrade zur Verwendung von Observability Analytics durchgeführt wurde:

Rufen Sie in der Google Cloud -Console die Seite Logspeicher auf.
Zum Logspeicher

Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis mit der Zwischenüberschrift Logging aus.
Prüfen Sie für Log-Buckets mit einer Logansicht, die Sie abfragen möchten, ob in der Spalte Observability Analytics verfügbar die Option Öffnen angezeigt wird. Wenn Upgrade angezeigt wird, klicken Sie auf Upgrade und schließen Sie das Dialogfeld.

IAM-Rollen und ‑Berechtigungen konfigurieren

In diesem Abschnitt werden die IAM-Rollen oder -Berechtigungen beschrieben, die für die Verwendung von Observability Analytics erforderlich sind:

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zur Verwendung von Observability Analytics und zum Abfragen von Logansichten benötigen:
- So fragen Sie die Log-Buckets _Required und _Default ab: Loganzeige (roles/logging.viewer)
- So fragen Sie alle Logansichten in einem Projekt ab: Logs View Accessor (roles/logging.viewAccessor)
Sie können einen Prinzipal auf eine bestimmte Logansicht beschränken, indem Sie entweder eine IAM-Bedingung für die auf Projektebene erteilte Rolle „Logs View Accessor“ hinzufügen oder eine IAM-Bindung zur Richtliniendatei der Logansicht hinzufügen. Weitere Informationen finden Sie unter Zugriff auf eine Logansicht steuern.

Dies sind dieselben Berechtigungen, die Sie benötigen, um Logeinträge auf der Seite Log-Explorer aufzurufen. Informationen zu zusätzlichen Rollen, die Sie zum Abfragen von Ansichten in benutzerdefinierten Buckets oder zum Abfragen der _AllLogs-Ansicht des _Default-Log-Buckets benötigen, finden Sie unter Cloud Logging-Rollen.
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Observability Analytics User (roles/observability.analyticsUser) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Abfragen von Analyseansichten benötigen.

Wählen Sie die Oberfläche aus, die Sie verwenden möchten.

Console

Wenn Sie über die Google Cloud Console auf Dienste und APIs von Google Cloud zugreifen, müssen Sie die Authentifizierung nicht einrichten.

gcloud

Aktivieren Sie Cloud Shell in der Google Cloud Console.

Cloud Shell aktivieren

Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

REST

Wenn Sie die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, verwenden Sie die Anmeldedaten, die Sie der gcloud CLI bereitstellen.

Installieren Sie die Google Cloud CLI.

Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

Weitere Informationen finden Sie in der Dokumentation zur Google Cloud -Authentifizierung unter Für die Verwendung von REST authentifizieren.

Abfrage speichern

Alle von Ihnen ausgeführten Abfragen werden automatisch 30 Tage lang gespeichert und können auf der Seite Observability Analytics über den Tab Zuletzt verwendet aufgerufen werden. Sie können die auf dem Tab Zuletzt verwendet aufgeführten Abfragen suchen, ansehen, ausführen und freigeben.

Wenn Sie eine Abfrage wiederverwenden, benutzerdefinierte Beschreibungen hinzufügen oder sie mit Teammitgliedern teilen möchten, speichern Sie die Abfrage. Sie können Ihre gespeicherten Abfragen nach Name, Beschreibung und Sichtbarkeitslabel suchen und sortieren. Sie können diese Abfragen auch bearbeiten und löschen. Gespeicherte Abfragen werden beibehalten, bis Sie sie löschen.

Sie können 10.000 Abfragen pro Google Cloud Projekt speichern.

Console

So speichern Sie eine Abfrage:

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

Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis mit der Zwischenüberschrift Logging aus.
Geben Sie im Bereich Abfrage eine Abfrage ein.

Sie können den Bereich Abfrage füllen, indem Sie eine neue Abfrage eingeben, eine Abfrage auf dem Tab Zuletzt verwendet auswählen oder eine Abfrage auf dem Tab Gespeichert auswählen.

Ihre Abfrage kann jede gültige Ansicht, mehrere Ansichten und Analyseansichten enthalten.

Wenn die Abfrage im Bereich Abfrage gültig ist, ist der Button Speichern aktiviert.
Klicken Sie auf Speichern, wählen Sie Abfrage speichern aus und füllen Sie die Felder Name und Beschreibung aus. Die Werte, die Sie für diese Felder festlegen, werden auf dem Tab Gespeichert angezeigt.
Optional: Wenn Sie allen Nutzern mit Zugriff auf die Seite Observability Analytics für das Projekt Google Cloud erlauben möchten, Ihre gespeicherte Abfrage anzusehen und auszuführen, aktivieren Sie die Option Für Projekt freigeben.

Standardmäßig ist diese Option deaktiviert und die Sichtbarkeit ist auf Sie beschränkt.
Klicken Sie auf Abfrage speichern.
Optional: Wenn Sie gespeicherte Abfragen, die für Sie sichtbar sind, ansehen, sortieren und ausführen möchten, wählen Sie den Tab Gespeichert aus.

Sie können Ihre gespeicherten Abfragen nach Name, Beschreibung und Sichtbarkeitslabel sortieren und filtern. Sie können auch nach dem Inhalt der Abfrage filtern.

Sie können von Ihnen erstellte Abfragen über die Optionen auf dem Tab Gespeichert bearbeiten und löschen:

Wenn Sie eine Abfrage bearbeiten möchten, klicken Sie auf Weitere Optionen und wählen Sie Bearbeiten aus. Sie können die Werte für die Felder Name und Beschreibung ändern. Die Abfrage selbst kann jedoch nicht geändert werden.
Wenn Sie eine gespeicherte Abfrage löschen möchten, klicken Sie auf Weitere Optionen und wählen Sie Löschen aus.

gcloud

So erstellen und speichern Sie eine Abfrage:

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
- DISPLAY_NAME: Der Anzeigename der gespeicherten Abfrage.
- LOCATION: Der Speicherort für die gespeicherte Abfrage.
- VISIBILITY: Legen Sie private oder shared fest.
- SQL_QUERY: Eine SQL-Abfrage. Wenn der Pfad oder die Felder im Pfad in einfache Backquotes (`) eingeschlossen sind, müssen Sie diese Backquotes maskieren:
```
    "SELECT * FROM \`PROJECT_ID.LOCATION.my-log-bucket._AllLogs\`"
    
```
  oder
```
    "SELECT * FROM \`PROJECT_ID.LOCATION._Trace.Spans._AllSpans\`"
    
```
  Backquotes (`) sind erforderlich, wenn ein Pfadelement einen Punkt (.) enthält.
- ID: Die ID der gespeicherten Abfrage. Diese ID ist eine erforderliche Eingabe für Befehle, die eine gespeicherte Abfrage beschreiben, aktualisieren oder löschen. Wenn Sie beim Erstellen einer gespeicherten Abfrage keine ID angeben, generiert das System eine numerische ID.
- DESCRIPTION: Eine Textbeschreibung der Abfrage. Optional.
- PROJECT_ID: Die Kennung des Projekts.
Führen Sie den Befehl gcloud logging saved-queries create aus:
Linux, macOS oder Cloud Shell
```
gcloud logging saved-queries create --display-name=DISPLAY_NAME \
 --location=LOCATION --visibility=VISIBILITY --sql-query-text=SQL_QUERY \
 --id=ID --description=DESCRIPTION --project=PROJECT_ID
```
Windows (PowerShell)
```
gcloud logging saved-queries create --display-name=DISPLAY_NAME `
 --location=LOCATION --visibility=VISIBILITY --sql-query-text=SQL_QUERY `
 --id=ID --description=DESCRIPTION --project=PROJECT_ID
```
Windows (cmd.exe)
```
gcloud logging saved-queries create --display-name=DISPLAY_NAME ^
 --location=LOCATION --visibility=VISIBILITY --sql-query-text=SQL_QUERY ^
 --id=ID --description=DESCRIPTION --project=PROJECT_ID
```
Hier ist ein Beispiel für eine Antwort, wenn die im Befehl angegebene ID my-saved-query war:
```
Created saved query [projects/PROJECT_ID/locations/LOCATION/savedQueries/my-saved-query].
```
Die Antwort auf den Befehl create enthält den vollständigen Namen der Abfrage, einschließlich der Abfrage-ID. Die Abfrage-ID, in diesem Beispiel my-saved-query, ist eine erforderliche Eingabe für Google Cloud CLI-Befehle, die eine gespeicherte Abfrage beschreiben, löschen oder aktualisieren.
Führen Sie den folgenden Befehl aus, um die gespeicherte Abfrage zu prüfen:
```
 gcloud logging saved-queries list --location=- --project=PROJECT_ID
```
Im vorherigen Ausdruck ist der Wert für den Standort ein Bindestrich (-), der als Platzhalter fungiert. Sie können auch einen bestimmten Ort angeben.

Es gibt Google Cloud CLI-Befehle zum Löschen, Auflisten, Beschreiben und Aktualisieren gespeicherter Abfragen. Weitere Informationen finden Sie unter gcloud logging saved-queries – Übersicht.

REST

Sie können eine Abfrage mithilfe der Cloud Logging API speichern. Verwenden Sie zum Speichern einer Abfrage die Methode savedQueries.create.

So führen Sie diese Methode aus:

Wählen Sie savedQueries.create aus.
Verwenden Sie auf der Referenzseite den APIs Explorer, um einen Befehl auszuführen. Sie müssen das Feld opsAnalyticsQuery angeben.

Das folgende Beispiel zeigt einen Beispielanfragetext, der eine Instanz von SavedQuery enthält:

{
   "parent": "projects/my-project/locations/global"
   "saved_query":
   {
      "ops_analytics_query":
      {
         "sql_query_text" :
            "SELECT
            timestamp, log_name, severity, json_payload, resource, labels
            FROM
            `VIEW`
            WHERE
            timestamp > TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 HOUR)
            ORDER BY timestamp ASC
            LIMIT 100"
      }
   "visibility": "PRIVATE"
   }
}

Sie können eine gespeicherte Abfrage für alle Nutzer freigeben, die Zugriff auf IhrGoogle Cloud -Projekt haben. Die IAM-Rollen des Hauptkontos bestimmen jedoch, ob die Abfrage ausgeführt werden kann und welche Daten die Abfrage zurückgibt.

Console

Wenn Sie ein Problem beheben oder ungewöhnliche Ergebnisse sehen, möchten Sie möglicherweise eine Abfrage und ihre Ergebnisse mit einem Teammitglied teilen. Wenn Sie sich die Abfrageergebnisse auf der Seite Observability Analytics ansehen, können Sie eine URL kopieren, die beim Öffnen die ausgeführte Abfrage und die zugehörigen Ergebnisse anzeigt.

So geben Sie eine Abfrage und die Ergebnisse für einen Teamkollegen frei:

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

Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis mit der Zwischenüberschrift Logging aus.
Geben Sie im Bereich Abfrage eine Abfrage ein und klicken Sie dann auf Abfrage ausführen.

Sie können den Bereich Abfrage füllen, indem Sie eine neue Abfrage eingeben, eine Abfrage auf dem Tab Zuletzt verwendet auswählen oder eine Abfrage auf dem Tab Gespeichert auswählen.
Klicken Sie auf Link teilen.
Senden Sie den Link an Ihr Teammitglied.

Wenn Ihr Teammitglied den Link öffnet, wird die Seite Observability Analytics geöffnet und die Abfrage angezeigt, aber nicht ausgeführt. Ihr Teammitglied muss die Abfrage manuell ausführen.

Auf der Seite Observability Analytics wird ein Warndialogfeld angezeigt, wenn die Abfrage in der BigQuery-Engine ausgeführt wird und die abgefragten Ressourcen nicht zur selben Eigentumsgrenze gehören. Die Eigentumsgrenzen werden durch mehrere Faktoren bestimmt, darunter die Hierarchie der Ressourcen, die die Abfrage verwendet.

Damit die URL erfolgreich geöffnet werden kann, muss die IAM-Rolle Ihres Teammitglieds im Projekt Google Cloud die Berechtigungen enthalten, die zum Aufrufen der Seite Observability Analytics erforderlich sind.

gcloud

Wenn Sie eine gespeicherte Abfrage erstellen möchten, die von anderen ausgeführt werden kann, setzen Sie den Wert des Felds visibility auf shared:

--visibility=shared

Verwenden Sie den Befehl update, um die Sichtbarkeit einer vorhandenen gespeicherten Abfrage zu ändern. Weitere Informationen zu den verfügbaren Befehlen finden Sie in der Übersicht zu gcloud logging saved-queries.

REST

Sie können die Logging API verwenden, um eine freigegebene Abfrage mit der Methode savedQueries.create zu erstellen und im Feld visibility den Wert SHARED anzugeben. Weitere Informationen finden Sie auf der Referenzseite für savedQueries.create.

Letzte oder gespeicherte Abfragen ansehen und ausführen

Wenn Sie eine Abfrage ansehen oder noch einmal ausführen möchten, wählen Sie auf der Seite Observability Analytics den Tab Zuletzt verwendet aus und suchen Sie die Abfrage:

Klicken Sie zum Ausführen der Abfrage auf Ausführen.
Wenn Sie die Abfrage aufrufen möchten, verwenden Sie die Optionen im Menü Weitere Optionen.

Wenn Sie eine gespeicherte Abfrage ansehen, bearbeiten oder ausführen möchten, wählen Sie auf der Seite Observability Analytics den Tab Gespeichert aus und suchen Sie nach der Abfrage:

Klicken Sie zum Ausführen der Abfrage auf Ausführen.
Wenn Sie die Abfrage bearbeiten, ansehen oder löschen möchten, verwenden Sie die Optionen im Menü Weitere Optionen.

SQL-Abfragen speichern und freigeben Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Unterschiede zwischen gespeicherten Abfragen und Analyseansichten

Hinweis

Log-Buckets konfigurieren

IAM-Rollen und ‑Berechtigungen konfigurieren

Wählen Sie die Oberfläche aus, die Sie verwenden möchten.

Console

gcloud

REST

Abfrage speichern

Console

gcloud

Linux, macOS oder Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST

Abfrage teilen

Console

gcloud

REST

Letzte oder gespeicherte Abfragen ansehen und ausführen

Nächste Schritte

SQL-Abfragen speichern und freigeben