Membuat, membuat kueri, dan mengelola tampilan analisis

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di 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 mengkuerinya dengan cara yang mirip dengan mengkueri tampilan observabilitas.

Untuk mengetahui ringkasan tampilan analisis, lihat Tentang tampilan analisis.

Sebelum memulai

Login keakun Anda. Google Cloud 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.

Enable the Observability API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the 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.

Enable the Observability API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

1. Untuk mendapatkan izin yang diperlukan untuk membuat, mengelola, dan menggunakan tampilan analisis, minta administrator untuk memberi Anda peran IAM berikut:

   • Pengakses Tampilan Observabilitas (roles/observability.viewAccessor) pada tampilan observabilitas yang ingin Anda kueri. Peran ini mendukung kondisi IAM, yang memungkinkan Anda membatasi pemberian akses ke tampilan tertentu. Jika Anda tidak melampirkan kondisi ke pemberian peran, akun utama dapat mengakses semua tampilan observabilitas. Tampilan observabilitas berada dalam Pratinjau Publik.
   • Pengguna Observabilitas Analytics (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.

   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 tampilan observabilitas. Untuk mempelajari lebih lanjut, lihat Model penyimpanan Cloud Trace.

Membuat tampilan analisis

Catatan: Tampilan analisis dapat mengkueri tampilan observabilitas. Jika tampilan analisis mengkueri beberapa tampilan, tampilan tersebut harus berada di lokasi yang sama.

Untuk membuat tampilan analisis, lakukan hal berikut:

1. Di Google Cloud konsol, 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 Run in BigQuery, lalu klik Settings dan pilih Log Analytics (default).
   2. Jika menu Views tidak ditampilkan, buka panel navigasi, lalu 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 observabilitas yang akan dikueri oleh tampilan analisis Anda. Untuk memuat kueri default, lakukan hal berikut:

   1. Di menu Views, buka bagian Traces, lalu pilih _Trace.Spans._AllSpans.

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

      Panel Query akan diperbarui dengan kueri SQL.

   3. Perbarui kueri hingga Anda puas dengan hasil kueri.

4. Buat tampilan analisis:

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

   2. Masukkan nama dan deskripsi untuk tampilan analisis.

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

   3. Klik Save.

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

Mengkueri tampilan analisis

Anda mengkueri tampilan analisis dengan cara yang mirip dengan mengkueri tampilan observabilitas. Untuk mengkueri 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 Mengkueri dan menganalisis trace.

Mencantumkan tampilan analisis

Untuk mencantumkan tampilan analisis di Google Cloud project Anda, lakukan hal berikut:

1. Di Google Cloud konsol, 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 Run in BigQuery, lalu klik Settings dan pilih Log Analytics (default).
   2. Jika menu Views tidak ditampilkan, buka panel navigasi, lalu klik Views and Schema.

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

Mendapatkan detail tentang tampilan analisis

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

• Nama.
• Tanggal pembuatan.
• Terakhir diperbarui.
• Skema.
• Kueri.

Untuk melihat detail tampilan analisis, cantumkan tampilan analisis di project Anda, lalu lakukan hal berikut:

1. Pilih tampilan analisis yang informasinya ingin Anda lihat.
2. Di toolbar Schema klik View analytics view options, lalu pilih View details.

Mengubah tampilan analisis

Untuk mengubah tampilan analisis, lakukan hal berikut:

1. Di Google Cloud konsol, 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 Run in BigQuery, lalu klik Settings dan pilih Log Analytics (default).
   2. Jika menu Views tidak ditampilkan, buka panel navigasi, lalu klik Views and Schema.

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

4. Di toolbar Schema, klik View analytics view options, lalu pilih Edit view.

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

5. Setelah selesai melakukan perubahan, klik Overwrite saved view.

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 hal berikut:

1. Di Google Cloud konsol, 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 Run in BigQuery, lalu klik Settings dan pilih Log Analytics (default).
   2. Jika menu Views tidak ditampilkan, buka panel navigasi, lalu klik Views and Schema.

3. Di menu Views, buka bagian data_table Analytics Views, lalu pilih tampilan analisis yang ingin Anda hapus.
4. Di toolbar Schema, klik View analytics view options, pilih Delete view, lalu selesaikan dialog.

Batasan

Batasan berikut berlaku untuk tampilan analisis:

• Tampilan analisis hanya dapat mengkueri tampilan observabilitas.
• Resource induk tampilan analisis harus berupa Google Cloud project.
• Anda hanya dapat mengkueri 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 Google Cloud konsol untuk membuat atau mengelola tampilan analisis.
• Anda dapat membuat maksimal 100 tampilan analisis per Google Cloud project.
• Anda dapat membuat maksimal 50 tampilan analisis per region.
• Per Google Cloud project, maksimal 10 region dapat berisi tampilan analisis.

Langkah berikutnya

• Mengkueri dan menganalisis trace.
• Membuat diagram hasil kueri SQL.
• Menyimpan dan membagikan kueri.
• Contoh kueri SQL.