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 Anda. Jika Anda belum memahami topik ini, lihat Membuat kueri dan menganalisis log.

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

Perbedaan kueri tersimpan dengan tampilan analisis

Kueri tersimpan adalah kueri yang Anda jalankan menggunakan halaman Log Analytics, lalu disimpan sebagai kueri. Tindakan simpan memungkinkan Anda menjalankan kembali kueri ini kapan saja. Saat menyimpan kueri, Anda memiliki opsi untuk menjadikannya pribadi bagi Anda, atau Anda dapat membuatnya terlihat oleh orang lain yang memiliki izin yang diperlukan untuk menggunakan Log Analytics. Anda tidak dapat menulis kueri SQL dengan klausa FROM yang menentukan kueri tersimpan.

Tampilan analisis berisi kueri yang dapat Anda jalankan ulang kapan saja. Anda membuat tampilan analisis dengan menulis kueri SQL terhadap tampilan log, lalu menyimpan hasilnya sebagai tampilan. Tidak seperti kueri tersimpan, Anda tidak dapat menjadikan tampilan analisis pribadi untuk diri sendiri. Anda dapat mengkueri tampilan analisis. Kemampuan ini memungkinkan Anda mengubah data log dari format LogEntry menjadi format lain yang lebih sesuai untuk Anda. Kemudian, alih-alih menulis kueri terhadap tampilan log, Anda membuat kueri tampilan analisis.

Anda dapat menyimpan kueri yang membuat kueri tampilan log atau tampilan analisis.

Sebelum memulai

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

Mengonfigurasi bucket log

Pastikan bucket log Anda telah diupgrade untuk menggunakan Log Analytics:

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

   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 kueri, 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 untuk menggunakan Log Analytics dan membuat kueri tampilan log, 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.

• Untuk mendapatkan izin yang Anda perlukan guna mengkueri tampilan analisis, minta administrator Anda untuk memberi Anda peran IAM Observability Analytics User (roles/observability.analyticsUser) di project Anda.

Menyimpan kueri

Semua kueri yang Anda jalankan akan otomatis disimpan selama 30 hari dan dapat diakses dengan memilih tab Baru-baru ini 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 .

{
   "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 Google Cloud project Anda. Namun, peran IAM akun utama menentukan apakah kueri dapat dijalankan dan data yang ditampilkan kueri.

Melihat dan menjalankan kueri terbaru atau tersimpan

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

• Untuk menjalankan kueri, klik Run.
• Untuk melihat kueri, gunakan opsi di menu more_vert 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 more_vert Opsi Lainnya.

Langkah berikutnya

• Membuat dan membuat kueri tampilan analisis
• Contoh kueri SQL
• Membuat diagram hasil kueri SQL
• Mengkueri set data tertaut di BigQuery