Membuat diagram hasil kueri SQL

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 diagram hasil kueri SQL yang Anda jalankan di halaman Log Analytics. Diagram dapat membantu Anda mengidentifikasi pola dan tren dalam data. Dokumen ini juga menjelaskan cara menyimpan diagram ke a dasbor kustom.

Screenshot berikut menampilkan hasil contoh kueri, yang dijelaskan nanti dalam dokumen ini. Screenshot menampilkan status yang dilaporkan oleh rentang, setelah menggabungkan respons berdasarkan waktu dan service_name:

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 Anda perlukan untuk memuat halaman Log Analytics, menulis dan menjalankan kueri pada data pelacakan, serta menyimpan diagram di dasbor kustom, minta administrator untuk memberi Anda peran IAM berikut:

   • Pengakses Lihat Observabilitas (roles/observability.viewAccessor) pada tampilan observabilitas yang ingin Anda kueri. Peran ini mendukung kondisi IAM, yang memungkinkan Anda membatasi pemberian ke tampilan tertentu. Jika Anda tidak melampirkan kondisi ke pemberian peran, akun utama dapat mengakses semua tampilan observabilitas.
   • Logs Viewer (roles/logging.viewer) di project Anda.
   • Monitoring Editor (roles/monitoring.editor) 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.

Memilih data yang akan dibuat diagramnya

Untuk mengonfigurasi data yang akan ditampilkan pada diagram, buat kueri menggunakan SQL. Saat Anda memilih tab Diagram, diagram akan menampilkan hasil kueri. Setelah kueri dijalankan dan diagram dibuat, Anda dapat menyesuaikan konfigurasi diagram dengan mengubah jenis diagram, dan memilih kolom untuk melihat data yang berbeda.

Untuk melihat hasil kueri sebagai diagram, jalankan kueri dengan melakukan 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. Di panel Query , masukkan kueri, lalu klik Run.

3. Setelah kueri selesai, di tab Results, pilih cara Anda ingin melihat hasil kueri:

   • Tabel: Hanya format tabel.

   • Diagram: Hanya format diagram

   • Both: Format diagram dan tabel.

     Setelah memilih cara melihat hasil kueri, Anda dapat mengonfigurasi kolom apa pun untuk visualisasi yang dipilih, lalu menyimpan kueri dan hasilnya ke dasbor kustom. Format yang disimpan adalah tabel jika Anda telah memilih opsi Table. Jika tidak, formatnya adalah diagram.

     Untuk diagram, opsi visualisasi memungkinkan Anda memilih jenis diagram, dan memilih baris serta kolom yang akan dibuat diagramnya. Untuk mengetahui informasi selengkapnya tentang konfigurasi diagram, lihat Menyesuaikan konfigurasi diagram.

Menyesuaikan konfigurasi diagram

Anda dapat menyesuaikan konfigurasi diagram dengan mengubah jenis diagram, memilih dimensi dan ukuran yang akan dibuat diagramnya, dan dengan menerapkan perincian. Dimensi digunakan untuk mengelompokkan atau mengategorikan baris dan merupakan nilai sumbu X. The Ukuran, atau nilai sumbu Y, adalah deret data yang diplot terhadap sumbu Y.

Mengubah jenis diagram

Anda dapat memilih dari jenis diagram berikut, bergantung pada jenis baris dan kolom yang Anda pilih sebagai dimensi dan ukuran, serta cara Anda ingin memvisualisasikan data tersebut.

• Diagram batang (default) : Diagram batang memplot data pada dua sumbu. Jika diagram Anda menggunakan kategori atau string sebagai dimensi, Anda dapat menetapkan konfigurasi diagram untuk diagram batang ke horizontal atau vertikal, dengan sumbu dimensi dan ukuran ditukar.

