Menyimpan atau membagikan kueri SQL

Dokumen ini menjelaskan cara menyimpan dan membagikan kueri yang Anda buat di Log Analytics.

Untuk mengetahui informasi tentang cara membuat diagram kueri atau contoh kueri, lihat dokumen yang tercantum di bagian Langkah berikutnya dalam dokumen ini.

Sebelum memulai

Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

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.

Aktifkan Observability API.

Peran yang diperlukan untuk mengaktifkan API

Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), yang berisi izin serviceusage.services.enable. Pelajari cara memberikan peran.

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

Aktifkan Observability API.

Peran yang diperlukan untuk mengaktifkan API

Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), yang berisi izin serviceusage.services.enable. Pelajari cara memberikan peran.

Mengaktifkan API

1. Untuk mendapatkan izin yang Anda perlukan untuk memuat halaman Log Analytics, menulis, menjalankan, dan menyimpan kueri pribadi, minta administrator untuk memberi Anda peran IAM berikut:

   • Pengakses Tampilan Observasi (roles/observability.viewAccessor) pada tampilan observasi yang ingin Anda kueri. Peran ini mendukung kondisi IAM, yang memungkinkan Anda membatasi pemberian akses ke tampilan tertentu. Jika Anda tidak melampirkan kondisi pada pemberian peran, akun utama dapat mengakses semua tampilan kemampuan pengamatan. Tampilan kemampuan pengamatan tersedia dalam Pratinjau Publik.
   • Pengguna Analytics Observabilitas (roles/observability.analyticsUser) di project Anda. Peran ini berisi izin yang diperlukan untuk menyimpan dan menjalankan kueri pribadi, serta menjalankan kueri bersama.
   • Logs Viewer (roles/logging.viewer) di project Anda.
   • Logs View Accessor (roles/logging.viewAccessor) di project yang menyimpan tampilan log yang ingin Anda kueri.

   Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

   Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

   Catatan: Jika Anda ingin membuat dan mengelola kueri bersama, peran IAM sebelumnya tidak cukup. Untuk membuat dan mengelola kueri bersama, peran IAM Anda harus menyertakan izin logging.queries.{share, updateShared, deleteShared}.

Menyimpan kueri

Semua kueri yang Anda jalankan akan otomatis disimpan selama 30 hari dan dapat diakses dengan memilih tab Terbaru di halaman Log Analytics. Anda dapat menelusuri, melihat, menjalankan, dan membagikan kueri yang tercantum di tab Terbaru.

Jika Anda ingin menyimpan kueri agar tersedia untuk digunakan di masa mendatang, beri anotasi dengan informasi yang berguna bagi Anda, atau izinkan rekan tim melihat dan menjalankan kueri Anda, lalu simpan kueri. Anda dapat menelusuri dan mengurutkan kueri tersimpan berdasarkan nama, deskripsi, dan label visibilitasnya. Anda juga dapat mengedit dan menghapus kueri ini. Kueri yang Anda simpan akan dipertahankan hingga Anda menghapusnya.

Anda dapat menyimpan 10.000 kueri per project Google Cloud .

Konsol

Untuk menyimpan kueri, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman Log Analytics:

   Buka Log Analytics

   Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Logging.

2. Isi panel Query dengan kueri.

   Anda dapat mengisi panel Query dengan memasukkan kueri baru, memilih kueri dari tab Terbaru, atau memilih kueri dari tab Tersimpan.

   Kueri Anda dapat menyertakan tampilan yang valid, beberapa tampilan, dan tampilan analisis.

   Jika kueri di panel Query valid, tombol simpan Simpan akan diaktifkan.

3. Klik simpan Simpan, pilih Simpan kueri, lalu isi kolom Nama dan Deskripsi. Nilai yang Anda tetapkan untuk kolom ini ditampilkan di tab Tersimpan.

4. Opsional: Untuk mengizinkan semua orang yang memiliki akses ke halaman Log Analytics untuk tampilan project Google Cloud dan menjalankan kueri tersimpan Anda, aktifkan tombol Bagikan dengan project.

   Secara default, tombol ini dinonaktifkan dan visibilitasnya dibatasi untuk Anda.

5. Klik Simpan kueri.

6. Opsional: Untuk melihat, mengurutkan, dan menjalankan kueri tersimpan yang terlihat oleh Anda, pilih tab Tersimpan.

   Anda dapat mengurutkan dan memfilter kueri tersimpan menurut nama, deskripsi, dan label visibilitasnya. Anda juga dapat memfilter menurut isi kueri.

Anda dapat mengedit dan menghapus kueri yang Anda buat menggunakan opsi di tab Tersimpan:

• Untuk mengedit kueri, klik Opsi Lainnya, lalu pilih Edit. Anda dapat mengubah nilai untuk kolom Nama dan Deskripsi; namun, kueri itu sendiri tidak dapat diubah.

• Untuk menghapus kueri tersimpan, klik Opsi Lainnya, lalu pilih Hapus.

Membagikan kueri

Anda dapat membagikan kueri tersimpan kepada semua orang yang memiliki akses ke Google Cloud project Anda. Namun, peran IAM prinsipal menentukan apakah kueri dapat dijalankan dan data yang ditampilkan kueri.

Konsol

Saat memecahkan masalah, atau saat melihat hasil yang tidak normal, Anda mungkin ingin membagikan kueri dan hasilnya kepada rekan tim. Saat melihat hasil kueri di halaman Log Analytics, Anda dapat menyalin URL yang, jika dibuka, akan menampilkan kueri yang Anda jalankan dan hasilnya.

Untuk membagikan kueri dan hasil kepada rekan tim, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman Log Analytics:

   Buka Log Analytics

   Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Logging.

2. Isi panel Query dengan kueri, lalu klik Run query.

   Anda dapat mengisi panel Query dengan memasukkan kueri baru, memilih kueri dari tab Terbaru, atau memilih kueri dari tab Tersimpan.

3. Klik Bagikan link.

4. Kirim link tersebut ke rekan tim Anda.

   Saat rekan tim Anda membuka link, halaman Log Analytics akan terbuka dan menampilkan, tetapi tidak menjalankan, kueri. Rekan tim Anda harus menjalankan kueri secara manual.

   Halaman Log Analytics menampilkan dialog peringatan saat kueri berjalan di mesin BigQuery dan resource yang dikueri tidak berada dalam batas kepemilikan yang sama. Batas kepemilikan ditentukan oleh beberapa faktor, salah satunya adalah hierarki resource yang digunakan kueri.

   Agar URL berhasil dibuka, peran IAM rekan tim Anda di project Google Cloud harus menyertakan izin yang diperlukan untuk melihat halaman Log Analytics.

Melihat dan menjalankan kueri terbaru atau tersimpan

Untuk melihat atau menjalankan kembali kueri, pilih tab Terbaru di halaman Log Analytics, lalu temukan kueri:

• Untuk menjalankan kueri, klik Run.
• Untuk melihat kueri, gunakan opsi di menu Opsi Lainnya.

Untuk melihat, mengedit, atau menjalankan kueri tersimpan, pilih tab Tersimpan di halaman Log Analytics, lalu temukan kueri:

• Untuk menjalankan kueri, klik Run.
• Untuk mengedit, melihat, atau menghapus kueri, gunakan opsi di menu Opsi Lainnya.

Langkah berikutnya

• Membuat diagram hasil kueri SQL.
• Contoh kueri SQL.