Label metadata resource yang sudah tidak digunakan lagi

Resource yang dimonitor dalam Cloud Monitoring dilengkapi dengan serangkaian label yang digunakan untuk mengidentifikasi instance tertentu dari jenis resource yang dipantau. Label ini didokumentasikan untuk setiap jenis resource yang dimonitor dalam Daftar resource yang dimonitor.

Selain itu, Monitoring dapat membuat label tambahan untuk menangkap metadata tentang resource yang dimonitor. Label metadata sistem ini tersedia bagi pengguna sebagai nilai hanya baca. Pengguna juga dapat membuat label metadata resource mereka sendiri. Untuk mengetahui informasi selengkapnya, lihat Label metadata resource.

Grup label metadata resource yang dipantau sudah tidak digunakan lagi. Label dalam kumpulan bersifat redundan dan dapat diganti dengan label yang setara yang sudah ada, atau mewakili konsep yang sudah tidak berlaku dan tidak lagi didukung oleh kebijakan pemberitahuan, diagram, kartu skor, atau grup resource Cloud Monitoring.

Pengaruh penghentian penggunaan

Semua kebijakan pemberitahuan, diagram, kartu skor, dan grup resource yang menentukan resource yang dipantau serta menggunakan label metadata yang dapat menentukan label penggantinya telah dimigrasikan secara otomatis untuk menggunakan penggantian paling lambat 31 Juli 2020. Semua penggunaan lain dari label yang tidak digunakan lagi harus dimigrasikan secara manual. Halaman ini memberikan informasi tentang cara memigrasikannya.

Semua kebijakan pemberitahuan, diagram, kartu skor, dan grup resource yang menggunakan label metadata yang tidak dimigrasikan secara otomatis atau manual sebelum 31 Juli 2020 tidak lagi didukung dan mungkin akan berhenti berfungsi.

Tindakan yang diperlukan

Untuk memperbaiki kebijakan pemberitahuan, diagram, kartu skor, atau grup resource yang berhenti berfungsi karena label metadata yang tidak digunakan lagi, Anda harus melakukan beberapa tindakan. Anda dapat menghapus kebijakan, diagram, kartu skor, atau grup pemberitahuan, atau Anda dapat mengubah filter yang menggunakan label yang tidak digunakan lagi tersebut untuk menggunakan label yang memberikan perilaku serupa.

Demikian pula, jika Anda memiliki filter yang menggunakan label metadata tetapi tidak menentukan resource yang dipantau, Anda tidak dapat menentukan secara otomatis apakah label ini tidak digunakan lagi. Anda harus mengevaluasi dan mengatasinya secara manual.

Halaman ini menyertakan skrip untuk membantu Anda mengidentifikasi penggunaan label metadata yang tidak digunakan lagi.

Label metadata yang tidak digunakan lagi

Tabel berikut mencantumkan label metadata resource yang tidak digunakan lagi beserta penggantinya, jika ada.

Jenis resource yang dimonitor	Label tidak digunakan lagi	Label setara
Semua jenis Google Cloud	`metadata.system_labels.cloud_account`^*	`resource.labels.project_id`
`cloud_tasks_queue`	`metadata.system_labels.name` `metadata.system_labels.state`	`resource.labels.queue_id` tidak ada
`dataflow_job`	`metadata.system_labels.name` `metadata.system_labels.state`	`resource.labels.job_name` tidak ada
`gae_app`	`metadata.system_labels.gaeapp` `metadata.system_labels.gaemodule` `metadata.system_labels.gaeversion`	none^† pertimbangkan `resource.labels.project_id` none^† pertimbangkan `resource.labels.module_id` none^† pertimbangkan `resource.labels.version_id`
`gce_disk`	`metadata.user_labels.name`^‡	`metadata.system_labels.name`
`gce_instance`	`metadata.user_labels.name`^‡	`metadata.system_labels.name`
`l7_lb_rule`	`metadata.system_labels.state`	tidak ada
`pubsub_topic`	`metadata.system_labels.name`^#	`metadata.system_labels.name`
`pubsub_subscription`	`metadata.system_labels.name`^#	`metadata.system_labels.name`
`vpn_gateway`	`metadata.system_labels.region`	`resource.labels.region`

