Membuat, membuat kueri, dan mengelola tampilan analisis

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Dokumen ini menjelaskan cara membuat dan mengelola tampilan analisis. Setelah membuat tampilan analisis, Anda dapat membuat kueri dengan cara yang mirip dengan membuat kueri tampilan log dan tampilan kemampuan pengamatan.

Untuk ringkasan tampilan analisis, lihat artikel Tentang tampilan analisis.

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 membuat, mengelola, dan menggunakan tampilan analisis, 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. Anda dapat membatasi pemberian peran ini ke tampilan tertentu dengan menambahkan kondisi IAM.

   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.

2. Pastikan Anda memiliki setidaknya salah satu hal berikut:
   • Bucket log yang diupgrade untuk menggunakan Log Analytics. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi bucket log.
   • Tampilan kemampuan observasi. Untuk mempelajari lebih lanjut, lihat Model penyimpanan Cloud Trace.

Membuat tampilan analisis

Catatan: Tampilan analisis dapat membuat kueri tampilan log dan tampilan kemampuan observasi. Jika tampilan analisis mengirimkan kueri ke beberapa tampilan, maka tampilan tersebut harus berada di lokasi yang sama. Misalnya, jika Anda memiliki dua bucket log di lokasi us-east1, Anda dapat membuat tampilan analisis yang membuat kueri tampilan log pada dua bucket log tersebut.

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. Konfigurasi halaman Log Analytics:
   1. Pastikan toolbar menampilkan Run query. Jika toolbar menampilkan Jalankan di BigQuery, maka klik Setelan, lalu pilih Log Analytics (default).
   2. Jika menu Views tidak ditampilkan, buka panel navigasi dan klik Views and Schema.

3. Masukkan dan validasi kueri yang ingin Anda simpan sebagai tampilan analisis.

   Anda mungkin ingin memuat dan mengedit kueri default untuk tampilan log atau tampilan observasi yang akan dikueri oleh tampilan analisis Anda. Untuk memuat kueri default, lakukan hal berikut:

   1. Di menu Views, lalu lakukan salah satu tindakan berikut:

      • Buka bagian segment Log, lalu pilih tampilan log.
      • Buka bagian Traces, lalu pilih _Trace.Spans._AllSpans.

   2. Di toolbar Schema, klik Query, lalu klik Overwrite.

      Panel Query diperbarui dengan kueri SQL.

   3. Perbarui kueri hingga Anda puas dengan hasil kueri.

4. Membuat tampilan analisis:

   1. Di toolbar, klik Simpan Simpan, lalu pilih Simpan sebagai tampilan analisis.

   2. Masukkan nama dan deskripsi untuk tampilan analisis.

      Nama dibatasi hingga 100 karakter dan hanya boleh menyertakan huruf, angka, garis bawah, dan tanda hubung. Anda tidak dapat mengubah nama setelah Anda membuat tampilan analisis.

   3. Klik Simpan.

   Sistem akan membuat tampilan analisis Anda dan mencantumkannya di panel Tampilan, di bagian Tampilan Analytics data_table.

Membuat kueri tampilan analisis

Anda membuat kueri tampilan analisis dengan cara yang serupa dengan membuat kueri tampilan log dan tampilan kemampuan pengamatan. Untuk membuat kueri tampilan analisis, gunakan format berikut untuk klausa FROM:

FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`

Kolom dalam ekspresi sebelumnya memiliki arti berikut:

• PROJECT_ID: ID project.
• LOCATION: Lokasi tampilan analisis.
• ANALYTICS_VIEW_ID: ID tampilan analisis, yang dibatasi hingga 100 karakter dan hanya dapat menyertakan huruf, angka, garis bawah, dan tanda hubung.

Untuk mempelajari lebih lanjut, lihat Log Analytics.

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. Konfigurasi halaman Log Analytics:
   1. Pastikan toolbar menampilkan Run query. Jika toolbar menampilkan Jalankan di BigQuery, maka klik Setelan, lalu pilih Log Analytics (default).
   2. Jika menu Views tidak ditampilkan, buka panel navigasi dan klik Views and Schema.

3. Di menu Tampilan, buka bagian data_table Tampilan Analytics.

Mendapatkan detail tentang tampilan analisis

Anda dapat menggunakan opsi di panel Skema untuk menampilkan informasi berikut tentang tampilan analisis:

• Nama.
• Tanggal pembuatan.
• Pembaruan terakhir.
• Skema.
• Kueri.

Untuk melihat detail tampilan analisis, cantumkan tampilan analisis dalam project Anda, lalu lakukan langkah berikut:

1. Pilih tampilan analisis yang informasinya ingin Anda lihat.
2. Di toolbar Skema klik Lihat opsi tampilan analisis, lalu pilih Lihat detail.

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. Konfigurasi halaman Log Analytics:
   1. Pastikan toolbar menampilkan Run query. Jika toolbar menampilkan Jalankan di BigQuery, maka klik Setelan, lalu pilih Log Analytics (default).
   2. Jika menu Views tidak ditampilkan, buka panel navigasi dan klik Views and Schema.

3. Di menu Tampilan, buka bagian data_table Tampilan Analytics, lalu pilih tampilan Analytics yang ingin Anda ubah.

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

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

5. Setelah Anda menyelesaikan modifikasi, klik Ganti tampilan tersimpan.

Menghapus tampilan analisis

Catatan: Jika Anda telah menulis kueri terhadap tampilan analisis dan menghapus tampilan analisis tersebut, 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. Konfigurasi halaman Log Analytics:
   1. Pastikan toolbar menampilkan Run query. Jika toolbar menampilkan Jalankan di BigQuery, maka klik Setelan, lalu pilih Log Analytics (default).
   2. Jika menu Views tidak ditampilkan, buka panel navigasi dan klik Views and Schema.

3. Di menu Tampilan, buka bagian data_table Tampilan Analytics, lalu pilih tampilan Analytics yang ingin Anda hapus.
4. Di toolbar Skema, klik Lihat opsi tampilan analisis, pilih Hapus tampilan, lalu selesaikan dialog.

Batasan

Batasan berikut berlaku untuk tampilan analisis:

• Tampilan analisis hanya dapat membuat kueri tampilan log dan tampilan kemampuan pengamatan.
• Resource induk tampilan analisis harus berupa Google Cloud project.
• Anda hanya dapat membuat kueri tampilan analisis menggunakan halaman Log Analytics, dan hanya saat Anda menggunakan mesin kueri Log Analytics (default).
• Semua tampilan yang dikueri oleh tampilan analisis harus berada di lokasi yang sama.
• Anda harus menggunakan konsol Google Cloud untuk membuat atau mengelola tampilan analisis.
• Anda dapat membuat maksimal 100 tampilan analisis per project Google Cloud .
• Anda dapat membuat maksimal 50 tampilan analisis per region.
• Per Google Cloud project, maksimal 10 region dapat berisi tampilan analisis.

Langkah berikutnya

• Buat kueri dan analisis telemetri dengan Log Analytics.
• Membuat diagram hasil kueri SQL.
• Menyimpan dan membagikan kueri.
• Contoh kueri SQL.