Menampilkan data metrik di dasbor kustom

Widget metrik pada dasbor kustom di Cloud Monitoring memungkinkan Anda melacak tren deret waktu dan memantau nilai terbaru data metrik, termasuk metrik yang ditentukan pengguna dan berbasis log. Anda dapat memvisualisasikan data ini dari waktu ke waktu menggunakan diagram garis, area bertumpuk, batang bertumpuk, atau peta panas, atau menampilkan nilai terbaru menggunakan tabel, pengukur, kartu skor, histogram, diagram lingkaran, dan peta hierarki.

Untuk mengetahui informasi tentang cara menampilkan jenis data lain di dasbor kustom Anda, seperti data log atau teks, lihat bagian Langkah selanjutnya dalam dokumen ini. Untuk mengonfigurasi dasbor kustom secara terprogram, lihat Mengelola dasbor menurut API.

Visualisasi untuk data metrik

Untuk menampilkan data dari waktu ke waktu, gunakan Diagram. Ada empat gaya yang tersedia:

  • Garis
  • Area bertumpuk
  • Batang bertumpuk
  • Peta panas

Diagram garis adalah visualisasi default dan cocok untuk sebagian besar data metrik. Diagram batang bertumpuk paling cocok digunakan saat Anda membuat diagram data metrik yang memiliki sampel yang jarang, seperti metrik kuota. Untuk data metrik yang jenis nilainya adalah distribusi, gunakan heatmap.

Untuk hanya menampilkan nilai terbaru, gunakan salah satu gaya berikut:

  • Tabel menampilkan label, memungkinkan Anda membatasi jumlah baris, dan memungkinkan Anda memberi kode warna pada sel berdasarkan nilainya.
  • Pengukur dan Kartu Skor menampilkan indikasi hijau, kuning, atau merah berdasarkan perbandingan nilai dengan serangkaian nilai minimum.
  • Histogram menampilkan frekuensi relatif nilai terbaru dari beberapa deret waktu.
  • Diagram lingkaran menampilkan nilai terbaru dari setiap deret waktu sebagai pecahan dari jumlah semua nilai.
  • Peta hierarki menampilkan nilai terbaru dari data yang dikelompokkan sebagai serangkaian persegi panjang bertingkat, dengan warna persegi panjang sebanding dengan nilainya.

Setelah widget dikonfigurasi, Anda dapat mengubah visualisasinya.

Sebelum memulai

Selesaikan langkah-langkah berikut di project Google Cloud tempat Anda ingin membuat dan mengelola dasbor:

Menampilkan data metrik di dasbor

Untuk menampilkan data metrik di dasbor, selesaikan langkah-langkah berikut:

  1. Membuka dasbor dan menambahkan widget
  2. Pilih jenis metrik yang akan ditampilkan
  3. Simpan perubahan Anda

Anda mungkin ingin mengubah tampilan diagram, menampilkan rasio metrik, atau membuat perubahan lainnya. Untuk mempelajari opsi yang tersedia, lihat bagian Opsi konfigurasi lanjutan dalam dokumen ini.

Membuka dasbor dan menambahkan widget

Untuk menampilkan data metrik di dasbor kustom, lakukan tindakan berikut:

  1. Di konsol Google Cloud , buka halaman  Dashboards:

    Buka Dashboards

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

  2. Di toolbar konsol Google Cloud , pilih project Google Cloud Anda. Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.
  3. Lakukan salah satu hal berikut:

    • Untuk membuat dasbor baru, pilih Buat dasbor.
    • Untuk memperbarui dasbor yang ada, temukan dasbor dalam daftar semua dasbor, lalu pilih namanya.
  4. Di toolbar, klik  Tambahkan widget.

  5. Dalam dialog Tambahkan widget, pilih widget.

    • Untuk menambahkan diagram garis, pilih  Metrik.
    • Untuk menambahkan visualisasi yang berbeda, pilih visualisasi dari library widget.

    Anda dapat mengubah gaya visualisasi menggunakan opsi widget.

Pilih jenis metrik yang akan ditampilkan