• Diagram garis: Diagram garis dapat digunakan untuk menampilkan perubahan data dari waktu ke waktu. Saat Anda menggunakan diagram garis, setiap deret waktu ditampilkan oleh garis yang berbeda yang sesuai dengan ukuran yang telah Anda pilih.

  Jika sumbu X Anda berbasis waktu, setiap titik data ditempatkan di awal interval waktu. Setiap titik data terhubung dengan interpolasi linear.

• Diagram area bertumpuk: Diagram area didasarkan pada diagram garis, dan area di bawah setiap garis diberi bayangan. Dalam diagram area, deret data ditumpuk. Misalnya, jika Anda memiliki dua deret yang identik, deret tersebut akan tumpang-tindih dalam diagram garis, tetapi area yang diberi bayangan akan ditumpuk dalam diagram area.

• Diagram lingkaran atau donat: Diagram lingkaran menampilkan hubungan kategori dalam set data dengan seluruh set data, dengan menggunakan lingkaran untuk mewakili seluruh set data dan irisan dalam lingkaran untuk mewakili kategori dalam set data. Ukuran irisan menunjukkan seberapa besar, sering kali sebagai persentase, kontribusi kategori terhadap keseluruhan.

• Tabel: Tabel menampilkan satu baris untuk setiap baris dalam hasil kueri. Kolom dalam tabel ditentukan oleh klausa SELECT. Jika Anda berencana menampilkan data dalam bentuk tabel di dasbor, gunakan klausa LIMIT untuk membatasi jumlah baris dalam hasil agar kurang dari beberapa ratus.

• Pengukur atau kartu skor: Pengukur dan kartu skor memberi Anda nilai terbaru beserta indikasi hijau, kuning, atau merah berdasarkan perbandingan nilai tersebut dengan serangkaian nilai minimum dan maksimum. Tidak seperti pengukur, yang hanya menampilkan informasi tentang nilai terbaru, kartu skor juga dapat menyertakan informasi tentang nilai sebelumnya.

  Pengukur dan kartu skor hanya dapat menampilkan hasil kueri jika hasil kueri berisi setidaknya satu baris, dan baris tersebut berisi kolom dengan stempel waktu dan kolom dengan data numerik. Hasil kueri dapat berisi beberapa baris dan lebih dari dua kolom.

  Jika Anda ingin melakukan agregasi berbasis waktu sebagai bagian dari kueri, lakukan hal berikut:

  • Konfigurasi kueri untuk menggabungkan data selama interval waktu, mengurutkan hasil berdasarkan stempel waktu menurun, dan membatasi jumlah baris dalam hasil. Anda dapat menggunakan klausa LIMIT atau menggunakan pemilih rentang waktu untuk membatasi jumlah baris dalam hasil kueri.

    Misalnya, kueri berikut mengkueri data pelacakan Anda, dan menggabungkan data selama interval satu jam, menerapkan batas, dan mengurutkan hasilnya:

    SELECT TIMESTAMP_TRUNC(start_time, HOUR) AS hour,
       COALESCE(
          JSON_VALUE(resource.attributes, '$."service.name"'),
          JSON_VALUE(attributes, '$."service.name"'),
          JSON_VALUE(attributes, '$."g.co/gae/app/module"')) AS service_name,
       status.code AS status,
       COUNT(*) AS count
    FROM `PROJECT_ID.LOCATION._Trace.Spans._AllSpans`
    GROUP BY hour, service_name, status
    ORDER BY hour DESC
    LIMIT 1000
    

    Berikut ini penjelasan arti kolom dalam ekspresi sebelumnya:

    • PROJECT_ID: ID project.
    • LOCATION: Lokasi bucket observabilitas.

    Kueri sebelumnya digunakan untuk membuat gambar yang ditampilkan di awal dokumen ini. Gambar tersebut juga menampilkan konfigurasi diagram.

  • Tetapkan Dimensi agar sesuai dengan kolom yang melaporkan unit waktu. Misalnya, jika kueri Anda menggabungkan data per jam dan membuat kolom bernama hour, tetapkan menu Dimensi ke hour.

  • Pilih Nonaktifkan interval karena kueri Anda sudah menentukan interval agregasi. Dalam contoh ini, intervalnya adalah satu jam.

  • Tetapkan Ukuran ke kolom numerik, dan tetapkan fungsi ke none.

    Catatan: Jika kueri Anda melakukan agregasi berbasis waktu, pastikan bahwa Anda mengikuti panduan sebelumnya. Setelan lain akan menyebabkan kueri dan Log Analytics melakukan operasi agregasi, yang akan menyebabkan pengukur atau kartu skor menampilkan nilai yang tidak diharapkan.

  Jika Anda ingin mengandalkan Log Analytics untuk melakukan agregasi berbasis waktu, lakukan hal berikut:

  • Konfigurasi pemilih rentang waktu, yang memengaruhi jumlah baris dalam hasil kueri.
  • Tetapkan Dimensi agar sesuai dengan kolom yang melaporkan unit waktu. Misalnya, Anda dapat menetapkan menu ini ke timestamp.
  • Tetapkan menu Interval ke interval agregasi ke interval tertentu interval. Misalnya, tetapkan nilai kolom ini ke 1 hour. Jangan pilih Interval otomatis.
  • Tetapkan Ukuran ke kolom numerik, dan pilih fungsi seperti sum.