^* Sintaksis filter Cloud Monitoring tidak mengizinkan label resources.labels.project_id digunakan secara fleksibel karena label metadata.system_labels.cloud_account dapat digunakan. Misalnya, Anda tidak dapat melakukan hal berikut:

Gunakan OR untuk menggabungkan ekspresi menggunakan label project_id dan ekspresi menggunakan label metadata.

Gunakan operasi != dengan label project_id.

Gunakan fungsi starts_with atau has_substring dengan label project_id.

^† Untuk resource gae_app: Label resource yang tercatat mirip dengan label metadata yang tidak digunakan lagi, sehingga bisa menjadi pengganti yang baik. Namun, karena hanya serupa, keduanya tidak dimigrasikan secara otomatis.

^‡ Untuk resource gce_disk dan gce_instance: Jika Anda tidak menetapkan metadata.user_labels.name, resource tersebut telah diisi otomatis dengan nilai dari metadata.system_labels.name. Pengisian otomatis ini juga berakhir pada 31 Juli 2020. Kebijakan pemberitahuan, diagram, kartu skor, dan grup resource yang memfilter nilai metadata.user_labels.name yang terisi otomatis dimigrasikan untuk menggunakan metadata.system_labels.name.

^# Untuk resource pubsub_topic dan pubsub_subscription: Kami telah memperbaiki bug yang sudah lama ada yang menyebabkan metadata.system_labels.name otomatis dikonversi menjadi huruf kecil (misalnya, "My-Subscription" menjadi "my-subscription"). Hal ini menghasilkan perilaku yang tidak terduga jika pengguna memiliki beberapa resource yang nama huruf kecilnya identik. Perilaku ini juga berakhir pada 31 Juli 2020. Setelah tanggal ini, label sistem metadata name akan mencerminkan nama sebenarnya dari topik atau langganan tersebut (misalnya, "My-Subscription").

Apa yang harus saya lakukan?

Ada dua langkah tingkat tinggi:

Tentukan apakah Anda menggunakan label metadata yang terpengaruh oleh penghentian ini. Lihat Menemukan label metadata yang tidak digunakan lagi untuk mengetahui informasi tentang cara menjalankan skrip detektor yang disediakan.
Jika Anda menggunakan label metadata yang terpengaruh, perbarui atau hapus label tersebut. Lihat Memperbarui filter untuk langkah yang lebih detail.

Menemukan label metadata yang tidak digunakan lagi

Anda dapat menggunakan skrip Python ini untuk mengidentifikasi referensi ke label metadata yang tidak digunakan lagi: metadata_label_detection.py.

Ringkasan sintaksis: python3 metadata_label_detection.py PROJECT_ID_OR_NUMBER

PROJECT_ID_OR_NUMBER dapat berupa project ID (misalnya my-project), atau nomor project (misalnya 123456789). Jangan sertakan awalan projects/.

Langkah-langkah berikut menjelaskan cara menggunakan skrip:

Buka Konsol Google Cloud.

Buka konsol Google Cloud
Klik Activate Cloud Shell di bagian atas halaman Konsol Google Cloud untuk project Anda.
Klik Open Editor di toolbar Cloud Shell. Jika ruang kerja untuk direktori utama Anda belum terbuka, buka dengan memilih File, lalu Open Workspace. Pilih ruang kerja dengan nama pengguna Anda.
Buat file baru bernama metadata_label_detection.py dengan memilih File, lalu New File. Tempel teks metadata_label_detection.py ke dalam editor. Simpan file dengan memilih File, lalu Save.
Kembali ke terminal dengan mengklik Open Terminal di toolbar Cloud Shell.
Pada prompt command line di Cloud Shell, instal dependensi skrip dengan menjalankan perintah berikut:
```
sudo pip3 install google-cloud-monitoring=="1.*" google-cloud-monitoring-dashboards
```

Setelah menginstal dependensi, jalankan skrip detektor:

