Menyimpan dan membagikan kueri SQL

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

Dokumen ini mengasumsikan bahwa Anda sudah memahami Log Analytics dan cara menggunakan halaman Log Analytics untuk membuat kueri data log. Jika Anda tidak terbiasa dengan topik ini, lihat Membuat kueri dan menganalisis log.

Untuk mempelajari cara memetakan hasil kueri dan cara menyimpan diagram tersebut ke dasbor kustom, lihat Membuat diagram hasil kueri SQL.

Sebelum memulai

Bagian ini menjelaskan langkah-langkah yang harus Anda selesaikan sebelum dapat menggunakan Log Analytics.

Mengonfigurasi bucket log

Pastikan bucket log Anda telah diupgrade untuk menggunakan Log Analytics:

  1. Di konsol Google Cloud, buka halaman Logs Storage:

    Buka Penyimpanan Log

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

  2. Untuk setiap bucket log yang memiliki tampilan log yang ingin Anda buat kuerinya, pastikan kolom Log Analytics tersedia menampilkan Buka. Jika Upgrade ditampilkan, klik Upgrade dan selesaikan dialog.

Mengonfigurasi peran dan izin IAM

Bagian ini menjelaskan peran atau izin IAM yang diperlukan untuk menggunakan Log Analytics:

  • Untuk mendapatkan izin yang diperlukan guna menggunakan Log Analytics dan tampilan log kueri, minta administrator untuk memberi Anda peran IAM berikut di project Anda:

    • Untuk membuat kueri bucket log _Required dan _Default: Logs Viewer (roles/logging.viewer)
    • Untuk membuat kueri semua tampilan log dalam project: Logs View Accessor (roles/logging.viewAccessor)

    Anda dapat membatasi akun utama ke tampilan log tertentu dengan menambahkan kondisi IAM ke pemberian peran Logs View Accessor yang dilakukan di tingkat project, atau dengan menambahkan binding IAM ke file kebijakan tampilan log. Untuk mengetahui informasi selengkapnya, lihat Mengontrol akses ke tampilan log.

    Izin ini sama dengan izin yang Anda perlukan untuk melihat entri log di halaman Logs Explorer. Untuk mengetahui informasi tentang peran tambahan yang Anda perlukan untuk membuat kueri tampilan di bucket yang ditentukan pengguna atau untuk membuat kueri tampilan _AllLogs dari bucket log _Default, lihat Peran Cloud Logging.

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 membuat kueri tetap tersedia untuk digunakan di masa mendatang, anotasikan 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 disimpan 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 Kueri dengan memasukkan kueri baru, dengan memilih kueri dari tab Terbaru, atau dengan memilih kueri dari tab Tersimpan.

    Jika kueri di panel Kueri valid, Simpan akan diaktifkan.

  3. Klik Simpan dan isi kolom Nama dan Deskripsi. Nilai yang Anda tetapkan untuk kolom ini ditampilkan di tab Tersimpan.

  4. Opsional: Agar 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 dapat Anda lihat, pilih tab Tersimpan.

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

Anda dapat mengedit dan menghapus kueri yang dibuat 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.

API

Untuk menyimpan kueri menggunakan Logging API, gunakan metode savedQueries.create. Untuk informasi selengkapnya tentang metode ini, parameternya, dan data respons, lihat halaman referensi untuk savedQueries.create.

Anda dapat menjalankan metode savedQueries.create menggunakan widget APIs Explorer di halaman referensi metode. Untuk kueri Log Analytics, Anda harus menentukan kolom opsAnalyticsQuery. Contoh berikut mengilustrasikan contoh isi permintaan, yang berisi instance SavedQuery:

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

Membagikan kueri

Anda dapat membagikan kueri tersimpan kepada semua orang yang memiliki akses ke project Google Cloud Anda. Namun, peran IAM akun utama 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, saat dibuka, akan menampilkan kueri yang Anda jalankan dan hasilnya.

Untuk membagikan kueri dan hasil dengan 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 Kueri dengan memasukkan kueri baru, dengan memilih kueri dari tab Terbaru, atau dengan memilih kueri dari tab Tersimpan.

  3. Klik Bagikan link.

  4. Kirim link ke rekan satu tim Anda.

    Saat rekan tim Anda membuka link, halaman Log Analytics akan terbuka. Halaman ini menampilkan kueri yang Anda jalankan dan hasil kueri.

    Agar berhasil membuka URL, peran Identity and Access Management rekan tim Anda di project Google Cloud harus menyertakan izin yang diperlukan untuk melihat halaman Logging.

API

Anda dapat menggunakan Logging API untuk membuat kueri bersama dengan menggunakan metode savedQueries.Create, dan menentukan nilai SHARED di kolom visibility. Untuk informasi selengkapnya, lihat halaman referensi untuk savedQueries.create.

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 dan temukan kueri:

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

Langkah selanjutnya