Tentang metrik nilai distribusi

Dokumen ini menjelaskan cara membuat dan menafsirkan diagram yang menampilkan data metrik dari jenis nilai Distribution. Jenis nilai ini digunakan oleh layanan jika setiap pengukuran terlalu banyak untuk dikumpulkan, tetapi informasi statistik, seperti rata-rata atau persentil, tentang pengukuran tersebut bermanfaat. Misalnya, jika aplikasi bergantung pada traffic HTTP, Anda dapat menggunakan metrik bernilai distribusi yang merekam latensi respons HTTP untuk mengevaluasi seberapa cepat permintaan HTTP selesai.

Untuk menggambarkan cara pembuatan histogram, pertimbangkan layanan yang mengukur latensi HTTP permintaan dan melaporkan data ini menggunakan metrik dengan jenis nilai distribusi. Data dilaporkan setiap menit. Layanan ini menentukan rentang nilai untuk metrik, yang disebut bucket, dan mencatat jumlah nilai terukur yang masuk ke setiap bucket. Misalnya, saat permintaan HTTP selesai, layanan akan menambah jumlah dalam bucket yang rentangnya mencakup nilai latensi permintaan. Jumlah ini menciptakan histogram nilai untuk menit tersebut.

Asumsikan latensi yang diukur dalam interval satu menit adalah 5, 1, 3, 5, 6, 10, dan 14. Jika bucketnya adalah [0, 4), [4, 8), [8, 12), dan [12, 16), maka histogram data ini adalah [2, 3, 1, 1]. Tabel berikut menunjukkan pengaruh pengukuran individual terhadap jumlah setiap bucket:

Bucket Pengukuran latensi Jumlah nilai dalam bucket
[12,16) 14 1
[8,12) 10 1
[4,8) 5, 5, 6 3
[0,4) 1, 3 2

Saat data ini ditulis ke deret waktu, objek Point akan dibuat. Untuk metrik dengan nilai distribusi, objek tersebut menyertakan histogram nilai. Untuk periode pengambilan sampel ini, Point berisi [2, 3, 1, 1]. Pengukuran individu tidak dituliskan ke dalam deret waktu.

Asumsikan bahwa tabel sebelumnya mencatat histogram untuk data latensi seperti yang diukur pada waktu 1:00. Tabel tersebut menggambarkan cara mengambil serangkaian pengukuran dan mengonversinya menjadi jumlah bucket. Misalkan bucket menghitung pada waktu 1:01, 1:02, dan 1:03 seperti ditunjukkan pada tabel berikut:

Bucket Histogram untuk
1.00		 Histogram untuk
1:01		 Histogram untuk
1.02		 Histogram untuk
1.03
[12,16) 1 6 0 1
[8,12) 1 0 2 2
[4,8) 3 1 1 8
[0,4) 2 6 10 3

Tabel sebelumnya menampilkan urutan histogram yang diindeks menurut waktu. Setiap kolom dalam tabel mewakili data latensi selama periode satu menit. Untuk mendapatkan jumlah pengukuran pada waktu tertentu, jumlahkan jumlah bucket. Namun, pengukuran sebenarnya tidak ditampilkan karena pengukuran tersebut tidak tersedia dalam metrik yang bernilai distribusi.

Diagram peta panas

Diagram peta panas dirancang untuk menampilkan satu deret waktu dengan nilai distribusi. Untuk diagram ini, sumbu X mewakili waktu, sumbu Y mewakili bucket, dan warna mewakili nilai. Semakin cerah warnanya mengindikasikan nilai yang lebih tinggi. Misalnya, area gelap peta panas menunjukkan jumlah bucket lebih rendah daripada area kuning atau putih.

Gambar berikut adalah salah satu representasi peta panas untuk contoh sebelumnya:

Diagram peta panas untuk contoh.

Pada gambar sebelumnya, peta panas menggunakan warna hitam untuk menampilkan jumlah bucket terkecil, 0, dan kuning untuk menampilkan jumlah bucket terbesar, yaitu 10. Warna merah dan oranye mewakili nilai di antara dua hal ekstrem ini.

Karena diagram peta panas hanya dapat menampilkan satu deret waktu, Anda harus menetapkan opsi agregasi untuk menggabungkan semua deret waktu.

Untuk menggunakan Metrics Explorer guna menampilkan jumlah latensi RTT dari instance VM, lakukan tindakan berikut:

  1. Pada panel navigasi Konsol Google Cloud, pilih Monitoring, lalu pilih  Metrics Explorer:

    Buka Metrics Explorer

  2. Pada elemen Metrik, luaskan menu Pilih metrik, masukkan RTT latencies di panel filter, lalu gunakan submenu untuk memilih jenis dan metrik resource tertentu:
    1. Di menu Active resources, pilih VM Instance.
    2. Di menu Active metric category, pilih Vm_flow.
    3. Di menu Active metrics, pilih Latensi RTT.
    4. Klik Apply.

Pada contoh sebelumnya, diagram peta panas dikonfigurasi dengan memilih nilai dari menu. Namun, Anda juga dapat menggunakan Bahasa Kueri Monitoring (MQL) untuk membuat diagram metrik yang bernilai distribusi. Untuk memasukkan kueri MQL, lakukan hal berikut:

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

Misalnya, masukkan berikut ini ke dalam editor kode:

fetch gce_instance
| metric 'networking.googleapis.com/vm_flow/rtt'
| align delta(1m)
| every 1m
| group_by [], [aggregate(value.rtt)]