Di langkah ini, Anda akan mengonfigurasi kueri. Kueri menentukan data yang ditampilkan widget.

  1. Pilih data deret waktu yang ingin Anda lihat:

    1. Pada elemen Metric, luaskan menu Select a metric.

      Menu Pilih metrik berisi fitur yang membantu Anda menemukan jenis metrik yang tersedia:

      • Untuk menemukan jenis metrik tertentu, gunakan Filter bar. Misalnya, jika Anda memasukkan util, Anda akan membatasi menu untuk menampilkan entri yang menyertakan util. Entri ditampilkan jika lulus pengujian "contains" yang tidak peka huruf besar/kecil.
      • Untuk menampilkan semua jenis metrik, bahkan yang tidak memiliki data, klik Aktif. Secara default, menu hanya menampilkan jenis metrik dengan data.

      Misalnya, Anda dapat membuat pilihan berikut:

      1. Di menu Active resources, pilih VM instance.
      2. Di menu Active metric categories, pilih uptime_check.
      3. Di menu Active metrics, pilih Request latency.
      4. Klik Terapkan.
    2. Opsional: Untuk menentukan subset data yang akan ditampilkan, di elemen Filter, pilih Add filter, lalu lengkapi dialog. Misalnya, Anda dapat melihat data untuk satu zona dengan menerapkan filter. Anda dapat menambahkan beberapa filter. Untuk informasi selengkapnya, lihat Memfilter data dalam diagram.

    Untuk mengetahui informasi selengkapnya, lihat Memilih data untuk dibuat diagram.

  2. Menggabungkan dan menyelaraskan deret waktu:

    • Untuk menampilkan setiap deret waktu, di elemen Aggregation, tetapkan menu pertama ke Unaggregated dan menu kedua ke None.
    • Untuk menggabungkan deret waktu, di elemen Aggregation, lakukan hal berikut:
      1. Luaskan menu pertama dan pilih fungsi.

        Diagram akan dimuat ulang dan menampilkan satu deret waktu. Misalnya, jika Anda memilih Rata-rata, deret waktu yang ditampilkan adalah rata-rata semua deret waktu.

      2. Untuk menggabungkan deret waktu yang memiliki nilai label yang sama, luaskan menu kedua, lalu pilih satu atau beberapa label.

        Diagram diperbarui dan menampilkan satu deret waktu untuk setiap kombinasi nilai label yang unik. Misalnya, untuk menampilkan deret waktu per zona, tetapkan menu kedua ke zone.

        Jika menu kedua ditetapkan ke Tidak Ada, diagram akan menampilkan satu deret waktu.

    • Opsional: Untuk mengonfigurasi jarak antar-titik data, klik Tambahkan elemen kueri, pilih Interval Min, lalu masukkan nilai.

    Untuk mengetahui informasi selengkapnya tentang pengelompokan dan penyelarasan, lihat Memilih cara menampilkan data dalam diagram.

  3. Opsional: Untuk hanya menampilkan deret waktu dengan nilai tertinggi atau terendah, gunakan elemen Sort & Limit.

PromQL

  1. Di toolbar panel query-builder, pilih tombol yang bernama  PromQL.
  2. Masukkan kueri Anda ke editor kueri. Misalnya, untuk membuat diagram pemakaian CPU rata-rata instance VM di project Google Cloud Anda, gunakan kueri berikut:

    avg(compute_googleapis_com:instance_cpu_utilization)
    

    Untuk mengetahui informasi selengkapnya tentang cara menggunakan PromQL, lihat PromQL di Cloud Monitoring.

Filter pemantauan

  1. Di elemen Metric, klik Help, lalu pilih Direct Filter Mode.

    Elemen Metric dan Filter akan dihapus, dan elemen Filters yang memungkinkan Anda memasukkan teks akan dibuat.

    Jika Anda memilih jenis resource, metrik, atau filter sebelum beralih ke mode Direct Filter Mode, setelan tersebut akan ditampilkan di kolom elemen Filters.

  2. Masukkan filter Pemantauan di kolom elemen Filters.
  3. Menggabungkan dan menyelaraskan deret waktu:

    • Untuk menampilkan setiap deret waktu, di elemen Aggregation, tetapkan menu pertama ke Unaggregated dan menu kedua ke None.
    • Untuk menggabungkan deret waktu, di elemen Aggregation, lakukan hal berikut:
      1. Luaskan menu pertama dan pilih fungsi.

        Diagram akan dimuat ulang dan menampilkan satu deret waktu. Misalnya, jika Anda memilih Rata-rata, deret waktu yang ditampilkan adalah rata-rata semua deret waktu.

      2. Untuk menggabungkan deret waktu yang memiliki nilai label yang sama, luaskan menu kedua, lalu pilih satu atau beberapa label.

        Diagram diperbarui dan menampilkan satu deret waktu untuk setiap kombinasi nilai label yang unik. Misalnya, untuk menampilkan deret waktu per zona, tetapkan menu kedua ke zone.

        Jika menu kedua ditetapkan ke Tidak Ada, diagram akan menampilkan satu deret waktu.

    • Opsional: Untuk mengonfigurasi jarak antara titik data, klik Add query element, pilih Min Interval, lalu masukkan nilai.

    Untuk mengetahui informasi selengkapnya tentang pengelompokan dan penyelarasan, lihat Memilih cara menampilkan data dalam diagram.

