Membuat, membuat kueri, dan mengelola tampilan analisis

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

Sebelum memulai

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

• Untuk mendapatkan izin yang Anda perlukan guna membuat, mengelola, dan menggunakan tampilan analisis, minta administrator Anda 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 diperlukan untuk 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 dibuat 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

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

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

3. Di toolbar Schema, klik Query.

   Panel Query diperbarui dengan kueri SQL.

4. Pastikan toolbar menampilkan Run query.

   Jika toolbar menampilkan Jalankan di BigQuery, klik settings Setelan, lalu pilih Log Analytics (default).

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

6. Di toolbar, klik simpan Simpan, lalu pilih Simpan sebagai tampilan analisis.

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

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

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

Membuat kueri tampilan analisis

Setelah tampilan analisis ada, Anda dapat membuat kueri dengan cara yang sama seperti membuat kueri 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. Klausul 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 dikuerinya. Misalnya, jika tampilan analisis membuat kueri tampilan log yang berada di lokasi global, maka lokasi tampilan analisis juga 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 Views, buka bagian data_table Analytics Views, lalu pilih tampilan analisis yang ingin Anda kueri.

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

   2. Di toolbar Schema, klik Query.

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

3. Klik Run query.

   Jika toolbar menampilkan Jalankan di BigQuery, klik settings Setelan, 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 Penayangan, buka bagian data_table Tampilan Analytics.

   Daftar tampilan analisis akan ditampilkan. Setiap entri dalam daftar memiliki format LOCATION.ANALYTICS_VIEW_ID, dengan kolom ini merujuk ke lokasi dan ID tampilan analisis. Misalnya, jika Anda membuat tampilan analisis dengan nama my-analytic-view yang membuat kueri tampilan log yang bucket lognya berada di region global, maka 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 more_vert Lihat opsi tampilan analisis, lalu pilih Lihat detail.

      Dialog menampilkan informasi tentang tampilan analisis, termasuk waktu pembuatan tampilan analisis, 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 Views, buka bagian data_table Analytics Views, lalu pilih tampilan analisis yang ingin Anda kueri.

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

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

4. Setelah Anda melakukan modifikasi, klik Ganti tampilan tersimpan.

Menghapus tampilan analisis

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 Views, buka bagian data_table Analytics Views, lalu pilih tampilan analisis yang ingin Anda kueri.
3. Di toolbar Skema, klik more_vert Lihat opsi tampilan analisis, pilih Hapus tampilan, 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 yang lainnya di asia-east1. Anda tidak dapat membuat tampilan analisis yang membuat kueri tampilan log di bucket log tersebut.
• Resource induk tampilan analisis harus berupa Google Cloud project. Anda tidak dapat membuat tampilan analisis di folder atau organisasi.
• Set data tertaut tidak didukung untuk tampilan analisis. Oleh karena itu, Anda hanya dapat membuat kueri tampilan analisis 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.

• Batasan berikut berlaku untuk tampilan analisis:

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

Langkah berikutnya

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