Membuat, membuat kueri, dan mengelola tampilan analisis

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

Dokumen ini menjelaskan cara membuat, mengelola, dan membuat kueri tampilan analisis. Untuk ringkasan konseptual, lihat Tentang tampilan analisis.

Sebelum memulai

Catatan: Tidak ada peran Identity and Access Management (IAM) Cloud Logging bawaan yang berisi izin yang diperlukan untuk membuat atau membuat kueri tampilan analisis.

Karena tampilan analisis membuat kueri tampilan log, untuk membuat dan membuat kueri tampilan analisis, peran IAM Anda juga harus mengizinkan Anda membuat kueri tampilan log dan menggunakan Log Analytics. Bagian ini mencantumkan peran IAM yang diperlukan untuk membuat tampilan analisis, dan peran yang diperlukan untuk mengkueri tampilan log dan menggunakan Log Analytics:

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

  Peran bawaan ini berisi izin yang diperlukan untuk membuat, mengelola, dan menggunakan tampilan analisis. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

  Izin yang diperlukan

  Izin berikut diperlukan untuk membuat, mengelola, dan menggunakan tampilan analisis:

  • observability.analyticsViews.get
  • observability.analyticsViews.list
  • observability.analyticsViews.create
  • observability.analyticsViews.update
  • observability.analyticsViews.delete

• Untuk mendapatkan izin yang Anda perlukan guna membuat kueri tampilan log dan menggunakan Log Analytics, 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.

  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.

Membuat tampilan analisis

Catatan: Tampilan analisis hanya dapat membuat kueri tampilan log. Saat beberapa tampilan log dikueri, bucket log yang menghosting tampilan log ini harus berada di satu lokasi. Misalnya, jika memiliki dua bucket log di lokasi us-east1, Anda akan membuat tampilan analisis yang membuat kueri tampilan log di bucket log tersebut.

Untuk membuat tampilan analisis, 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. Di menu Tampilan, buka bagian Logs segment, lalu pilih tampilan log yang akan dikueri.

   Untuk menemukan tampilan log, Anda dapat menggunakan panel Filter atau men-scroll daftar tampilan log. Setiap entri dalam daftar menggunakan format BUCKET_ID.LOG_VIEW_ID berikut, dengan kolom ini merujuk ke ID bucket log dan tampilan log.

3. Di toolbar Schema, klik Query.

   Panel Kueri diperbarui dengan kueri SQL.

4. Pastikan toolbar menampilkan Run query.

   Jika toolbar menampilkan Run in BigQuery, klik Settings, lalu pilih Log Analytics (default).

5. Perbarui kueri SQL di panel Kueri hingga Anda puas dengan hasil kueri.

6. Di toolbar, klik save Save, lalu pilih Save as analytics view.

7. Masukkan nama dan deskripsi untuk tampilan analisis, lalu klik Simpan.

   Nama dibatasi hingga 100 karakter dan hanya boleh berisi huruf, angka, garis bawah, dan tanda hubung.

   Catatan: Anda tidak dapat mengubah nama tampilan analisis setelah dibuat. Anda dapat mengubah deskripsi dan kueri.

   Tampilan analisis Anda dibuat dan tercantum di panel Tampilan, di bagian berjudul data_table Tampilan Analytics. Setiap entri dalam daftar menggunakan format LOCATION.ANALYTICS_VIEW_ID berikut, dengan kolom ini merujuk ke lokasi dan ID tampilan analisis. Misalnya, jika Anda membuat tampilan analisis dengan nama my-analytic-view yang mengkueri tampilan log yang bucket log-nya berada di region global, bagian ini akan menampilkan global.my-analytic-view.

Membuat kueri tampilan analisis

Setelah tampilan analisis ada, Anda dapat mengkueri tampilan tersebut dengan cara yang sama seperti mengkueri tampilan log. Untuk mengetahui daftar dokumen yang menjelaskan cara menggunakan halaman Log Analytics, lihat bagian Langkah berikutnya dalam dokumen ini.

