Label metadata resource yang tidak digunakan lagi

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

Selain itu, Pemantauan dapat membuat label tambahan untuk mengambil metadata tentang resource yang dipantau. 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.

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

Efek penghentian

Semua kebijakan pemberitahuan, diagram, kartu skor, dan grup resource yang menentukan resource yang dipantau dan menggunakan label metadata yang label penggantinya dapat ditentukan akan otomatis dimigrasikan untuk menggunakan penggantian tersebut paling lambat 31 Juli 2020. Semua penggunaan 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 dipantau, tetapi menggunakan label metadata, Anda tidak dapat menentukan apakah label metadata tidak digunakan lagi: label metadata tidak unik di seluruh resource yang dipantau, dan label yang tidak digunakan lagi dikaitkan dengan resource yang dipantau tertentu. Anda harus mengevaluasi filter tersebut secara manual.
• Label metadata dalam filter di agregasi sekunder tidak dimigrasikan secara otomatis.
• Label metadata dalam kueri yang ditulis dalam Monitoring Query Language (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 paling lambat 31 Juli 2020 tidak lagi didukung dan mungkin berhenti berfungsi.

Tindakan yang diperlukan

Untuk memperbaiki kebijakan pemberitahuan, diagram, kartu skor, atau grup resource yang telah berhenti berfungsi karena label metadata yang tidak digunakan lagi, Anda harus melakukan beberapa tindakan. Anda dapat menghapus kebijakan pemberitahuan, diagram, skor kartu, atau grup, atau Anda dapat mengubah filter apa pun 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 dan 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 yang tidak digunakan lagi	Label yang 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 none
dataflow_job	metadata.system_labels.name metadata.system_labels.state	resource.labels.job_name none
gae_app	metadata.system_labels.gaeapp metadata.system_labels.gaemodule metadata.system_labels.gaeversion	none^† consider resource.labels.project_id none^† consider resource.labels.module_id none^† consider 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 sefleksibel label metadata.system_labels.cloud_account. 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 dicatat mirip dengan label metadata yang tidak digunakan lagi, sehingga mungkin merupakan pengganti yang baik. Namun, karena hanya mirip, keduanya tidak dimigrasikan secara otomatis.

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

^# Untuk resource pubsub_topic dan pubsub_subscription: Kami telah memperbaiki bug lama yang menyebabkan metadata.system_labels.name otomatis dikonversi ke huruf kecil (misalnya, "My-Subscription" menjadi "my-subscription"). Hal ini menghasilkan perilaku yang tidak terduga dalam kasus saat pengguna memiliki beberapa resource yang namanya dalam huruf kecil identik. Perilaku ini juga berakhir pada 31 Juli 2020. Setelah tanggal ini, label sistem metadata name akan mencerminkan nama sebenarnya dari topik atau langganan (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 pendeteksi yang disediakan.

2. Jika Anda menggunakan label metadata yang terpengaruh, perbarui atau hapus label tersebut. Lihat Memperbarui filter untuk mengetahui langkah-langkah yang lebih mendetail.

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 di 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. Tempelkan 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. Di command prompt 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 cuplikan 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 saat skrip melaporkan awalan metadata.system_labels. Misalnya, label yang ditampilkan sebagai metadata.system_labels.name dalam output disebut sebagai resource.metadata.name dalam filter.

Memperbarui filter

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

1. Login ke konsol Google Cloud.

2. Jalankan skrip detektor seperti yang dijelaskan dalam 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.

   Perlu diingat bahwa filter menggunakan awalan resource.metadata, bukan metadata.system_labels.

   Catatan: Jika membuat dasbor yang berisi kartu skor 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 pengganti.

   Jika Anda tidak melakukan apa pun, kebijakan pemberitahuan, diagram, atau grup resource yang terpengaruh tidak akan berfungsi.

   Untuk bantuan tambahan tentang cara melakukan pembaruan menggunakan konsol Google Cloud, lihat referensi yang tercantum di Mengedit.

   Dalam beberapa kasus, Anda mungkin perlu menggunakan Cloud Monitoring API, bukan konsol Google Cloud. API dapat menyatakan beberapa kueri yang tidak dapat dibuat.

4. Jalankan skrip detektor lagi, untuk memverifikasi bahwa tidak ada label yang tidak digunakan lagi.

Informasi tambahan

Untuk informasi tentang label metadata resource, filter, atau jenis resource yang dipantau tertentu, lihat hal berikut:

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

Pengeditan

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

• Kebijakan pemberitahuan: Mengelola kebijakan
• Dasbor dan diagram menggunakan konsol Google Cloud: Mengelola dasbor
• Dasbor menggunakan Monitoring API: Memperbarui dasbor
• Grup resource: Mengedit grup