Mengubah dimensi dan ukuran

Anda dapat memilih baris dan kolom yang akan dibuat diagramnya dengan memilih kolom dimensi dan ukuran.

Catatan: Jika hasil kueri Anda berisi kolom yang memiliki string panjang, seperti pesan error, dan Anda memilih kolom tersebut sebagai dimensi atau perincian, diagram Anda mungkin mengalami error atau nilai yang tidak diharapkan.

• Dimensi

  Dimensi harus berupa kolom stempel waktu, numerik, atau string. Secara default, dimensi ditetapkan ke kolom berbasis stempel waktu pertama dalam skema. Jika tidak ada stempel waktu dalam kueri, kolom string pertama akan dipilih sebagai dimensi. Anda juga dapat menyesuaikan dimensi di panel Tampilan diagram. Jika kolom stempel waktu dipilih sebagai dimensi, diagram akan menampilkan perubahan data dari waktu ke waktu. Jika kolom string dipilih sebagai dimensi untuk diagram batang, Anda dapat mengurutkan data secara menaik atau menurun, yang akan mengurutkan dimensi berdasarkan urutan leksikal. Anda juga dapat mempertahankan urutan pengurutan `default`, yang mengurutkan dimensi berdasarkan nilai ukuran yang sesuai dalam urutan menurun.

  Secara default, interval untuk stempel waktu ditetapkan secara otomatis, tetapi Anda juga dapat memilih interval kustom. Interval otomatis mengubah nilai berdasarkan pemilih rentang waktu untuk mempertahankan grup berukuran serupa.

  Anda juga dapat menonaktifkan interval, yang memungkinkan Anda menentukan agregasi dan rentang waktu sendiri dalam kueri untuk analisis yang lebih kompleks. Menonaktifkan interval akan menetapkan fungsi agregasi ukuran ke none. Hanya ukuran numerik yang diizinkan saat interval dimensi dinonaktifkan.

  Catatan: Hanya kolom TIMESTAMP yang dapat digunakan sebagai dimensi stempel waktu. Untuk menggunakan DATE dan DATETIME, Anda harus menggunakan CAST() fungsi untuk mengonversi jenis data ke TIMESTAMP.

• Ukur

  Anda dapat memilih beberapa ukuran di panel Tampilan diagram. Saat memilih ukuran, Anda juga harus memilih fungsi agregasi yang akan dilakukan pada nilai yang dikelompokkan, seperti count, sum, average, dan percentile-99. Misalnya, count-distinct menampilkan jumlah nilai unik dalam kolom tertentu.

  Jika Anda mencentang kotak Nonaktifkan interval untuk dimensi, opsi fungsi agregasi none akan tersedia. Jika dimensi adalah nilai string, kotak Nonaktifkan interval tidak akan ditampilkan. Namun, menetapkan fungsi agregasi ukuran ke none juga akan menonaktifkan interval.

