Menambahkan diagram dan tabel ke dasbor kustom

Dokumen ini menjelaskan cara menambahkan diagram, tabel, pengukur, dan kartu skor ke dasbor kustom menggunakan konsol Google Cloud. Anda dapat menampilkan data metrik selama interval waktu dengan menambahkan diagram garis, diagram area bertumpuk, diagram batang, atau diagram peta panas. Jika Anda hanya tertarik pada pengukuran terbaru, tambahkan tabel, diagram lingkaran, indikator, atau kartu skor. Indikator dan kartu skor akan berubah warna berdasarkan perbandingan nilai terbaru dengan nilai minimum peringatan dan bahaya.

Visualisasi yang dapat Anda tambahkan ke dasbor secara kolektif disebut widget. Untuk informasi umum tentang berbagai jenis widget, lihat Ringkasan dasbor.

Diagram, tabel, pengukur, dan kartu skor di dasbor kustom dapat menampilkan jenis metrik apa pun yang memiliki nilai numerik atau distribusi, termasuk metrik yang ditentukan pengguna dan metrik berbasis log. Diagram tidak dapat membuat grafik data jenis string.

Dokumen ini menjelaskan cara menambahkan diagram, tabel, pengukur, dan kartu skor ke dasbor kustom yang menampilkan data deret waktu. Untuk informasi tentang cara menambahkan jenis widget lainnya ke dasbor, lihat dokumen berikut:

Untuk mengetahui informasi tentang Cloud Monitoring API, lihat Mengelola dasbor menurut API.

Sebelum memulai

  • Untuk mendapatkan izin yang diperlukan guna membuat dan mengubah dasbor kustom menggunakan konsol Google Cloud, minta administrator untuk memberi Anda peran IAM Monitoring Editor (roles/monitoring.editor) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

    Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

    Untuk informasi selengkapnya tentang peran, lihat Mengontrol akses dengan Identity and Access Management.

  • Anda dapat menempatkan hingga 40 widget di dasbor.

  • Untuk menambahkan widget ke dasbor, Anda dapat memilih visualisasi, lalu mengonfigurasi widget, atau memilih jenis data terlebih dahulu, lalu mengonfigurasi visualisasi.

    Misalnya, untuk menambahkan tabel yang menampilkan penggunaan CPU instance VM ke dasbor, Anda dapat melakukan salah satu tindakan berikut:

    • Pilih widget Tabel, lalu konfigurasikan widget tersebut untuk menampilkan penggunaan CPU instance VM Anda.
    • Pilih jenis data Metric, konfigurasikan widget untuk menampilkan penggunaan CPU instance VM Anda, lalu ubah jenis widget menjadi Table.

    Petunjuk di halaman ini mengasumsikan bahwa Anda memilih jenis data terlebih dahulu, lalu mengonfigurasi cara data tersebut ditampilkan.

Menambahkan diagram dan tabel ke dasbor

Bagian ini menjelaskan cara mengonfigurasi diagram dan tabel menggunakan konsol Google Cloud:

  • Diagram menampilkan data dari waktu ke waktu dan ada empat gaya yang tersedia: Garis, Area bertumpuk, Batang bertumpuk, dan Peta panas. Satu diagram dapat menampilkan beberapa jenis metrik. Misalnya, Anda dapat mengonfigurasi diagram untuk menampilkan byte disk yang dibaca dari instance dan byte disk yang ditulis ke instance.

    Setelah diagram dikonfigurasi, Anda dapat mengubah jenis widgetnya. Untuk mengetahui informasi tentang alasan Anda memilih gaya tertentu, lihat Diagram yang menampilkan data dari waktu ke waktu.

    Untuk informasi tentang cara menggunakan Cloud Monitoring API untuk mengonfigurasi diagram, lihat Dasbor dengan widget XyChart.

  • Tabel berisi satu baris untuk setiap kombinasi nilai label. Saat tabel menampilkan data dari beberapa jenis metrik, setiap baris berisi hasil dari semua kueri, jika penggabungan tersebut memungkinkan.

    Ada dua gaya tabel. Widget Tabel menampilkan nilai numerik seperti "25%". Widget Daftar Teratas menampilkan nilai dan indikator visual nilai dibandingkan dengan rentang kemungkinan nilai.

    Anda dapat mengubah gaya antara tabel dan diagram, mengonfigurasi nama kolom tabel, dan menambahkan nilai minimum yang mengubah warna sel tabel. Untuk mengetahui informasi selengkapnya dan contoh, lihat Menampilkan data dalam bentuk tabel di dasbor.

    Untuk informasi tentang cara menggunakan Cloud Monitoring API untuk mengonfigurasi tabel, lihat Dasbor dengan widget TimeSeriesTable.