Simpan perubahan Anda

Setelah memilih jenis metrik yang akan ditampilkan, Anda dapat menyimpan perubahan, mengubah setelan default, atau mengonfigurasi kolom khusus widget. Bagian berikut dalam dokumen ini mungkin berguna saat Anda mengonfigurasi kolom khusus widget:

Setelah Anda puas dengan diagram, simpan perubahan, lalu perbarui dasbor.

  1. Untuk menerapkan perubahan pada dasbor, di toolbar, klik Apply. Untuk menghapus perubahan, klik Batal.
  2. Untuk menyimpan dasbor yang telah diubah, klik Save di toolbar.

Setelah menyimpan widget, Anda dapat mengedit widget tersebut dan mengubah setelannya. Misalnya, Anda dapat mengubah gaya visualisasi.

Opsi konfigurasi lanjutan

Bagian ini menjelaskan opsi yang tersedia untuk Anda dalam menyesuaikan widget:

Mengubah visualisasi

Untuk menampilkan nilai terbaru data metrik Anda, alih-alih menampilkan data tersebut dari waktu ke waktu, gunakan salah satu visualisasi berikut:

Untuk mengubah visualisasi widget, di panel Tampilan, pilih Jenis widget dan buat pilihan dari menu.

Menu Widget type mencantumkan semua jenis widget yang dapat menampilkan jenis data yang sama; namun, beberapa widget mungkin tidak diaktifkan. Misalnya, diagram garis menampilkan beberapa deret waktu. Menu Widget type menunjukkan bahwa sebagian besar jenis visualisasi tercantum sebagai Compatible. Misalnya, Anda selalu dapat beralih dari diagram garis ke tabel. Namun, jenis widget berikut tidak tersedia:

  • Widget Peta panas dinonaktifkan karena widget ini hanya dapat menampilkan data bernilai distribusi.
  • Panel log tidak tercantum karena panel log tidak dapat menampilkan data metrik.

Setel tampilan

Opsional: Untuk mengubah cara diagram atau tabel menampilkan data yang dipilih, gunakan opsi di panel Tampilan:

Setel visibilitas

Secara default, dasbor menampilkan widget Anda. Jika Anda menentukan variabel, Anda dapat membuat widget Anda hanya terlihat jika variabel memiliki nilai tertentu. Untuk mengetahui informasi selengkapnya, lihat Menetapkan visibilitas widget.

Menetapkan rentang waktu

Setelan rentang waktu yang ditampilkan oleh toolbar dasbor berlaku untuk setiap widget di dasbor, dengan pengecualian berikut:

  • Widget yang kuerinya menentukan rentang waktu.
  • Widget yang mengonfigurasi penggantian rentang waktu. Penggantian ini tersedia untuk sebagian besar diagram. Namun, fitur ini tidak tersedia untuk diagram yang menampilkan data yang dipantau oleh kebijakan pemberitahuan atau untuk jenis widget non-diagram seperti tabel.

Konfigurasikan penggantian rentang waktu diagram jika Anda ingin diagram tersebut menampilkan data dalam rentang waktu yang lebih lama atau lebih singkat daripada yang sesuai untuk widget dasbor lainnya. Misalnya, pertimbangkan kasus penggunaan berikut:

  • Dasbor menampilkan metrik kuota, yang memiliki 1 sampel per hari, dan data metrik yang diambil sampelnya setiap 60 detik. Diagram metrik kuota memerlukan rentang waktu minimal satu hari, mungkin selama satu minggu. Namun, rentang waktu ini terlalu lama untuk melihat lonjakan atau penurunan dalam metrik yang diambil sampelnya setiap 60 detik.

  • Untuk metrik, Anda ingin melihat tren dan pengukuran saat ini. Oleh karena itu, Anda menambahkan dua diagram ke dasbor. Untuk satu diagram, Anda menetapkan penggantian rentang waktunya menjadi delapan hari, sedikit lebih lama dari seminggu. Diagram lainnya menampilkan data satu jam, yang merupakan setelan rentang waktu dasbor.

