Komponen model metrik

Model Cloud Monitoring untuk memantau data terdiri dari tiga konsep utama:

  • Jenis resource yang dipantau
  • Jenis metrik
  • Deret waktu

Dokumen Model metrik menjelaskan konsep Cloud Monitoring ini secara umum. Jika konsep ini baru bagi Anda, baca halaman tersebut terlebih dahulu.

Halaman ini menjelaskan jenis metrik, resource yang dipantau, dan deret waktu, beserta beberapa konsep terkait, secara lebih mendetail. Konsep-konsep ini mendasari semua metrik Pemantauan.

Anda harus memahami informasi di halaman ini sebelum mencoba mengambil data pemantauan mentah atau gabungan menggunakan Monitoring API, seperti yang dijelaskan dalam Mengambil data deret waktu. Untuk mengetahui detail selengkapnya tentang konsep ini dan cara pemetaannya ke Cloud Monitoring API, lihat Struktur deret waktu, terutama jika Anda berencana menggunakan Monitoring API.

Kata-kata tentang label

Jenis resource yang dipantau dan jenis metrik mendukung label, yang memungkinkan data diklasifikasikan selama analisis. Contoh:

  • Jenis resource yang dipantau untuk virtual machine dapat mencakup label untuk lokasi mesin dan project ID yang terkait dengan mesin. Saat informasi tentang resource yang dipantau dicatat, informasi tersebut mencakup nilai untuk label.
  • Jenis metrik yang menghitung permintaan API mungkin memiliki label untuk mencatat nama metode yang dipanggil dan status permintaan.

Penggunaan label dibahas lebih mendetail di Label.

Jenis resource yang dipantau

Resource yang dipantau adalah resource yang data metriknya diambil. Cloud Monitoring mendukung sekitar 270 jenis resource yang dipantau.

Jenis resource yang dipantau mencakup node dan tugas generik, komponen arsitektur di Google Kubernetes Engine, dan banyak lagi.

Setiap jenis resource yang dimonitor dijelaskan secara formal dalam struktur data yang disebut deskriptor resource yang dimonitor. Untuk mengetahui informasi selengkapnya, lihat Deskripsi resource yang dipantau.

Setiap jenis resource yang dimonitor yang didukung memiliki entri dalam Daftar resource yang dimonitor. Entri dalam daftar dibuat dari deskriptor resource yang dipantau. Bagian ini menjelaskan informasi yang dicatat dalam deskriptor resource yang dipantau dan menunjukkan cara informasi tersebut ditampilkan dalam daftar.

Contoh jenis resource yang dimonitor

Gambar berikut menunjukkan entri dalam daftar untuk bucket Cloud Storage:

Daftar untuk bucket Cloud Storage.

Semua entri dalam daftar menyertakan informasi berikut:

  • Type: Header dalam entri mencantumkan jenis resource yang dimonitor; gcs_bucket dalam contoh.
  • Nama tampilan: Deskripsi singkat tentang resource yang dipantau.
  • Deskripsi: Deskripsi yang lebih panjang dari resource yang dipantau.
  • Label: Kumpulan dimensi untuk mengklasifikasikan data. Untuk mengetahui informasi selengkapnya, lihat Label.

Jenis metrik

Jenis metrik menjelaskan pengukuran yang dapat dikumpulkan dari resource yang dipantau. Jenis metrik mencakup deskripsi tentang apa yang diukur dan cara menafsirkan pengukuran.

Jenis metrik mencakup jumlah panggilan API, statistik penggunaan disk, konsumsi penyimpanan, dan banyak lagi.

Setiap jenis metrik dijelaskan secara formal dalam struktur data yang disebut deskripsi metrik. Untuk mengetahui informasi selengkapnya, lihat Deskripsi metrik.

Setiap jenis metrik bawaan memiliki entri di halaman Daftar metrik. Entri dalam tabel ini dibuat dari deskriptor metrik. Bagian ini menjelaskan informasi yang dicatat dalam jenis metrik dan menunjukkan cara penyajiannya dalam materi referensi.

Contoh jenis metrik

Gambar berikut menunjukkan entri untuk jenis metrik Cloud Storage:

Kutipan daftar metrik untuk Cloud Storage.

Jenis metrik ditampilkan dalam tabel, dan header tabel menjelaskan tata letak informasi. Bagian ini menggunakan satu entri sebagai contoh, tetapi semua tabel menggunakan format yang sama.

