Jenis nilai dan jenis metrik

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

• Jenis nilai
• 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 akan 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, tetapi sekelompok nilai. Jenis nilai untuk pengukuran distribusi adalah DISTRIBUTION.

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

Metrik latensi biasanya mengambil data sebagai distribusi. Untuk informasi selengkapnya tentang distribusi, lihat halaman referensi Distribution. Untuk informasi tentang cara memetakan 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 secara relatif terhadap satu sama lain. Metrik Cloud Monitoring terdiri dari tiga jenis:

• Metrik indikator, dengan nilai yang mengukur momen tertentu dalam waktu. Misalnya, metrik yang mengukur penggunaan CPU adalah metrik pengukur; setiap titik mencatat penggunaan CPU pada saat pengukuran. Contoh lain metrik pengukur adalah suhu saat ini.

• Metrik delta, dengan nilai yang mengukur perubahan dalam interval waktu. Untuk operasi baca, interval waktunya setengah terbuka, yang mengecualikan 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 akhir.

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

• Metrik kumulatif, dengan nilai yang 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 akan pernah melihat metrik delta dengan data boolean. Ada kombinasi tertentu yang cocok.

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 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 dalam 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, jenis, dan konversi untuk mengetahui informasi selengkapnya.

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

Mengemulasikan 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 kemungkinan opsi OK, OFFLINE, atau PENDING. Anda dapat membuat metrik GAUGE dengan label bernama status_value. Setiap pembaruan akan menulis tiga deret waktu, satu untuk setiap status_value (OK, OFFLINE, atau PENDING), dengan nilai 1 untuk "true" atau 0 untuk "false".