Membuat diagram hasil kueri SQL

Anda dapat membuat diagram hasil kueri SQL di Observability Analytics untuk mengidentifikasi pola dan tren performa dalam data pelacakan, serta menyimpan visualisasi tersebut ke dasbor kustom.

Misalnya, diagram berikut menampilkan status yang dilaporkan oleh rentang dari waktu ke waktu, yang dikelompokkan berdasarkan service_name:

Contoh diagram yang menggambarkan perincian menurut nama layanan.

Sebelum memulai

  1. 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.

  2. 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.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Observability API.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

  5. 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.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Observability API.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

    8.

  8. Untuk mendapatkan izin yang Anda perlukan untuk memuat halaman Observability 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 izin ke tampilan tertentu. Jika Anda tidak melampirkan kondisi ke pemberian peran, akun utama dapat mengakses semua tampilan observabilitas.
    • Editor Monitoring (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 Anda. Setelah menjalankan kueri dan membuat diagram, Anda dapat menyesuaikan diagram dengan mengubah jenis diagram dan memilih kolom untuk menampilkan data yang berbeda.

Untuk melihat hasil kueri sebagai diagram, jalankan kueri dengan melakukan hal berikut:

  1. Di Google Cloud konsol, buka halaman Observability Analytics:

    Buka Observability 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 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, serta menerapkan perincian. Dimension digunakan untuk mengelompokkan atau mengategorikan baris dan merupakan nilai sumbu X. Measure, atau nilai sumbu Y, adalah deret data yang diplot terhadap sumbusumbu 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, 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 menjadi 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 mengagregasi 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 mengagregasi 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