Entri tabel Cloud Storage contoh memberi Anda informasi berikut tentang satu jenis metrik:

  • Jenis metrik: ID untuk jenis metrik, storage.googleapis.com/api/request_count dalam contoh.

    Awalan storage.googleapis.com berfungsi sebagai namespace untuk Cloud Storage. Semua jenis metrik yang terkait dengan jenis monitored-resource tertentu menggunakan namespace yang sama.

    Namespace dihilangkan dari entri dalam tabel.

    Semua jenis metrik yang terkait dengan Cloud Storage tercantum dalam tabel untuk metrik Cloud Storage.

  • Tahap peluncuran: Blok berwarna yang menunjukkan tahap peluncuran jenis metrik dengan nilai seperti Alpha, Beta, dan GA.

  • Nama tampilan: String singkat yang menjelaskan jenis metrik, “Jumlah permintaan” dalam contoh.

  • Jenis, Tipe, Satuan: Baris ini memberikan informasi untuk menafsirkan nilai data: contohnya menunjukkan metrik delta yang dicatat sebagai bilangan bulat 64-bit tanpa satuan (yaitu nilai 1).

    • Jenis: Contoh ini adalah metrik delta, yang mencatat perubahan selama jangka waktu tertentu. Artinya, setiap titik data mencatat jumlah panggilan API sejak titik data sebelumnya ditulis. Untuk mengetahui informasi selengkapnya tentang jenis, lihat Jenis nilai dan jenis metrik.

    • Jenis: Contoh ini mencatat nilainya sebagai bilangan bulat 64-bit. Untuk mengetahui informasi selengkapnya tentang jenis, lihat Jenis nilai dan jenis metrik.

    • Unit: Metrik ini tidak memerlukan unit eksplisit karena mewakili jumlah; digit 1 digunakan untuk menunjukkan bahwa tidak ada unit yang diperlukan.

  • Resource yang dipantau: Resource yang dipantau yang jenis metriknya ini tersedia. Nilai di sini sama dengan yang dijelaskan dalam Jenis resource yang dipantau.

  • Deskripsi: Informasi yang lebih mendetail tentang apa yang direkam dan caranya. Ditetapkan dalam huruf miring untuk membedakannya dari label.

  • Label: Kumpulan dimensi untuk mengklasifikasikan data. Untuk mengetahui informasi selengkapnya, lihat Label.

Saat mengakses data pemantauan melalui Cloud Monitoring API, Anda menyertakan Cloud de Confiance project dalam panggilan API. Anda hanya dapat mengambil data yang terlihat oleh project Cloud de Confiance tersebut. Misalnya, jika Anda meminta data project untuk jenis metrik storage.googleapis.com/api/request_count, Anda hanya akan melihat jumlah API untuk bucket Cloud Storage di project Anda. Jika project Anda tidak menggunakan bucket Cloud Storage, tidak ada data metrik yang ditampilkan.

Jenis metrik bawaan

Jenis metrik bawaan ditentukan oleh Cloud de Confiance by S3NS layanan, termasuk Cloud Monitoring. Jenis metrik ini menjelaskan pengukuran standar untuk berbagai infrastruktur umum dan tersedia untuk digunakan oleh siapa saja.

Daftar metrik menampilkan seluruh kumpulan jenis metrik bawaan.

Label

Label adalah pasangan nilai kunci yang dapat digunakan untuk memberikan informasi tentang nilai data.

Label metrik dan resource yang dipantau

Definisi jenis metrik dan resource yang dipantau mencakup label. Label adalah pengklasifikasi untuk data yang dikumpulkan; label membantu mengategorikan data untuk analisis yang lebih mendalam. Contoh:

  • Jenis metrik Cloud Storage storage.googleapis.com/api/request_count memiliki dua label, response_code dan method.
  • Jenis resource yang dipantau Cloud Storage gcs_bucket memiliki tiga label, project_id, bucket_name, dan location. Label mengidentifikasi instance tertentu dari jenis resource.

Oleh karena itu, semua data yang dikumpulkan untuk permintaan API dari bucket Cloud Storage diklasifikasikan berdasarkan metode yang dipanggil, kode respons untuk panggilan, nama, lokasi, dan project bucket yang terlibat. Kumpulan label bervariasi menurut metrik atau jenis resource yang dimonitor; label yang tersedia didokumentasikan di halaman Daftar metrik dan Daftar resource yang dimonitor.

Dengan melacak kode respons, nama metode, dan lokasi saat menghitung panggilan API, Anda kemudian dapat mengambil jumlah panggilan ke metode API tertentu, atau jumlah panggilan yang gagal ke metode apa pun, atau jumlah panggilan yang gagal ke metode tertentu di lokasi tertentu.

Jumlah label dan jumlah nilai yang dapat diasumsikan masing-masing disebut sebagai kardinalitas. Kardinalitas adalah jumlah kemungkinan deret waktu yang dapat dikumpulkan untuk pasangan jenis metrik dan resource yang dipantau: ada satu deret waktu untuk setiap kombinasi nilai labelnya. Untuk mengetahui informasi selengkapnya, lihat Kardinalitas: deret waktu dan label.

Deret waktu: data dari resource yang dipantau

Bagian ini membahas apa yang dimaksud dengan data pemantauan dan cara pengaturannya dalam deret waktu. Di sinilah komponen konseptual model metrik menjadi artefak konkret.

Cloud Monitoring menyimpan pengukuran reguler dari waktu ke waktu untuk pasangan metrik dan jenis resource yang dimonitor. Pengukuran dikumpulkan ke dalam deret waktu, dan setiap deret waktu berisi item berikut:

  • Nama jenis metrik yang memiliki deret waktu, dan satu kombinasi nilai untuk label metrik.

  • Serangkaian pasangan (stempel waktu, nilai). Nilai adalah pengukuran, dan stempel waktu adalah waktu saat pengukuran dilakukan.

  • Resource yang dipantau yang merupakan sumber data deret waktu, dan satu kombinasi nilai untuk label resource.

