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.

Catatan:

• Jika Anda memiliki filter yang tidak menentukan resource yang dimonitor, tetapi menggunakan label metadata, Anda tidak dapat menentukan apakah label metadata sudah tidak digunakan lagi atau tidak: label metadata tidak bersifat unik di seluruh resource yang dipantau, dan label yang tidak digunakan lagi akan dikaitkan dengan resource tertentu yang dimonitor. Anda harus mengevaluasi filter tersebut secara manual.
• Label metadata dalam filter dalam agregasi sekunder tidak dimigrasikan secara otomatis.
• Label metadata dalam kueri yang ditulis dalam Bahasa Kueri Monitoring (MQL) tidak dimigrasikan secara otomatis.

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.

Catatan: Dalam filter, awalan label resource.metadata digunakan saat tabel menampilkan awalan metadata.system_labels. Misalnya, label yang ditampilkan sebagai metadata.system_labels.name dalam tabel disebut sebagai resource.metadata.name dalam filter.

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:

1. 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.

2. 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.

Catatan: Skrip tidak dapat mendeteksi label metadata dalam filter dalam agregasi sekunder.

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:

1. Buka Konsol Google Cloud.

   Buka konsol Google Cloud

2. Klik Activate Cloud Shell di bagian atas halaman Konsol Google Cloud untuk project Anda.

3. 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.

4. 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.

5. Kembali ke terminal dengan mengklik Open Terminal di toolbar Cloud Shell.

6. 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
   

7. 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.

Catatan: Dalam filter, awalan label resource.metadata digunakan tempat skrip melaporkan awalan metadata.system_labels. Misalnya, label yang ditampilkan sebagai metadata.system_labels.name dalam output disebut sebagai resource.metadata.name dalam filter.

Perbarui filter Anda

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

1. Login ke konsol Google Cloud.

2. Jalankan skrip detektor seperti yang dijelaskan dalam artikel Menemukan label yang tidak digunakan lagi.

3. 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.

4. 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