python3 metadata_label_detection.py $GOOGLE_CLOUD_PROJECT

Skrip ini menghasilkan laporan seperti kutipan berikut:

Alert "Test alert" (projects/PROJECT_ID/alertPolicies/8401129027900817186) is affected.
URL: https://console.cloud.google.com/monitoring/alerting/policies/8401129027900817186?project=PROJECT_ID
        metadata.system_labels.cloud_account is deprecated for non-AWS resource
types. Please manually remove the reference.

Group "Test group" (projects/PROJECT_ID/groups/4518177785663978371) might be affected,
depending on the type of resources it is used for.
URL: https://console.cloud.google.com/monitoring/groups/4518177785663978371?project=PROJECT_ID
        metadata.system_labels.name is deprecated for dataflow_job. Please
manually remove the reference if this group is used for dataflow_job resources.
        metadata.system_labels.name is deprecated for cloud_tasks_queue. Please
manually remove the reference if this group is used for cloud_tasks_queue resources.

Xy_chart "Test chart" in dashboard "Demo dashboard" (projects/PROJECT_ID/dashboards/2826428163455705326) is affected.
URL: https://console.cloud.google.com/monitoring/dashboards/custom/2826428163455705326?project=PROJECT_ID
        metadata.user_labels.name is deprecated for gce_instance. Please
manually remove the reference.

Perbarui filter Anda

Untuk memperbarui kebijakan pemberitahuan, diagram, kartu skor, dan grup resource:

Login ke konsol Google Cloud.
Jalankan skrip detektor seperti yang dijelaskan dalam artikel Menemukan label yang tidak digunakan lagi.
Periksa setiap kebijakan pemberitahuan, diagram, dan grup resource Anda untuk memeriksa apakah nilai yang Anda ambil berasal dari salah satu label yang tidak digunakan lagi yang diidentifikasi oleh skrip.

Untuk memeriksa semua diagram, Anda harus memeriksa setiap diagram di setiap dasbor kustom yang telah Anda tentukan.

Ingat bahwa filter menggunakan awalan resource.metadata, bukan metadata.system_labels.

Catatan: Jika membuat dasbor yang berisi kartu skor dengan menggunakan API, Anda harus menggunakan API untuk memeriksanya. Kartu skor tidak dapat diedit dari Konsol Google Cloud.

Untuk setiap label yang tidak digunakan lagi, lakukan salah satu hal berikut:
- Jika label tidak memiliki pengganti, hapus penggunaan label atau hapus kebijakan pemberitahuan, diagram, atau grup resource.
- Jika label memiliki pengganti, ganti label yang tidak digunakan lagi dengan penggantiannya.
Jika Anda tidak melakukan tindakan apa pun, kebijakan pemberitahuan, diagram, atau grup resource yang terpengaruh tidak akan berfungsi.

Untuk bantuan tambahan terkait cara melakukan pembaruan dengan menggunakan Konsol Google Cloud, lihat referensi yang tercantum dalam Pengeditan.

Dalam beberapa kasus, Anda mungkin perlu menggunakan Cloud Monitoring API, bukan Google Cloud Console. API dapat mengekspresikan beberapa kueri yang tidak dapat dibuat.
Jalankan skrip detektor lagi untuk memastikan tidak ada label yang tidak digunakan lagi.

Informasi tambahan

Untuk mengetahui informasi tentang label metadata resource, filter, atau jenis resource tertentu yang dimonitor, lihat artikel berikut:

Label: Label metadata resource
Filter: Filter pemantauan
Jenis resource tertentu yang dipantau: Daftar resource yang dimonitor

Pengeditan

Untuk informasi tentang cara memperbarui kebijakan pemberitahuan, diagram, dasbor, dan grup resource, lihat artikel berikut:

Kebijakan pemberitahuan: Mengelola kebijakan
Dasbor dan diagram dengan menggunakan Konsol Google Cloud: Mengelola dasbor
Dasbor dengan menggunakan Monitoring API: Memperbarui dasbor
Grup referensi: Mengedit grup