Untuk menambahkan diagram atau tabel ke dasbor, lakukan tindakan berikut:

  1. Di konsol Google Cloud, buka halaman  Dasbor:

    Buka Dasbor

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

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

  3. Di toolbar, klik  Tambahkan widget.

  4. Pada dialog Tambahkan widget, pilih  Metrik.

  5. Tentukan data yang akan ditampilkan pada diagram. Anda dapat menggunakan antarmuka berbasis menu, Monitoring Query Language (MQL), PromQL, atau memasukkan filter Monitoring:

    1. Pilih data deret waktu yang ingin Anda lihat:

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

        Menu Select a metric berisi fitur yang membantu Anda menemukan jenis metrik yang tersedia:

        • Untuk menemukan jenis metrik tertentu, gunakan Panel filter . Misalnya, jika Anda memasukkan util, Anda akan membatasi menu untuk menampilkan entri yang menyertakan util. Entri ditampilkan jika lulus pengujian "berisi" 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 Tambahkan 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 informasi selengkapnya, lihat Memilih data untuk 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 diperbarui 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 zona.

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

      • Opsional: Untuk mengonfigurasi spasi antartitik data, klik Tambahkan elemen kueri, pilih Min Interval, lalu masukkan nilai.

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

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

    MQL

    1. Di toolbar panel pembuat kueri, pilih tombol yang namanya adalah  MQL atau  PromQL.
    2. Pastikan MQL dipilih di tombol Language. Tombol bahasa berada di toolbar yang sama yang memungkinkan Anda memformat kueri.

    3. Masukkan kueri Anda ke editor kueri. Misalnya, untuk memetakan Penggunaan CPU instance VM di project Google Cloud Anda, gunakan kueri berikut:

      fetch gce_instance
| metric 'compute.googleapis.com/instance/cpu/utilization'
| group_by 1m, [value_utilization_mean: mean(value.utilization)]
| every 1m

      Untuk informasi selengkapnya tentang MQL, lihat dokumen berikut:

    PromQL

    1. Di toolbar panel pembuat kueri, pilih tombol yang namanya adalah  MQL atau  PromQL.
    2. Pastikan PromQL dipilih di tombol Language. Tombol bahasa berada di toolbar yang sama yang memungkinkan Anda memformat kueri.

    3. Masukkan kueri Anda ke editor kueri. Misalnya, untuk memetakan penggunaan 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. Pada elemen Metrik, klik Bantuan, lalu pilih Direct Filter Mode.

      Elemen Metrik dan Filter dihapus, dan elemen Filter yang memungkinkan Anda memasukkan teks, 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 Monitoring 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 diperbarui 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 zona.

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

      • Opsional: Untuk mengonfigurasi spasi antartitik data, klik Tambahkan elemen kueri, pilih Min Interval, lalu masukkan nilai.

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

  6. Opsional: Konfigurasikan diagram atau tabel untuk menampilkan beberapa jenis metrik.

    1. Pilih Tambahkan kueri. Kueri baru ditambahkan. Misalnya, kueri dengan label B dapat 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.

    MQL

    Tidak didukung.

    PromQL

    Tidak didukung.

    Filter pemantauan

    Tidak didukung.

  7. Opsional: Konfigurasikan diagram untuk menampilkan rasio jenis metrik.

    1. Konfigurasikan 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 Tambahkan elemen kueri, 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 kumpulan label yang sama untuk kedua jenis metrik; tetapi, Anda hanya dapat memilih label yang sama untuk kedua jenis metrik.

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

      Setelah Anda membuat rasio, tiga kueri akan ditampilkan:

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

      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 mengganti metrik pembilang dan penyebut, di elemen Rasio, luaskan menu, lalu buat pilihan.

    MQL

    1. Di toolbar panel pembuat kueri, pilih tombol yang namanya adalah  MQL atau  PromQL.
    2. Pastikan MQL dipilih di tombol Language. Tombol bahasa berada di toolbar yang sama yang memungkinkan Anda memformat kueri.

    3. Masukkan kueri Anda ke editor kueri. MQL memungkinkan Anda menghitung rasio dua metrik yang berbeda, dan memungkinkan Anda memfilter satu metrik berdasarkan label, lalu menghitung rasionya. Kueri berikut menghitung rasio respons dengan nilai 500 terhadap jumlah total respons:

      fetch https_lb_rule::loadbalancing.googleapis.com/https/request_count
