SQL-Abfragen speichern oder freigeben

In diesem Dokument wird beschrieben, wie Sie Abfragen speichern und freigeben, die Sie in Log Analytics erstellen.

Informationen zum Erstellen von Diagrammen für Ihre Abfragen und Beispielabfragen finden Sie in den Dokumenten, die im Abschnitt Weitere Informationen dieses Dokuments aufgeführt sind.

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 Laden der Seite Loganalysen, zum Schreiben, Ausführen und Speichern privater Abfragen 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.

   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.

   Hinweis: Wenn Sie freigegebene Abfragen erstellen und verwalten möchten, reichen die vorherigen IAM-Rollen nicht aus. Zum Erstellen und Verwalten gemeinsamer Abfragen müssen Ihre IAM-Rollen die Berechtigungen logging.queries.{share, updateShared, deleteShared} enthalten.

Abfrage speichern

Alle Abfragen, die Sie ausführen, werden automatisch für 30 Tage gespeichert und sind auf der Seite Loganalysen über den Tab Letzte verfügbar. Sie können die Abfragen auf dem Tab Letzte suchen, ansehen, ausführen und teilen.

Wenn Sie eine Abfrage für die zukünftige Verwendung verfügbar halten möchten, versehen Sie sie mit für Sie nützlichen Informationen oder lassen Sie Teammitglieder Ihre Abfrage ansehen und ausführen. Speichern Sie die Abfrage dann. Sie können Ihre gespeicherten Abfragen nach Name, Beschreibung und Sichtbarkeitslabel durchsuchen 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:

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. Füllen Sie den Bereich Abfrage mit einer Abfrage aus.

   Sie können das Feld Abfrage füllen, indem Sie eine neue Abfrage eingeben, eine Abfrage auf dem Tab Letzte auswählen oder eine Abfrage auf dem Tab Gespeichert auswählen.

   Ihre Abfrage kann eine beliebige gültige Ansicht, mehrere Ansichten und Analytics-Ansichten enthalten.

   Wenn die Abfrage im Bereich Abfrage gültig ist, ist die Schaltfläche Speichern save aktiviert.

3. Klicken Sie auf Speichern 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.

4. Optional: Wenn Sie möchten, dass alle Nutzer mit Zugriff auf die Seite Loganalysen für die Projektansicht Google Cloud Ihre gespeicherte Abfrage ausführen können, aktivieren Sie die Ein/Aus-Schaltfläche Für Projekt freigeben.

   Standardmäßig ist diese Ein/Aus-Schaltfläche deaktiviert und die Sichtbarkeit ist auf Sie beschränkt.

5. Klicken Sie auf Abfrage speichern.

6. Optional: Wenn Sie gespeicherte Abfragen ansehen, sortieren und ausführen möchten, die für Sie sichtbar sind, 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 Anfrage filtern.

Sie können Abfragen, die Sie erstellt haben, über 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 bearbeitet werden.

• Wenn Sie eine gespeicherte Abfrage löschen möchten, klicken Sie auf das Dreipunkt-Menü  Weitere Optionen und wählen Sie Löschen aus.

Abfrage freigeben

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 zurückgegeben werden.

Console

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

So teilen Sie eine Abfrage und Ergebnisse mit einem Teammitglied:

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. Fügen Sie eine Abfrage in den Bereich Abfrage ein und klicken Sie dann auf Abfrage ausführen.

   Sie können das Feld Abfrage füllen, indem Sie eine neue Abfrage eingeben, eine Abfrage auf dem Tab Letzte auswählen oder eine Abfrage auf dem Tab Gespeichert auswählen.

3. Klicken Sie auf  Link teilen.

4. Senden Sie den Link an Ihr Teammitglied.

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

   Auf der Seite Log Analytics wird ein Warndialogfeld angezeigt, wenn die Abfrage in der BigQuery-Engine ausgeführt wird und sich die abgefragten Ressourcen nicht in derselben Eigentumsgrenze befinden. Die Grenzen für die Inhaberschaft werden durch mehrere Faktoren bestimmt, darunter die Hierarchie der Ressourcen, die in der Abfrage verwendet werden.

   Damit sich die URL öffnen lässt, muss die IAM-Rolle Ihres Teammitglieds für das Google Cloud -Projekt die Berechtigungen enthalten, die zum Aufrufen der Seite Loganalysen erforderlich sind.

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 Log Analytics den Tab Aktuell 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 aufrufen, bearbeiten oder ausführen möchten, wählen Sie auf der Seite Loganalysen den Tab Gespeichert aus und suchen Sie nach der Abfrage:

• Klicken Sie zum Ausführen der Abfrage auf Ausführen.
• Verwenden Sie die Optionen im Dreipunkt-Menü , um die Abfrage zu bearbeiten, anzusehen oder zu löschen.

Nächste Schritte

• SQL-SQL-Abfrage darstellen
• SQL-Beispielabfragen