Untuk mengonfigurasi diagram agar menggantikan setelan dasbor, di panel Tampilan, perluas kolom Penggantian Rentang Waktu, lalu selesaikan dialog. Anda dapat memasukkan rentang waktu relatif atau rentang waktu absolut.

Menampilkan beberapa jenis metrik

Anda dapat mengonfigurasi diagram dan tabel untuk menampilkan beberapa jenis metrik. Untuk tabel, Cloud Monitoring mencoba menampilkan nilai untuk kedua jenis metrik pada baris yang sama, jika memungkinkan. Untuk mengetahui informasi selengkapnya, lihat Cara tabel menggabungkan data dari beberapa jenis metrik.

  1. Pilih Tambahkan kueri. Kueri baru ditambahkan. Misalnya, kueri dengan label B mungkin ditambahkan.
  2. Untuk kueri baru, di elemen Metric, pilih jenis resource dan jenis metrik. Anda juga dapat menambahkan filter, menggabungkan deret waktu, serta mengurutkan dan membatasi jumlah deret waktu yang ditampilkan.

Screenshot berikut mengilustrasikan tampilan Metrics Explorer saat ada dua jenis metrik yang dipetakan:

Contoh Metrics Explorer dengan dua jenis metrik.

PromQL

Tidak didukung.

Filter pemantauan

Tidak didukung.

Menampilkan rasio jenis metrik

Anda mungkin ingin membuat diagram rasio metrik jika Google Cloud tidak menyediakan data metrik dalam bentuk yang Anda inginkan.

  1. Konfigurasi diagram untuk menampilkan dua jenis metrik yang memiliki jenis metrik yang sama. Misalnya, keduanya adalah metrik GAUGE.
  2. Pastikan nilai kolom Min Interval sama untuk kedua jenis metrik. Untuk mengakses kolom ini, klik Add query element, lalu pilih Min Interval.
  3. Perbarui kolom agregasi.

    Sebaiknya label untuk jenis metrik penyebut cocok dengan nilai yang ditetapkan untuk jenis metrik pembilang. Misalnya, Anda dapat memilih label zone untuk pembilang dan penyebut.

    Anda tidak diwajibkan untuk menggunakan set label yang sama untuk kedua jenis metrik; namun, Anda hanya dapat memilih label yang umum untuk kedua jenis metrik.

  4. Di toolbar panel kueri, pilih Create ratio, lalu lengkapi dialog.

    Setelah Anda membuat rasio, tiga kueri akan ditampilkan:

    • Rasio A/B mengidentifikasi kueri rasio.
    • A mengidentifikasi kueri untuk pembilang.
    • B mengidentifikasi kueri untuk penyebut.

    Contoh berikut mengilustrasikan rasio yang membandingkan jumlah byte yang ditulis ke disk per zona, dengan jumlah total byte yang ditulis ke disk:

    Contoh rasio metrik.

  5. Opsional: Untuk beralih metrik pembilang dan penyebut, di elemen Ratio, luaskan menu, lalu tentukan pilihan.

PromQL

  1. Di toolbar panel query-builder, pilih tombol yang bernama  PromQL.
  2. Masukkan kueri Anda ke editor kueri. Misalnya, untuk membuat diagram rasio latensi rata-rata metrik my_summary_latency_seconds, gunakan kueri berikut:

    sum without (instance)(rate(my_summary_latency_seconds_sum[5m])) /
    sum without (instance)(rate(my_summary_latency_seconds_count[5m]))
    

    Untuk mengetahui informasi selengkapnya tentang cara menggunakan PromQL, lihat PromQL di Cloud Monitoring.

Filter pemantauan

Tidak didukung.

Mengonfigurasi tabel

Untuk melihat data terbaru dalam bentuk tabel, tambahkan tabel. Tabel dapat menampilkan data numerik. Misalnya, diagram dapat menampilkan satu atau beberapa jenis metrik, atau persentil untuk metrik bernilai distribusi.

Screenshot berikut menggambarkan dua tabel. Tabel pertama menampilkan dua jenis metrik, yaitu jumlah byte yang dibaca dari instance dan jumlah byte yang ditulis ke instance. Nilai gabungan ditampilkan bersama dengan panel referensi. Tabel kedua menunjukkan nilai terbaru dari satu jenis metrik, dan kolom nilai telah dikonfigurasi untuk memberi kode warna pada sel berdasarkan perbandingan nilai dengan nilai minimum:

Contoh tabel yang menampilkan dua jenis metrik.