| {
    filter response_code_class = 500
  ;
    ident
  }
| group_by [matched_url_path_rule]
| outer_join 0
| div

      Untuk informasi selengkapnya tentang MQL, lihat dokumen berikut:

    PromQL

    1. Di toolbar panel pembuat kueri, pilih tombol yang namanya adalah  MQL atau  PromQL.
    2. Pastikan PromQL dipilih di tombol Language. Tombol bahasa berada di toolbar yang sama yang memungkinkan Anda memformat kueri.

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

  8. Opsional: Untuk mengubah visualisasi, di panel Display, klik Widget type, lalu buat pilihan.

    Menu Jenis widget mencantumkan semua jenis widget yang dapat menampilkan jenis data yang sama; namun, beberapa widget mungkin tidak diaktifkan. Misalnya, pertimbangkan diagram di dasbor yang dikonfigurasi untuk menampilkan satu jenis metrik. Diagram garis menampilkan beberapa deret waktu, dan setiap nilai yang diukur adalah ganda:

    • Widget Tabel, Diagram lingkaran, Diagram garis, Diagram batang bertumpuk, dan Diagram area bertumpuk tercantum sebagai Kompatibel. Anda dapat memilih salah satu jenis ini.

    • Widget Kartu skor dan Pengukur tercantum sebagai Kompatibel dengan penyesuaian karena widget ini hanya dapat menampilkan satu deret waktu. Untuk mengaktifkan jenis widget ini, ubah konfigurasi pengelompokan.

    • Widget Peta Panas dinonaktifkan karena widget ini hanya dapat menampilkan data bernilai distribusi.

    • Panel log tidak tercantum karena panel log tidak dapat menampilkan data deret waktu.

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

  10. Untuk menerapkan perubahan pada dasbor, di toolbar, klik Terapkan. Untuk menghapus perubahan, klik Batal.

  11. Untuk menyimpan dasbor yang telah diubah, klik Simpan di toolbar.

Hanya menampilkan data terbaru

Monitoring menyediakan beberapa cara untuk memvisualisasikan pengukuran terbaru saja, bukan melihat histori pengukuran:

  • Untuk menampilkan nilai terbaru dari setiap deret waktu secara grafis, dengan setiap nilai ditampilkan sebagai fraksi dari jumlah semua nilai, tambahkan diagram lingkaran. Anda dapat mengonfigurasi diagram ini untuk menampilkan total nilai.

  • Untuk menampilkan nilai terbaru dari setiap deret waktu dalam bentuk tabel, tambahkan tabel. Anda dapat membatasi jumlah baris dalam tabel, dan Anda dapat mengonfigurasi baris tabel untuk menampilkan nilai dibandingkan dengan rentang nilai.

  • Untuk mendapatkan indikasi hijau, kuning, atau merah dari nilai terbaru dibandingkan dengan kumpulan nilai minimum, tambahkan pengukur atau kartu skor ke dasbor.

Membuat grafik data terbaru dengan 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 nilai distribusi. Setiap deret waktu berkontribusi satu irisan pada lingkaran.

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

Contoh widget **PieChart**.