Untuk menjalankan kueri default untuk tampilan analisis, 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. Masukkan kueri atau muat kueri default untuk tampilan analisis. Klausa FROM untuk kueri Anda harus memiliki format berikut:

   FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`
   

   Dalam ekspresi sebelumnya, kolom memiliki arti berikut:

   • PROJECT_ID: ID project.
   • LOCATION: Lokasi tampilan analisis. Lokasi tampilan analisis diwarisi dari resource yang dikueri. Misalnya, jika tampilan analisis membuat kueri tampilan log yang berada di lokasi global, lokasi tampilan analisis juga akan menjadi global.
   • ANALYTICS_VIEW_ID: ID tampilan analisis, yang dibatasi hingga 100 karakter dan hanya dapat menyertakan huruf, angka, garis bawah, dan tanda hubung.

   Untuk menjalankan kueri default, lakukan hal berikut:

   1. Di menu Tampilan, buka bagian Tampilan Analytics data_table, lalu pilih tampilan analisis yang ingin Anda buat kueri.

      Untuk menemukan tampilan analisis, Anda dapat menggunakan panel Filter atau men-scroll daftar tampilan analisis. Setiap entri dalam daftar menggunakan format LOCATION.ANALYTICS_VIEW_ID berikut, dengan kolom ini merujuk ke lokasi dan ID tampilan analisis.

   2. Di toolbar Schema, klik Query.

      Panel Kueri diperbarui dengan kueri SQL yang mengkueri tampilan analisis yang Anda pilih.

3. Klik Run query.

   Jika toolbar menampilkan Run in BigQuery, klik Settings, lalu pilih Log Analytics (default).

Mencantumkan tampilan analisis

Untuk mencantumkan tampilan analisis di project Google Cloud Anda, 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. Di menu Tampilan, buka bagian Tampilan Analytics data_table.

   Daftar tampilan analisis akan ditampilkan. Setiap entri dalam daftar menggunakan format LOCATION.ANALYTICS_VIEW_ID berikut, dengan kolom ini merujuk ke lokasi dan ID tampilan analisis. Misalnya, jika Anda membuat tampilan analisis dengan nama my-analytic-view yang mengkueri tampilan log yang bucket log-nya berada di region global, bagian ini akan menampilkan global.my-analytic-view.

3. Untuk melihat detail tampilan analisis tertentu, lakukan hal berikut:

   1. Pilih tampilan analisis.

      Skema tampilan analisis ditampilkan di bagian Schema.

   2. Di toolbar Skema, klik Lihat opsi tampilan analisis, lalu pilih Lihat detail.

      Dialog ini menampilkan informasi tentang tampilan analisis, termasuk waktu tampilan analisis dibuat, skema, dan kueri.

Mengubah tampilan analisis

Untuk mengubah tampilan analisis, 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. Di menu Tampilan, buka bagian Tampilan Analytics data_table, lalu pilih tampilan analisis yang ingin Anda buat kueri.

3. Di toolbar Skema, klik Lihat opsi tampilan analisis, lalu pilih Edit tampilan.

   Dialog akan terbuka yang menampilkan informasi tentang tampilan analisis. Anda dapat mengubah deskripsi dan kueri.

4. Setelah melakukan perubahan, klik Ganti tampilan tersimpan.

Menghapus tampilan analisis

Catatan: Jika Anda telah menulis kueri terhadap tampilan analisis dan menghapus tampilan analisis, kueri tersebut akan gagal.

Untuk menghapus tampilan analisis, lakukan langkah-langkah 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. Di menu Tampilan, buka bagian Tampilan Analytics data_table, lalu pilih tampilan analisis yang ingin Anda buat kueri.
3. Di toolbar Schema, klik View analytics view options, pilih Delete view, lalu selesaikan dialog.

Batasan

Batasan berikut berlaku untuk tampilan analisis:

• Tampilan analisis tidak dapat mengkueri tampilan analisis lain.
• Tampilan analisis dapat membuat kueri beberapa tampilan log. Namun, bucket log yang menghosting tampilan log yang dikueri harus berada di satu lokasi. Misalnya, Anda memiliki dua bucket log, satu di us-east1 dan satu lagi di asia-east1. Anda tidak dapat membuat tampilan analisis yang membuat kueri tampilan log di bucket log tersebut.
• Resource induk tampilan analisis harus berupa project Google Cloud. Anda tidak dapat membuat tampilan analisis di folder atau organisasi.
• Set data tertaut tidak didukung untuk tampilan analisis. Oleh karena itu, Anda dapat membuat kueri tampilan analisis hanya dengan menggunakan halaman Log Analytics. Selain itu, Anda harus menjalankan kueri tersebut di layanan Cloud Logging default.
• Tidak ada dukungan API untuk membuat atau mengelola tampilan analisis.

• Batas berikut berlaku untuk tampilan analisis:

  • Jumlah maksimum tampilan analisis per project Google Cloud: 100
  • Per project Google Cloud, jumlah maksimum tampilan analisis per region: 50
  • Per project Google Cloud, jumlah maksimum region yang dapat menyimpan tampilan analisis: 10

Langkah selanjutnya

• Ringkasan cara membuat kueri dan menganalisis log
• Menyimpan dan membagikan kueri SQL
• Membuat diagram hasil kueri SQL
• Contoh kueri SQL