Catatan tentang terminologi

Kata name, type, type, metric, dan resource muncul dalam berbagai kombinasi dan konteks yang terkait dengan Cloud Monitoring, dan penggunaannya tidak selalu konsisten. Sebagai contoh, berikut adalah beberapa pola umum:

• Dalam konteks yang berbeda, istilah metrik dapat digunakan untuk merujuk pada salah satu hal berikut:

  • Suatu "sesuatu" umum untuk diukur
  • Jenis metrik
  • Deret waktu
  • Kumpulan deret waktu yang terkait dengan jenis metrik
  • Struktur Metric yang disematkan dalam struktur TimeSeries

• String seperti storage.googleapis.com/api/request_count mungkin disebut sebagai salah satu string berikut:

  • Metrik
  • Nama metrik
  • Jenis metrik
  • Nama jenis metrik

• String seperti gcs_bucket mungkin disebut sebagai salah satu string berikut:

  • Nama resource¹
  • Resource yang dipantau
  • Jenis resource yang dipantau
  • Nama resource yang dipantau

¹ Materi referensi REST API juga sering menggunakan istilah nama resource, yang biasanya tidak ada hubungannya dengan resource yang dimonitor. Istilah ini dijelaskan secara lebih mendetail dalam Nama resource.

Bagian ini memberikan beberapa panduan tentang terminologi yang mungkin membingungkan.

Jenis dan nama

Deskripsi untuk jenis metrik dan resource yang dipantau memiliki nama dan jenis. Dalam penggunaan biasa istilah ini digunakan secara bergantian.

Misalnya, string storage.googleapis.com/api/request_count adalah jenis metrik, meskipun disebut juga sebagai nama atau nama jenis.

Jika melihat deskripsi untuk jenis metrik ini, Anda akan melihat dua key-value pair ini, name dan type:

{
  "name": "projects/[PROJECT_ID]/metricDescriptors/storage.googleapis.com/api/request_count",
  ...
  "type": "storage.googleapis.com/api/request_count",
}

type pada deskriptor metrik adalah string yang mengenkode informasi tentang layanan yang menghasilkan data (misalnya, storage.googleapis.com) dan apa yang sedang diukur (api/request_count).

Dalam deskripsi metrik, nilai name adalah versi jenis metrik yang sepenuhnya memenuhi syarat; nilai name adalah nilai type yang diawali dengan string ini:

projects/[PROJECT_ID]/metricDescriptors/

Pola serupa berlaku untuk resource yang dipantau. type adalah label untuk beberapa jenis resource, dan name terdiri dari nilai type yang diawali dengan string ini:

projects/[PROJECT_ID]/monitoredResourceDescriptors/

Contoh berikut sesuai dengan entri api dalam daftar resource yang dimonitor:

{
  "type": "api",
  ...
  "name": "projects/[PROJECT_ID]/monitoredResourceDescriptors/api"
}

Nilai name dalam project sepenuhnya dapat diprediksi dari nilai type, tetapi nilai tersebut tidak persis sama. Namun, istilah tersebut sering digunakan secara tidak akurat dalam diskusi santai.

Poin Penting: Dalam hampir semua kasus, penggunaan “jenis metrik”, “nama metrik”, atau “nama jenis metrik” mengacu pada jenis metrik seperti yang dijelaskan di sini. Kata "metrik" biasanya berarti deret waktu yang terkait dengan jenis metrik. Frasa “resource yang dimonitor” biasanya berarti jenis atau entity fisik tertentu yang dijelaskan oleh jenis.

Jenis metrik dan jenis nilai

Ada dua istilah lain yang dapat disalahartikan sebagai “jenis metrik”:

• Jenis nilai
• Jenis metrik

Istilah-istilah ini bukan merupakan istilah alternatif untuk “jenis metrik”.

"Jenis nilai" dan "jenis metrik" menggambarkan data yang dikumpulkan. Keduanya terkait dengan konsep pemrograman "datatype".

• Jenis nilai menjelaskan nilai individual.
• Jenis metrik menjelaskan bagaimana nilai-nilai tersebut saling berkaitan.

Lihat Jenis dan jenis metrik untuk mengetahui detailnya.

Nama resource

Pola pembuatan nilai name dengan memberi awalan pada string ke nilai type (atau lainnya) jauh melampaui jenis metrik dan resource yang di-montitor. ID ini muncul dengan hampir semua data yang membuat data yang dapat diidentifikasi secara unik. Misalnya, MetricDescriptor dan AlertPolicy mengikuti pola ini.

Nilai kolom name sering kali dijelaskan dalam dokumentasi referensi sebagai “nama resource”:

Berikut adalah beberapa contoh struktur yang memiliki nama resource dan cara turunannya:

• Deskripsi metrik: gabungkan nilai awalan dan kolom type:
  • Awalan: projects/[PROJECT_ID]/metricDescriptors
  • type (contoh): storage.googleapis.com/api/request_count
  • name: projects/[PROJECT_ID]/metricDescriptors/storage.googleapis.com/api/request_count
• Deskripsi resource yang dipantau: gabungkan nilai awalan dan kolom type:
  • Awalan: projects/[PROJECT_ID]/monitoredResourceDescriptors
  • type (contoh): api
  • name: projects/[PROJECT_ID]/monitoredResourceDescriptors/api
• Kebijakan pemberitahuan: gabungkan nilai awalan dan ID yang dihasilkan
  • Awalan: projects/[PROJECT_ID]/alertPolicies
  • ID kebijakan pemberitahuan: angka yang dihasilkan saat kebijakan dibuat
  • name: projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]

Istilah "nama resource" mengacu pada resource dalam hierarki API layanan, dan tidak terkait dengan konsep resource yang dipantau dengan cara apa pun. Untuk mengetahui informasi selengkapnya tentang nama resource dalam desain API, lihat Nama resource.

Poin Penting: Di Cloud Monitoring API, jika kolom name dideskripsikan sebagai “nama resource”, nilai untuk kolom tersebut adalah ID yang sepenuhnya memenuhi syarat yang dibuat dengan mengambil nilai type (atau kolom lainnya) dan mengawalinya dengan string yang mengidentifikasi jenis resource.