Untuk informasi tentang cara menambahkan diagram lingkaran ke dasbor, lihat dokumen berikut:

  • Konsol Google Cloud: Lihat bagian berjudul Menambahkan diagram dan tabel dalam dokumen ini.

    • Setelah Anda memilih data untuk diagram, di panel Display, tetapkan kolom Widget type ke Pie chart.
    • Untuk menampilkan nilai total, tetapkan kolom Jenis diagram ke Donut.

  • Cloud Monitoring API: Lihat Dasbor dengan widget PieChart.

Menampilkan data terbaru dalam bentuk tabel

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

Jika tabel menampilkan satu jenis metrik, setiap baris dalam tabel akan sesuai dengan satu deret waktu. Satu kolom tabel yang menampilkan nilai numerik, yang merupakan nilai terbaru atau nilai gabungan. Kolom lainnya menampilkan label dalam deret waktu. Jika tabel menampilkan beberapa jenis metrik, data untuk kedua jenis metrik akan ditampilkan di baris yang sama, jika memungkinkan. Untuk mengetahui informasi selengkapnya, lihat Cara tabel menggabungkan beberapa 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 urutan 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 informasi tentang cara mengonfigurasi tabel, lihat bagian berikut:

Screenshot berikut mengilustrasikan dua tabel. Tabel pertama menampilkan dua jenis metrik, jumlah byte yang dibaca dari instance dan jumlah byte yang ditulis ke instance. Nilai gabungan ditampilkan bersama dengan batang 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.

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, untuk setiap deret waktu, data dalam rentang waktu yang dipilih oleh dasbor Anda akan digabungkan oleh fungsi perataan. Fungsi perataan adalah salah satu opsi agregasi dan tidak ditampilkan secara default. Untuk melihat fungsi penyelarasan, luaskan elemen Aggregation dan di elemen pertama, pilih Configure aligner. Setelah Anda membuat pilihan ini, elemen Aggregation akan diganti dengan elemen Grouping dan menu bernama Alignment function.

Memilih 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, lalu buat pilihan Anda.

Mengonfigurasi format kolom

  • Untuk mengonfigurasi setiap kolom, di elemen Columns, luaskan menu Override column, 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 Left align, Center align, dan Right align.
    • 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 akan otomatis dikonfigurasi saat Anda mengonfigurasi kueri menggunakan pilihan menu.

Menampilkan nilai referensi

Tabel hanya dapat menampilkan nilai, atau dapat menampilkan nilai yang 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 referensi ditampilkan, gunakan elemen Tampilan metrik.

Mengurutkan dan memfilter tabel

Anda dapat mengubah urutan baris dalam tampilan tabel, dan Anda dapat memfilter konten tabel sehingga hanya baris tertentu yang ditampilkan. Setelan ini tidak permanen. 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 ATAU di antara dua filter, operator AND logika 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.

Menampilkan data terbaru dengan indikasi peringatan atau error

Untuk melihat pengukuran terbaru dibandingkan dengan kumpulan nilai minimum berkode 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 akan berwarna putih. Jika nilai berada dalam rentang peringatan, widget akan berwarna oranye. Demikian pula, saat nilai berada dalam rentang bahaya, widget akan berwarna merah.

Kedua widget menampilkan satu deret waktu. Screenshot berikut menunjukkan contoh pengukur saat pengukuran terbaru kurang dari nilai minimum peringatan dan bahaya:

Contoh pengukur.

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

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

  1. Di konsol Google Cloud, buka halaman  Dasbor:

    Buka Dasbor

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

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

  3. Di toolbar, klik  Tambahkan widget.

  4. Pada dialog Tambahkan widget, pilih  Metrik.

  5. Tentukan data yang akan ditampilkan pada diagram. Anda dapat menggunakan antarmuka berbasis menu, Monitoring Query Language (MQL), PromQL, atau memasukkan filter Monitoring:

    1. Pilih data deret waktu yang ingin Anda lihat:

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

        Menu Select a metric berisi fitur yang membantu Anda menemukan jenis metrik yang tersedia:

        • Untuk menemukan jenis metrik tertentu, gunakan Panel filter . Misalnya, jika Anda memasukkan util, Anda akan membatasi menu untuk menampilkan entri yang menyertakan util. Entri ditampilkan jika lulus pengujian "berisi" 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 Tambahkan 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 informasi selengkapnya, lihat Memilih data untuk diagram.

    2. Gabungkan deret waktu menggunakan kolom Aggregation:

      • Luaskan menu pertama dan pilih fungsi yang menggabungkan deret waktu.
      • Luaskan menu kedua dan pastikan tidak ada label yang dipilih.

    MQL

    1. Di toolbar panel pembuat kueri, pilih tombol yang namanya adalah  MQL atau  PromQL.
    2. Pastikan MQL dipilih di tombol Language. Tombol bahasa berada di toolbar yang sama yang memungkinkan Anda memformat kueri.

    3. Masukkan kueri Anda ke editor kueri. Anda harus memastikan bahwa kolom agregasi ditetapkan untuk menggabungkan semua deret waktu. Misalnya, untuk memetakan penggunaan CPU instance VM di project Google Cloud Anda, gunakan kueri berikut:

      fetch gce_instance
