Jenis nilai dan jenis metrik

Setiap metrik di Cloud Monitoring memiliki jenis nilai dan jenis metrik yang menentukan format data setiap titik dan hubungan titik-titik yang berurutan dari waktu ke waktu. Memahami kedua atribut ini akan membantu Anda menafsirkan metrik bawaan, menggabungkan deret waktu secara akurat, dan memilih kombinasi yang valid saat Anda mendesain metrik kustom. Untuk ringkasan semua atribut jenis metrik, lihat Jenis metrik.

Jenis nilai

Jenis nilai adalah jenis data untuk pengukuran. Setiap deret waktu mencatat jenis nilai (jenis ValueType) untuk titik datanya.

• Untuk pengukuran yang terdiri dari satu nilai pada satu waktu, seperti nilai boolean dan data numerik, jenis nilai memberi tahu Anda cara data disimpan:

  • BOOL, boolean
  • INT64, bilangan bulat 64-bit
  • DOUBLE, float presisi ganda
  • STRING, string

• Untuk pengukuran distribusi, nilainya bukan nilai tunggal, melainkan grup nilai. Jenis nilai untuk pengukuran distribusi adalah DISTRIBUTION.

  Distribusi berisi statistik yang meringkas sekelompok nilai. Nilai dalam distribusi mencakup rata-rata, jumlah, maksimum, dan statistik lainnya, yang dihitung untuk sekelompok nilai. Distribusi juga dapat menyertakan histogram yang menunjukkan bagaimana nilai didistribusikan di seluruh kumpulan rentang.

Metrik latensi biasanya menangkap data sebagai distribusi. Untuk mengetahui informasi selengkapnya tentang distribusi, lihat halaman referensi Distribution. Untuk mengetahui informasi tentang cara membuat diagram metrik ini, lihat Metrik distribusi.

Jenis metrik

Setiap deret waktu menyertakan jenis metrik (jenis MetricKind) untuk titik datanya. Kolom ini memberi tahu Anda cara menafsirkan nilai titik data yang relatif satu sama lain:

• Metrik gauge, yang nilainya mengukur momen tertentu dalam waktu. Misalnya, metrik yang mengukur pemakaian CPU adalah metrik gauge; setiap titik mencatat pemakaian CPU pada saat pengukuran. Contoh lain dari metrik pengukur adalah suhu saat ini.

• Metrik delta, yang nilainya mengukur perubahan dalam interval waktu. Untuk pembacaan, interval waktunya setengah terbuka: tidak termasuk waktu mulai, tetapi termasuk waktu berakhir, (startTime, endTime]. Misalnya, metrik yang mengukur jumlah permintaan adalah metrik delta; setiap nilai mencatat jumlah permintaan yang diterima setelah waktu mulai, hingga dan termasuk waktu akhir.

  Catatan: Semua metrik yang menghitung item diskret selama interval waktu adalah metrik delta. Nilai tersebut seharusnya berupa bilangan bulat, tetapi karena alasan implementasi historis, nilai tersebut dilaporkan sebagai angka floating point.

• Metrik kumulatif, yang nilainya terus meningkat seiring waktu. Misalnya, metrik untuk “byte terkirim” mungkin bersifat kumulatif; setiap nilai mencatat jumlah total byte yang dikirim oleh layanan pada saat itu.

Kombinasi yang didukung

Tidak semua kombinasi jenis metrik dan jenis nilai masuk akal. Misalnya, Anda tidak akan pernah melihat metrik delta dengan data boolean. Ada kombinasi tertentu yang masuk akal jika digabungkan.

Tabel berikut mencantumkan jenis metrik dan jenis nilai yang didukung:

Jenis nilai	GAUGE	DELTA	CUMULATIVE^4
BOOL	ya	tidak	tidak
INT64	ya	ya^1	ya
DOUBLE	ya	ya^1	ya
STRING	ya^1	tidak	tidak
DISTRIBUSI	ya^2	ya^1, 3	ya

¹ Kombinasi ini tidak diizinkan dalam metrik kustom, custom.googleapis.com.
² Kombinasi ini tidak diizinkan untuk metrik berbasis log. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi metrik berbasis log jenis distribusi.
³ Ini adalah satu-satunya kombinasi yang diizinkan untuk metrik berbasis log, logging.googleapis.com/user, dengan jenis nilai DISTRIBUTION; untuk informasi selengkapnya, lihat kolom metricDescriptor di referensi LogMetric Logging API.
⁴ Metrik kumulatif tidak dapat digunakan secara langsung untuk membuat diagram atau pemberitahuan di Monitoring, tetapi dapat digabungkan menjadi metrik non-kumulatif yang dapat digunakan dengan cara ini. Lihat Jenis, tipe, dan konversi metrik untuk mengetahui informasi selengkapnya.

Selain itu, jika membuat metrik sendiri, Anda hanya boleh menggunakan kombinasi jenis nilai dan jenis metrik yang valid.

Mengemulasi metrik kustom bernilai string

Nilai string dalam metrik kustom tidak didukung, tetapi Anda dapat mereplikasi fungsi metrik bernilai string dengan cara berikut:

• Buat metrik GAUGE menggunakan nilai INT64 sebagai enum yang dipetakan ke nilai string. Terjemahkan enum secara eksternal ke nilai string saat Anda mengkueri metrik.
• Buat metrik GAUGE dengan nilai BOOL dan label yang nilainya adalah salah satu string yang ingin Anda pantau. Gunakan boolean untuk menunjukkan apakah nilai tersebut adalah nilai aktif.

Misalnya, Anda ingin membuat metrik bernilai string yang disebut "status" dengan opsi yang memungkinkan OK, OFFLINE, atau PENDING. Anda dapat membuat metrik GAUGE dengan label bernama status_value. Setiap update akan menulis tiga deret waktu, satu untuk setiap status_value (OK, OFFLINE, atau PENDING), dengan nilai 1 untuk "true" atau 0 untuk "false".