Ada dua widget yang menampilkan data dalam bentuk tabel: widget Daftar Teratas dan widget Tabel. Perbedaan utama antara kedua widget ini adalah widget Daftar Teratas mengurutkan baris, dan menampilkan nilai beserta indikator visual nilai dibandingkan dengan rentang nilai yang mungkin. Karena widget Daftar Teratas memberikan representasi visual nilai, Anda tidak dapat memberi kode warna pada sel berdasarkan perbandingan nilai dengan nilai minimum.

Untuk menambahkan tabel ke dasbor, lakukan tindakan berikut:

  1. Buka dasbor dan tambahkan widget.
  2. Di menu widget, pilih Tabel atau Daftar Teratas.
  3. Pilih jenis metrik yang akan ditampilkan.

    Setiap baris dalam tabel sesuai dengan satu deret waktu. Satu kolom tabel menampilkan nilai numerik yang merupakan nilai terbaru atau nilai gabungan. Kolom lainnya menampilkan label dalam deret waktu.

  4. Opsional: Pilih jenis metrik lain.

    Jika tabel menampilkan beberapa jenis metrik, data untuk semua jenis metrik ditampilkan di baris yang sama, jika memungkinkan. Untuk mengetahui informasi selengkapnya, lihat Memahami tabel yang menampilkan beberapa jenis metrik.

  5. Konfigurasi tabel:

Anda juga dapat menggunakan Cloud Monitoring API untuk menambahkan widget tabel ke dasbor. Untuk mengetahui informasi selengkapnya, lihat Dasbor dengan widget TimeSeriesTable.

Menampilkan nilai terbaru atau nilai gabungan

Secara default, tabel menampilkan nilai terbaru. Namun, tabel dapat menampilkan nilai yang dihitung selama rentang waktu yang dipilih untuk dasbor Anda.

Untuk memilih antara nilai terbaru dan nilai gabungan, gunakan kolom Opsi nilai.

Jika Anda menampilkan nilai gabungan, maka untuk setiap deret waktu, data dalam rentang waktu yang dipilih oleh dasbor Anda digabungkan oleh fungsi penyelarasan. Fungsi penyelarasan adalah salah satu opsi agregasi dan tidak ditampilkan secara default. Untuk melihat fungsi penyelarasan, luaskan elemen Aggregation, lalu di elemen pertama, pilih Configure aligner. Setelah Anda membuat pilihan ini, elemen Aggregation akan diganti dengan elemen Grouping dan menu bernama Alignment function.

Pilih kolom yang akan ditampilkan

Secara default, satu kolom dalam tabel menampilkan nilai numerik. Semua kolom lainnya sesuai dengan label dalam deret waktu. Untuk kolom berbasis label, nama kolom berasal dari label.

Untuk mengonfigurasi kolom yang ditampilkan oleh tabel, luaskan menu Visible Columns dan tentukan pilihan Anda.

Mengonfigurasi format kolom

  • Untuk mengonfigurasi setiap kolom, di elemen Kolom, luaskan menu Ganti kolom, pilih kolom yang akan diubah, lalu lakukan salah satu tindakan berikut:

    • Untuk menetapkan nama kolom, gunakan kolom Nama tampilan.
    • Untuk menetapkan perataan data dalam kolom, gunakan tombol Rata kiri, Rata tengah, dan Rata kanan.
    • Untuk memberi kode warna pada sel berdasarkan perbandingan nilai numerik dengan nilai minimum, tetapkan nilai minimum peringatan dan bahaya.
    • Jika Anda menulis kueri PromQL, gunakan menu Unit untuk menetapkan unit yang ditampilkan dengan data. Unit dikonfigurasi secara otomatis saat Anda mengonfigurasi kueri menggunakan pilihan menu.

Menampilkan nilai referensial

Tabel hanya dapat menampilkan nilai, atau dapat menampilkan nilai relatif terhadap rentang nilai. Jika opsi rentang dipilih, nilai akan ditampilkan bersama dengan batang berwarna biru; panjang batang sebanding dengan nilai yang ditampilkan.

Untuk mengonfigurasi apakah nilai referensial ditampilkan, gunakan elemen Tampilan metrik.

Urutkan dan filter

Anda dapat mengubah urutan baris dalam tampilan tabel, dan Anda dapat memfilter konten tabel sehingga hanya baris tertentu yang ditampilkan. Setelan ini tidak persisten. Saat Anda keluar dari halaman dasbor atau saat memuat ulang dasbor, opsi pengurutan dan pemfilteran yang Anda terapkan akan dihapus.