Menambahkan perincian

Catatan: Jika diagram Anda berisi lebih dari satu ukuran, Anda tidak dapat menambahkan perincian.

Untuk membagi satu deret data menjadi beberapa deret data berdasarkan kolom lain, tambahkan perincian.

Saat memilih perincian, pilih kolom yang berisi sejumlah kecil label pendek dan bermakna, seperti region_name, bukan kolom yang mungkin berisi sejumlah besar string atau string panjang, seperti textPayload.

Misalnya, diagram berikut menampilkan jumlah rentang yang dibuat oleh setiap layanan, beserta data yang dipecah berdasarkan nama rentang:

Menyimpan diagram ke dasbor kustom

Setelah diagram dibuat dari kueri, Anda dapat menyimpan diagram tersebut ke dasbor kustom . Dasbor kustom memungkinkan Anda menampilkan dan mengatur informasi yang berguna bagi Anda menggunakan berbagai jenis widget. Dasbor ini juga memungkinkan Anda menentukan variabel, yang merupakan filter tingkat dasbor yang hanya berlaku untuk widget tertentu. Untuk menerapkan variabel ke widget, Anda harus mengubah kueri. Untuk mengetahui informasi selengkapnya, lihat Menerapkan variabel ke widget.

Dasbor menampilkan pesan peringatan untuk widget yang berisi kueri SQL saat kueri berjalan di mesin BigQuery dan resource yang dikueri tidak berada dalam batas kepemilikan yang sama. Batas kepemilikan ditentukan oleh beberapa faktor, salah satunya adalah hierarki resource yang digunakan kueri. Untuk mencegah peringatan ini, Siapkan perimeter layanan.

Untuk menyimpan diagram ke dasbor, 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. Jalankan kueri untuk membuat diagram, lalu klik Simpan diagram di tab Diagram.

3. Di dialog Simpan ke dasbor, masukkan judul untuk diagram Anda dan pilih dasbor tempat Anda ingin menyimpan diagram.

4. Opsional: Untuk melihat dasbor kustom, klik Lihat dasbor di toast.

Untuk melihat daftar dasbor kustom yang berisi diagram yang dibuat oleh kueri SQL, buka tombol Simpan Diagram dan klik Menu.

Mengedit diagram yang disimpan ke dasbor kustom

Anda dapat mengubah diagram setelah disimpan ke dasbor. Untuk mengetahui informasi selengkapnya, lihat Mengubah konfigurasi widget. Di dialog Konfigurasi widget, Anda dapat melakukan hal berikut:

• Mengubah data yang Anda kueri.
• Mengedit kueri yang digunakan untuk membuat diagram.
• Menyesuaikan konfigurasi diagram untuk memvisualisasikan data yang berbeda.

Batasan

• Jikaproject Anda berada di folder yang menggunakan Assured Workloads, diagram yang Anda buat tidak dapat ditampilkan di dasbor kustom. Google Cloud

• Filter tingkat dasbor tidak berlaku untuk diagram yang dibuat dari kueri SQL.

• Kolom yang dipilih harus memiliki setidaknya satu baris dengan nilai non-null.

• Jika Anda menyimpan kueri dan menyesuaikan konfigurasi diagram, konfigurasi diagram kustom tidak akan disimpan.

• Jika kueri Anda sudah berisi agregasi, diagram yang dibuat mungkin berbeda karena agregasi tambahan yang diterapkan secara otomatis oleh Log Analytics.

• Jalur JSON harus di-cast ke string atau angka agar dapat dibuat diagramnya.

Langkah berikutnya

• Menyimpan dan membagikan kueri SQL.
• Contoh kueri SQL.
• Mengkueri set data tertaut di BigQuery.