Jenis nilai dan jenis metrik

Dalam pembahasan model metrik, bagian Jenis metrik memberikan pembahasan umum tentang atribut yang mendeskripsikan jenis metrik. Bagian ini memberikan diskusi yang lebih rinci tentang dua atribut tersebut:

• Jenis nilai
• Jenis metrik

Jenis nilai

Jenis nilai adalah jenis data untuk pengukuran. Setiap deret waktu merekam 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, nilai bukan berupa nilai tunggal, melainkan sekelompok nilai. Jenis nilai untuk pengukuran distribusi adalah DISTRIBUTION.

  Distribusi berisi statistik yang merangkum sekelompok nilai. Nilai dalam distribusi mencakup mean, jumlah, maks, dan statistik lainnya, yang dihitung untuk sekelompok nilai. Distribusi juga dapat menyertakan histogram yang mewakili bagaimana nilai didistribusikan di seluruh kumpulan rentang.

  Metrik latensi biasanya mengambil data sebagai distribusi. Untuk informasi selengkapnya tentang distribusi, lihat halaman referensi Distribution. Untuk informasi tentang pembuatan diagram metrik ini, lihat Metrik distribusi.

Jenis metrik

Setiap deret waktu menyertakan jenis metrik (jenis MetricKind) untuk titik datanya. Jenis data metrik memberi tahu Anda cara menafsirkan nilai tersebut secara relatif satu sama lain. Metrik Cloud Monitoring merupakan salah satu dari tiga jenis metrik berikut:

• Metrik gauge, yang mana nilai tersebut mengukur waktu tertentu secara instan. Misalnya, metrik yang mengukur pemakaian CPU adalah metrik pengukur; setiap titik mencatat pemakaian CPU pada saat pengukuran. Contoh lain dari metrik pengukur adalah suhu saat ini.

• Metrik delta, yang digunakan untuk mengukur perubahan dalam interval waktu. Untuk operasi baca, interval waktu adalah setengah terbuka, yang tidak mencakup waktu mulai, tetapi menyertakan 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 berakhir.

  Catatan: Semua metrik yang menghitung item terpisah selama interval waktu adalah metrik delta. Nilai tersebut wajar jika diperkirakan berupa bilangan bulat, tetapi untuk alasan implementasi historis, nilai tersebut dilaporkan sebagai bilangan floating point.

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

Kombinasi yang didukung

Tidak semua kombinasi jenis metrik dan jenis nilai masuk akal. Misalnya, Anda tidak pernah melihat metrik delta dengan data boolean. Ada kombinasi tertentu yang masuk akal bersama-sama.

Tabel berikut mencantumkan jenis metrik dan jenis nilai yang didukung:

Jenis nilai	GAUGE	Delta	KUMULATIF^4
BOOL	ya	tidak	tidak ada
INT64	ya	ya^1	ya
DOUBLE	ya	ya^1	ya
STRING	ya^1	tidak ada	tidak ada
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 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 mengetahui informasi selengkapnya, lihat kolom metricDescriptor di referensi Logging API LogMetric.
⁴ Metrik kumulatif tidak dapat digunakan langsung untuk pembuatan diagram atau pemberitahuan di Monitoring, tetapi dapat digabungkan menjadi metrik non-kumulatif yang dapat digunakan dengan cara ini. Lihat Jenis, jenis, dan konversi untuk informasi selengkapnya.

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

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 menjadi nilai string saat Anda membuat kueri metrik.
• Buat metrik GAUGE dengan nilai BOOL dan label yang nilainya merupakan salah satu string yang ingin Anda pantau. Gunakan boolean untuk menunjukkan apakah nilainya adalah nilai aktif.

Misalnya, Anda ingin membuat metrik bernilai string yang disebut "status" dengan kemungkinan opsi OK, Offline, atau PENDING. Anda dapat membuat metrik GAUGE dengan label yang disebut 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".