Anda memiliki opsi pengurutan dan pemfilteran berikut:

  • Untuk mengurutkan tabel menurut kolom, klik header kolom.

  • Untuk mengubah kolom tabel, klik Lihat kolom, lakukan perubahan, lalu klik Oke.

  • Untuk mencantumkan hanya baris tertentu, tambahkan satu atau beberapa filter. Anda dapat menambahkan beberapa filter. Jika Anda tidak menentukan operator OR di antara dua filter, AND logis akan menggabungkan filter tersebut.

    Untuk menambahkan filter, klik Enter property name or value, pilih properti dari menu, lalu masukkan nilai atau pilih dari menu nilai. Misalnya, jika Anda memfilter properti Name dan memasukkan nilai demo, tabel hanya akan mencantumkan baris yang kolom Name-nya menyertakan nilai demo.

Memahami tabel yang menampilkan beberapa jenis metrik

Jika tabel mengkueri beberapa jenis metrik, konsol Google Cloud akan melakukan operasi penggabungan dengan memeriksa label yang dilampirkan ke data gabungan untuk kedua jenis metrik. Jika label yang umum untuk kedua kueri memungkinkan Monitoring menentukan ID baris yang unik, maka satu baris pada tabel akan menampilkan nilai terbaru untuk setiap kueri. Jika tidak, ada satu baris untuk setiap deret waktu.

Misalnya, sebuah tabel mengkueri dua jenis metrik yang berbeda. Mari kita sebut kueri ini sebagai A dan B. Berikut ini penjelasan tentang cara penggabungan hasil kueri:

  • Jika hasil kedua kueri memiliki kumpulan label yang sama, penggabungan akan selalu berhasil. Setiap baris berisi nilai terbaru untuk setiap kueri. Jika kueri tidak menampilkan nilai untuk kombinasi label tertentu, sel tabel akan kosong.

    Misalnya, anggaplah kedua kueri berisi label zone. Tabel ini berisi satu baris untuk setiap zona yang dilaporkan oleh kueri A dan kueri B. Namun, jika kueri A menampilkan deret waktu yang zonanya adalah us-central1-a, tetapi kueri B tidak menampilkan deret waktu dengan nilai ini, nilai terbaru untuk kueri B akan ditampilkan sebagai sel kosong.

  • Jika label untuk hasil satu kueri adalah subset dari label untuk hasil kueri lainnya, hasilnya akan digabungkan.

    Misalnya, hasil untuk kedua kueri menyertakan label untuk location dan cluster_name, tetapi hasil untuk kueri A juga menyertakan label untuk memory_type. Dalam situasi ini, setiap baris sesuai dengan deret waktu dengan nilai unik untuk ketiga label.

    Pada baris mana pun, nilai yang ditampilkan untuk kueri B adalah nilai deret waktu yang cocok dengan dua label umum, location dan cluster_name, dan label ketiga diabaikan.

  • Jika hasil dari kedua kueri tidak memiliki label yang sama atau jika hasil tersebut memiliki beberapa label yang sama, tetapi tidak cukup untuk membentuk ID baris yang unik, hasil tersebut tidak dapat digabungkan. Tabel mencantumkan satu baris untuk setiap deret waktu yang ditampilkan oleh kueri A atau kueri B, dan beberapa sel tabel kosong.

    Misalnya, label untuk kueri A adalah location dan memory_type, dan label untuk kueri B adalah location dan cluster_name. Meskipun label location umum, label tersebut tidak cukup untuk membuat ID baris yang unik.

    Seperti yang dijelaskan di bagian berikutnya, Anda mungkin dapat menyelesaikan kegagalan penggabungan.

Cara mengatasi kegagalan penggabungan

Saat Anda membuat diagram beberapa metrik, kegagalan penggabungan mungkin terjadi karena metrik menggunakan nama label yang berbeda untuk kolom yang sama. Salah satu cara untuk mengatasi kegagalan ini adalah dengan mengonversi satu kueri ke PromQL, lalu menggunakan fungsi label_replace() untuk mengonversi nama label yang digunakan oleh satu jenis metrik agar cocok dengan nama label jenis metrik lainnya.

Misalnya, pertimbangkan tabel yang dikonfigurasi dengan dua kueri:

  • A: Membuat kueri jenis metrik Prometheus/kube_pod_container_status_ready/gauge. Opsi penggabungan ditetapkan untuk menjumlahkan deret waktu setelah mengelompokkan data menurut label cluster.

  • B: Membuat kueri jenis metrik kubernetes.io/container/memory/request_bytes. Opsi agregasi ditetapkan untuk menjumlahkan deret waktu setelah mengelompokkan data berdasarkan label cluster_name.