Pada ekspresi sebelumnya, data deret waktu diambil, disejajarkan, lalu dikelompokkan. Proses penyelarasan menggunakan fungsi penyelarasan delta dengan periode penyelarasan satu menit. Karena argumen pertama untuk group_by adalah [], semua deret waktu akan digabungkan. Argumen kedua, [aggregate(value.rtt)], menentukan cara penggabungan deret waktu. Dalam contoh ini, untuk setiap stempel waktu, nilai kolom rtt dari deret waktu yang berbeda akan digabungkan dengan fungsi aggregate, yang dipilih oleh MQL.

Jika Anda menggunakan menu untuk memilih metrik, kemudian beralih ke MQL, pilihan Anda akan dikonversi menjadi kueri MQL yang memiliki bentuk ketat:

fetch gce_instance
| metric 'networking.googleapis.com/vm_flow/rtt'
| align delta(1m)
| every 1m
| group_by [], [value_rtt_aggregate: aggregate(value.rtt)]

Ekspresi sebelumnya secara fungsional setara dengan contoh MQL asli.

Untuk informasi selengkapnya tentang MQL, lihat Ringkasan Pemantauan Bahasa Kueri.

Diagram garis dan batang

Diagram garis, diagram batang bertumpuk, dan diagram garis bertumpuk, yang dirancang untuk menampilkan data skalar, tidak dapat menampilkan nilai distribusi. Untuk menampilkan metrik dengan nilai distribusi dengan salah satu jenis diagram ini, Anda harus mengonversi nilai histogram menjadi nilai skalar. Misalnya, Anda dapat menetapkan opsi agregasi untuk menghitung rata-rata nilai dalam histogram atau untuk menghitung persentil.

Untuk informasi tentang cara menampilkan metrik nilai distribusi pada diagram garis, lihat bagian berikut.

Metrik agregasi dan distribusi

Agregasi adalah proses regularisasi titik dalam deret waktu dan menggabungkan beberapa deret waktu. Agregasi sama untuk metrik jenis distribusi seperti halnya metrik yang memiliki jenis nilai bilangan bulat atau ganda. Namun, jenis diagram ini menerapkan beberapa persyaratan pada pilihan yang digunakan untuk menyelaraskan dan mengelompokkan deret waktu.

Diagram peta panas

Diagram peta panas menampilkan satu deret waktu bernilai distribusi. Oleh karena itu, fungsi perataan dan fungsi pengelompokan harus ditetapkan untuk membuat satu deret waktu.

Pilih fungsi perataan sum atau delta saat diagram menampilkan peta panas. Fungsi-fungsi ini menggabungkan semua sampel untuk satu deret waktu pada level bucket yang berada dalam periode penyelarasan yang sama, dan hasilnya adalah nilai distribusi. Misalnya, jika dua sampel deret waktu yang berdekatan adalah [2, 3, 1, 1] dan [2, 5, 4, 1], maka fungsi penyelarasan jumlah akan menghasilkan [4, 8, 5, 2].

Fungsi pengelompokan menentukan cara penggabungan deret waktu yang berbeda. Fungsi ini terkadang disebut agregator atau pengurang. Untuk peta panas, tetapkan fungsi pengelompokan ke fungsi sum. Fungsi jumlah menambahkan nilai bucket yang sama di semua histogram, sehingga menghasilkan histogram baru. Misalnya, jumlah nilai [2, 3, 1, 1] dari deret waktu-A dan nilai [1, 5, 2, 2] dari deret waktu-B adalah [3, 8, 3, 3].

Diagram garis

Diagram garis hanya menampilkan deret waktu bernilai skalar. Jika Anda memilih metrik yang bernilai distribusi, diagram akan dikonfigurasi dengan parameter optimal untuk menampilkan heat map. Kolom elemen Agregasi ditetapkan ke Distribution dan None.

  • Penafsiran Distribusi bergantung pada metrik tertentu. Untuk jenis metrik bernilai distribusi yang memiliki jenis metrik GAUGE, fungsi penyelarasan default ditetapkan ke sum. Jika jenis metrik bernilai distribusi memiliki jenis metrik CUMULATIVE, fungsi penyelarasan default adalah DELTA.

  • Setelan Tidak ada memastikan bahwa semua waktu digabungkan.

Jika ingin menampilkan metrik nilai distribusi pada diagram garis, Anda harus mengubah setelan default diagram. Misalnya, untuk mengonfigurasi diagram garis di dasbor guna menampilkan persentil ke-99 dari setiap deret waktu untuk metrik yang bernilai distribusi, lakukan tindakan berikut:

  1. Pada panel navigasi Konsol Google Cloud, pilih Monitoring, lalu pilih  Dashboards:

    Buka Dasbor

  2. Di toolbar, klik  Tambahkan widget.
  3. Dalam dialog Add widget, pilih  Metric.
  4. Pada elemen Metric, lalu pilih metrik VM Instance - RTT latencies.
  5. Di elemen Agregasi, luaskan menu pertama dan pilih 99th persentil.
  6. Di panel Display, tetapkan nilai menu Widget type ke Diagram garis.
  7. Opsional: Di elemen Agregasi, luaskan menu kedua dan pilih label yang digunakan untuk mengelompokkan deret waktu. Secara {i>default<i}, tidak ada label yang dipilih, sehingga satu baris ditampilkan pada diagram.

Langkah selanjutnya

Untuk mengetahui informasi tentang cara menentukan model bucket untuk metrik dan cara menafsirkan persentil, lihat Persentil dan metrik nilai distribusi.