Deret waktu dibuat untuk setiap kombinasi metrik dan label resource yang menghasilkan data.

Contoh yang distilisasi: Jenis metrik storage.googleapis.com/api/request_count dapat memiliki banyak deret waktu untuk bucket Cloud Storage project Anda. Tabel berikut menunjukkan beberapa kemungkinan deret waktu.

Dalam tabel, nilai bucket: xyz mewakili nilai label bucket_name dalam jenis resource yang dipantau, dan response_code serta method adalah label dalam jenis metrik. Ada satu deret waktu untuk setiap kombinasi nilai dalam label metrik dan resource; tabel menampilkan beberapa di antaranya:

Label resource
yang dipantau		 Label metrik Data metrik
bucket: 1234 response_code: OK,
method: read		 {
(3, Wed 2:00pm),
(2, Wed 2:05pm),
(8, Wed 2:10pm),
...}
bucket: 1234 response_code: OK,
method: write		 {
(1, Wed 2:01pm),
(2, Wed 2:04pm),
(7, Wed 2:09pm),
...}
bucket: 1234 response_code: FAIL,
method: write		 {
(1, Wed 2:01pm),
(0, Wed 2:04pm),
(0, Wed 2:09pm),
...}
bucket: 9876 response_code: OK,
method: read		 {
(2, Wed 1:59pm),
(4, Wed 2:05pm),
(3, Wed 2:10pm),
...}

Cloud Monitoring tidak mencatat deret waktu “kosong”. Dalam contoh bucket Cloud Storage, jika Anda tidak menggunakan bucket tertentu atau tidak pernah memanggil metode API tertentu, tidak ada data yang dikumpulkan untuk label tersebut, dan tidak ada deret waktu yang menyebutkannya. Artinya, jika project Anda tidak memiliki data sama sekali untuk metrik tertentu, Anda tidak akan pernah melihat jenis metrik tersebut.

Jenis metrik tidak menunjukkan jenis resource yang dipantau yang ditemukan dalam deret waktu metrik. Untuk Cloud Storage, hanya ada satu jenis resource yang dimonitor—gcs_bucket. Beberapa jenis metrik dipasangkan dengan lebih dari satu resource yang dimonitor.

Kardinalitas: deret waktu dan label

Setiap deret waktu dikaitkan dengan pasangan metrik dan jenis resource yang dipantau tertentu. Setiap jenis metrik dan resource yang dimonitor menyediakan sejumlah label. Di Cloud Monitoring, jumlah kombinasi nilai unik untuk kumpulan label adalah kardinalitas jenis metrik atau jenis resource yang dimonitor. Nilai ini disebut sebagai kardinalitas metrik dan kardinalitas resource, dan nilai ini menentukan jumlah kemungkinan deret waktu, total kardinalitas, yang dapat dihasilkan.

Misalkan Anda memiliki jenis metrik yang menentukan dua label, color dan zone. Kardinalitas metrik bergantung pada jumlah kemungkinan nilai yang dimiliki label tersebut:

  • Jika hanya ada tiga kemungkinan warna, “merah”, “hijau”, dan “biru”, maka label color dapat memiliki hingga tiga nilai berbeda.
  • Jika hanya ada dua kemungkinan zona, “timur” dan “barat”, maka label zone dapat memiliki hingga dua nilai berbeda.

Kardinalitas metrik ini adalah 6 (3×2). Jika ada 1.000 kemungkinan nilai untuk label color, dan jika setiap warna dapat muncul di setiap zona, maka kardinalitas metrik adalah 2.000 (1.000×2). Penghitungan yang sama berlaku jika ini adalah label pada jenis resource yang dipantau, bukan pada jenis metrik.

Nilai kardinalitas ini adalah nilai maksimum, berdasarkan jumlah kombinasi kemungkinan nilai label. Nilai efektif di dunia nyata mungkin jauh lebih rendah jika semua kombinasi nilai label tidak benar-benar terjadi. Misalnya, jika setiap warna hanya muncul di satu zona, bukan di kedua zona, maka jumlah deret waktu maksimum yang Anda lihat dalam sistem yang sedang berjalan adalah 1.000. Namun, kegunaan kardinalitas efektif bergantung pada alasan kombinasi tertentu tidak muncul dan apakah kombinasi tersebut mungkin muncul di masa mendatang.

Kardinalitas bergantung pada nilai yang dapat dimiliki label.

Saat data deret waktu ditulis, data tersebut diklasifikasikan menurut metrik dan jenis resource yang dipantau. Untuk setiap pasangan jenis metrik dan resource, kardinalitas total adalah hasil perkalian kardinalitas metrik dan kardinalitas resource. Jika Anda memiliki metrik dengan kardinalitas 1.000, dan resource dengan kardinalitas 100, dan jika setiap nilai label muncul, maka Anda memiliki 100.000 deret waktu (1.000×100).