Tabel tidak dapat menggabungkan hasil karena hasil untuk kueri A dan kueri B memiliki label yang berbeda.

Untuk mengatasi kegagalan, konversi kueri A ke PromQL dan ganti cluster dengan cluster_name. Contoh berikut mengilustrasikan kueri yang diubah:

sum by (cluster_name)(
    label_replace(
        avg_over_time(kube_pod_container_status_ready[${__interval}]),
        "cluster_name", "$1", "cluster", "(.*)"
    )
)

Dengan perubahan tersebut, kedua kueri akan menghasilkan kumpulan label yang sama. Oleh karena itu, setiap baris dalam tabel mencantumkan nama cluster, nilai untuk kueri A, dan nilai untuk kueri B.

Untuk mengetahui informasi tentang cara menggunakan PromQL, lihat PromQL di Cloud Monitoring.

Mengonfigurasi pengukur dan kartu skor

Untuk melihat pengukuran terbaru dibandingkan dengan serangkaian nilai minimum yang diberi kode warna, tambahkan pengukur atau kartu skor. Pengukur hanya menampilkan pengukuran terbaru, sedangkan kartu skor juga menampilkan histori pengukuran terbaru. Warna latar belakang widget ini juga diberi kode warna. Jika nilai terbaru berada dalam rentang yang diharapkan, warna widget adalah putih. Jika nilai berada dalam rentang peringatan, widget akan berubah menjadi kuning. Demikian pula, saat nilai berada dalam rentang bahaya, widget akan menjadi merah.

Widget ini dapat menampilkan beberapa pengukur atau kartu skor. Misalnya, gambar berikut menunjukkan widget pengukur yang menampilkan tiga pengukur:

Contoh pengukur.

Jumlah pengukur yang ditampilkan oleh widget pengukur bergantung pada setelan agregasi Anda. Dalam contoh ini, setelan agregasi menghasilkan tiga deret waktu, sehingga tiga pengukur ditampilkan. Anda menentukan nilai minimum di tingkat widget, sehingga nilai minimum tersebut berlaku untuk setiap deret waktu. Dalam contoh ini, satu pengukur berwarna merah, satu berwarna kuning, dan yang ketiga berwarna hijau.

Informasi lainnya di bagian ini ditujukan untuk konsolGoogle Cloud . Untuk mengetahui informasi tentang cara menggunakan Cloud Monitoring API, lihat Dasbor dengan Scorecard dasar.

Untuk menambahkan pengukur atau kartu skor ke dasbor, lakukan tindakan berikut:

  1. Buka dasbor dan tambahkan widget.
  2. Di menu widget, pilih Gauge atau Scorecard.

  3. Pilih jenis metrik yang akan ditampilkan.

  4. Di panel Display, konfigurasikan widget:

    1. Untuk widget pengukur, klik Gauge range, lalu tetapkan nilai minimum dan maksimum. Jika mengukur persentase, tetapkan nilai ini ke 0 dan 1.

    2. Klik Ambang batas pengukur, lalu tetapkan ambang batas peringatan dan bahaya. Kolom nilai minimum yang kosong tidak akan digunakan.

      Untuk pengukur yang ditampilkan sebelumnya, dua nilai minimum ditetapkan. Nilai yang lebih tinggi dari 0,9 berada dalam rentang bahaya. Nilai yang lebih tinggi dari 0,7, tetapi tidak dalam rentang bahaya, berada dalam rentang peringatan.

    3. Untuk kartu skor, klik Tampilan diagram Spark, lalu luaskan menu opsi, dan pilih gaya tampilan.

  5. Untuk menerapkan perubahan pada dasbor, di toolbar, klik Apply. Untuk menghapus perubahan, klik Batal.

  6. Untuk menyimpan dasbor yang telah diubah, klik Save di toolbar.

Mengonfigurasi histogram, diagram lingkaran, dan peta hierarki

Bagian ini memberikan informasi tentang cara mengonfigurasi widget yang menampilkan nilai metrik terbaru dalam bentuk grafis.

Mengonfigurasi histogram

Histogram memberikan informasi tentang frekuensi relatif dari nilai terbaru beberapa deret waktu. Artinya, sumbu x diindeks oleh bin, yang masing-masing sesuai dengan rentang nilai. Sumbu y menentukan jumlah, yang merupakan jumlah sampel yang nilainya berada dalam rentang bin.

Screenshot berikut menampilkan widget histogram:

Contoh widget **Histogram**.