| metric 'compute.googleapis.com/instance/cpu/utilization'
| group_by 1m, [value_utilization_mean: mean(value.utilization)]
| every 1m
| group_by [], [value_utilization_mean_mean: mean(value_utilization_mean)]

      Untuk informasi selengkapnya tentang MQL, lihat dokumen berikut:

    PromQL

    1. Di toolbar panel pembuat kueri, pilih tombol yang namanya adalah  MQL atau  PromQL.
    2. Pastikan PromQL dipilih di tombol Language. Tombol bahasa berada di toolbar yang sama yang memungkinkan Anda memformat kueri.

    3. Masukkan kueri Anda ke editor kueri. Misalnya, untuk memetakan penggunaan 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. Pada elemen Metrik, klik Bantuan, lalu pilih Direct Filter Mode.

      Elemen Metrik dan Filter dihapus, dan elemen Filter yang memungkinkan Anda memasukkan teks, 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 Monitoring.

    3. Gabungkan deret waktu menggunakan kolom Aggregation:

      • Luaskan menu pertama dan pilih fungsi yang menggabungkan deret waktu.
      • Luaskan menu kedua dan pastikan tidak ada label yang dipilih.

  6. Di panel Display, konfigurasikan pengukur atau kartu skor:

    1. Klik Jenis widget dan pilih Pengukur atau Kartu skor.

    2. Untuk widget pengukur, klik Rentang pengukur, lalu tetapkan nilai minimum dan maksimum. Saat pengukur menampilkan persentase, tetapkan nilai ini ke 0 dan 1.

    3. Klik Nilai minimum pengukur, lalu tetapkan nilai minimum peringatan dan bahaya. Kolom nilai minimum yang kosong tidak 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.

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

  7. Untuk menerapkan perubahan pada dasbor, di toolbar, klik Terapkan. Untuk menghapus perubahan, klik Batal.

  8. Untuk menyimpan dasbor yang telah diubah, klik Simpan di toolbar.

Cara tabel menggabungkan data untuk beberapa jenis metrik

Jika tabel membuat kueri untuk 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 sama untuk kedua kueri memungkinkan Monitoring menentukan ID baris unik, satu baris di tabel akan menampilkan nilai terbaru untuk setiap kueri. Jika tidak, ada satu baris untuk setiap deret waktu.

Misalnya, tabel mengkueri dua jenis metrik yang berbeda. Mari kita sebut kueri ini 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, 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 dengan zona 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 kedua kueri tersebut memiliki beberapa label, tetapi tidak cukup untuk membentuk ID baris yang unik, hasil tidak dapat digabungkan. Tabel mencantumkan satu baris untuk setiap deret waktu yang ditampilkan oleh kueri A atau oleh 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.

Menyelesaikan kegagalan penggabungan

Saat Anda memetakan 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 dari jenis metrik lainnya.

Misalnya, pertimbangkan tabel yang dikonfigurasi dengan dua kueri:

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

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

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

Untuk mengatasi kegagalan, konversikan 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 ini, kedua kueri 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 informasi tentang cara menggunakan PromQL, lihat PromQL di Cloud Monitoring.

Langkah selanjutnya

Anda juga dapat menambahkan widget berikut ke dasbor kustom:

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