Konvensi penamaan metrik

Dokumen ini menjelaskan konvensi penamaan yang diterapkan Cloud Monitoring untuk metrik.

Nama resource metrik

Nama resource untuk jenis metrik terdiri dari string dengan tiga sub-struktur utama:

• ID untuk project tertentu.
• Penanda, yang selalu ditetapkan ke metricDescriptors, untuk menunjukkan bahwa string mewakili deskriptor metrik.
• Jenis metrik.

Nama resource untuk jenis metrik mengikuti pola ini:

projects/PROJECT_ID/metricDescriptors/METRIC_TYPE

Sub-string METRIC_TYPE adalah ID yang mewakili jenis metrik. File ini tersedia dalam berbagai format, misalnya:

agent.googleapis.com/agent/api_request_count
compute.googleapis.com/firewall/dropped_bytes_count
istio.io/service/client/received_bytes_count
kubernetes.io/anthos/APIServiceOpenAPIAggregationControllerQueue1_adds

Dalam deskriptor metrik, kolom name menyimpan nama resource jenis metrik, dan kolom type menyimpan sub-string METRIC_TYPE.

Tabel berikut menunjukkan cara mengurai sub-string METRIC_TYPE yang ada dalam nama resource:

Kemungkinan struktur	Deskripsi
SERVICE_NAME^1.googleapis.com/PATH^2	Metrik dari Google Cloud produk dan layanan. Untuk mengetahui daftar lengkap metrik ini, lihat metrikGoogle Cloud .
agent.googleapis.com/SERVICE_NAME^1/PATH^2	Metrik dari agen Monitoring dan Logging yang berjalan di instance VM di Google Cloud atau AWS. Untuk daftar lengkap metrik ini, lihat Metrik agen.
kubernetes.io/anthos/PATH^2	Metrik dari GKE Enterprise, layanan Google Cloud yang memungkinkan Anda menjalankan cluster Kubernetes di wilayah lokal dan di cloud. Untuk mengetahui daftar lengkap metrik ini, lihat Metrik Anthos.
aws.googleapis.com/SERVICE_NAME^1/PATH^2	Metrik dari Amazon Web Services. Untuk mengetahui daftar lengkap metrik ini, lihat metrik AWS.
istio.io/PATH^2	Metrik dari Istio untuk Google Cloud. Untuk mengetahui daftar lengkap metrik ini, lihat Metrik Istio.
kubernetes.io/PATH^2	Metrik dari Google Kubernetes Engine. Untuk mengetahui daftar lengkap metrik ini, lihat Metrik Kubernetes.
knative.dev/PATH^2	Metrik dari Knative. Untuk mengetahui daftar lengkap metrik ini, lihat Metrik Knative.
external.googleapis.com/EXT_SERVICE/PATH^2 external.googleapis.com/prometheus/PATH^2	Metrik kustom pihak ketiga seperti Prometheus. Alat pemantauan open source ini sering digunakan dengan Kubernetes. Untuk mengetahui informasi selengkapnya tentang metrik ini, lihat Metrik eksternal. Anda hanya dapat menggunakan jenis metrik ini dalam project yang menentukannya.
custom.googleapis.com/PATH^2 external.googleapis.com/user/PATH^2	Metrik yang ditentukan pengguna. Anda hanya dapat menggunakan jenis metrik ini dalam project tempat Anda menentukannya.
logging.googleapis.com/PATH^2	Metrik berbasis log dari Cloud Logging. Anda dapat menggunakan metrik standar atau membuat metrik kustom. Metrik kustom hanya dapat digunakan dalam project tempat Anda menentukannya.

¹ SERVICE_NAME mengidentifikasi produk, seperti compute untuk Compute Engine. Google Cloud
² PATH mengidentifikasi metrik dalam produk, seperti instance/cpu/utilization.

Aturan untuk jenis dan label metrik

Daftar ini berisi aturan yang harus diikuti saat Anda membuat jenis metrik kustom. Label yang terkait dengan jenis metrik ditentukan sebagai pasangan nilai kunci dari jenis LabelDescriptor. Kunci berfungsi sebagai nama label.

• Jenis metrik

  • Gunakan huruf besar dan kecil (A-Z, a-z), angka (0-9), titik (.), garis bawah (_), titik dua (:), dan tanda hubung (-) dalam string.
  • Gunakan garis miring (/) untuk memisahkan elemen jalur.
  • Anda harus memulai setiap elemen jalur dengan huruf atau digit.
  • Panjang maksimum string jenis metrik adalah 200 karakter.

• Kunci label

  • Gunakan huruf kecil (a-z), digit (0-9), garis bawah (_), dan titik (.) dalam kunci label.
  • Anda harus memulai kunci label dengan huruf.
  • Panjang maksimum kunci label adalah 100 karakter.
  • Setiap kunci harus unik dalam jenis metrik.
  • Anda dapat memiliki maksimal 30 label per jenis metrik.