Contoh ini menunjukkan nilai terbaru untuk sekitar 50 deret waktu. Nilai terbaru untuk sebagian besar deret waktu adalah 0,145 atau kurang.

Untuk menambahkan histogram ke dasbor, lakukan tindakan berikut:

  1. Buka dasbor dan tambahkan widget.
  2. Di menu widget, pilih Histogram.
  3. Pilih jenis metrik yang akan ditampilkan.

    Histogram ditampilkan dengan konfigurasi bin default.

  4. Opsional: Perbarui konfigurasi bin:

    • Untuk mengonfigurasi jumlah atau ukuran bin, pilih Bin histogram dan buat pilihan.

      • Untuk menentukan jumlah bin, pilih Count, lalu masukkan nilai. Sebaiknya nilai yang Anda masukkan minimal 5, tetapi tidak lebih dari 50. Namun, fitur ini mendukung hingga 1.000 bin.

      • Untuk menentukan ukuran setiap bin, pilih Size, lalu masukkan nilai.

    • Untuk menentukan nilai sumbu x minimum dan maksimum, pilih Rentang sumbu X dan lengkapi dialog.

    • Untuk menentukan penskalaan linear atau logaritmik pada sumbu y, pilih Y-axis scale dan lengkapi dialog.

  5. Pilih Terapkan, lalu Simpan.

Anda juga dapat menggunakan Cloud Monitoring API untuk menambahkan widget histogram ke dasbor. Untuk mengetahui informasi selengkapnya, lihat Dasbor dengan widget Histogram.

Mengonfigurasi diagram lingkaran

Untuk melihat data terbaru sebagai pecahan dari total, tambahkan diagram lingkaran. Seperti tabel, diagram lingkaran dapat menampilkan jenis metrik yang memiliki nilai numerik, dan dapat menampilkan persentil untuk metrik bernilai distribusi. Setiap deret waktu menyumbangkan satu irisan ke diagram lingkaran.

Screenshot berikut mengilustrasikan dasbor yang menampilkan penggunaan CPU instance virtual machine menggunakan dua konfigurasi widget Diagram lingkaran yang berbeda:

Contoh widget **PieChart**.

Untuk mengetahui informasi tentang cara menambahkan diagram lingkaran ke dasbor, selesaikan langkah-langkah berikut:

  1. Buka dasbor dan tambahkan widget.
  2. Di menu widget, pilih diagram lingkaran.

    Untuk menampilkan nilai total, tetapkan kolom Chart type ke Donut.

  3. Pilih jenis metrik yang akan ditampilkan.

Untuk mengetahui informasi tentang cara menggunakan API untuk mengonfigurasi diagram lingkaran, lihat Dasbor dengan widget PieChart.

Mengonfigurasi peta hierarki

Untuk melihat data terbaru sebagai deret persegi panjang bertingkat, dengan setiap persegi panjang sesuai dengan kumpulan nilai label yang unik, tambahkan peta hierarki. Asumsikan bahwa Anda telah mengagregasi data yang Anda buat diagramnya menurut label zone. Jika Anda menyetel jenis widget ke peta hierarki, setiap persegi panjang pada peta hierarki akan sesuai dengan satu zona. Saturasi warna persegi panjang sebanding dengan nilai yang diwakilinya.

Screenshot berikut menampilkan widget peta hierarki yang deret waktunya diagregasi menurut zone dan storage_type:

Contoh widget **Peta hierarki**.

Dalam screenshot, tooltip ditampilkan untuk satu persegi panjang.

Untuk mengonfigurasi peta hierarki, lakukan tindakan berikut:

  1. Buka dasbor dan tambahkan widget.
  2. Di menu widget, pilih Treemap.
  3. Pilih jenis metrik yang akan ditampilkan.
  4. Jika elemen Agregasi menampilkan Tidak diagregasi, gunakan menu untuk memilih fungsi agregasi. Misalnya, pilih Mean atau Max.
  5. Di kolom kedua elemen Agregasi, pilih setidaknya satu label.
  6. Untuk menerapkan perubahan pada dasbor, di toolbar, klik Apply. Untuk menghapus perubahan, klik Batal.
  7. Untuk menyimpan dasbor yang telah diubah, klik Save di toolbar.

Untuk mengetahui informasi tentang cara menggunakan API guna mengonfigurasi peta hierarki, lihat Dasbor dengan widget Treemap.

Langkah berikutnya

Anda juga dapat menambahkan widget berikut ke dasbor kustom:

Untuk mengetahui informasi tentang cara menjelajahi data dalam diagram dan memfilter dasbor, lihat dokumen berikut: