Etichette dei metadati delle risorse obsolete

Le risorse monitorate in Cloud Monitoring sono dotate di un set di etichette utilizzate per identificare una particolare istanza del tipo di risorsa monitorata. Queste etichette sono documentate per ogni tipo di risorsa monitorata nell'elenco delle risorse monitorate.

Inoltre, Monitoring potrebbe creare etichette aggiuntive per acquisire i metadati relativi a una risorsa monitorata. Queste etichette dei metadati di sistema sono disponibili per gli utenti come valori di sola lettura. Gli utenti possono anche creare etichette di metadati delle risorse personalizzate. Per ulteriori informazioni, consulta Etichette dei metadati delle risorse.

Un gruppo di etichette di metadati delle risorse monitorate è stato ritirato. Le etichette nel set sono ridondanti e possono essere sostituite da etichette equivalenti esistenti oppure rappresentano concetti obsoleti che non sono più supportati da criteri di avviso, grafici, prospetti o gruppi di risorse di Cloud Monitoring.

Effetti del ritiro

Tutti i criteri di avviso, i grafici, i prospetti e i gruppi di risorse che specificano una risorsa monitorata e utilizzano le etichette dei metadati per le quali è possibile determinare le etichette sostitutive sono stati migrati automaticamente per utilizzare le sostituzioni entro il 31 luglio 2020. Tutti gli altri utilizzi delle etichette deprecate devono essere sottoposti a migrazione manuale. Questa pagina fornisce informazioni su come eseguirne la migrazione.

Note:

• Se hai impostato un filtro che non specifica una risorsa monitorata, ma utilizza etichette di metadati, non è stato possibile determinare se l'etichetta dei metadati è deprecata: le etichette dei metadati non sono univoche per le risorse monitorate e le etichette deprecate sono associate a risorse monitorate specifiche. Devi valutare tali filtri manualmente.
• La migrazione automatica delle etichette dei metadati nei filtri di un'aggregazione secondaria non è stata eseguita.
• La migrazione automatica delle etichette dei metadati nelle query scritte in Monitoring Query Language (MQL) non è stata eseguita.

Tutti i criteri di avviso, i grafici, i prospetti e i gruppi di risorse che utilizzano etichette di metadati di cui non è stata eseguita la migrazione automatica o manuale entro il 31 luglio 2020 non sono più supportati e potrebbero non essere più disponibili.

Azione richiesta

Per riparare criteri di avviso, grafici, prospetti o gruppi di risorse che hanno smesso di funzionare a causa del ritiro delle etichette dei metadati, devi intervenire. Puoi rimuovere i criteri di avviso, i grafici, i prospetti o i gruppi oppure modificare qualsiasi filtro che utilizzi le etichette deprecate per utilizzare le etichette che offrono un comportamento simile.

Analogamente, se hai filtri che utilizzano etichette di metadati ma non specificano risorse monitorate, non è possibile determinare automaticamente se queste etichette sono deprecate. Devi valutarle e risolvere i problemi manualmente.

Questa pagina include uno script per aiutarti a identificare gli utilizzi delle etichette dei metadati deprecate.

Etichette metadati obsolete

La tabella riportata di seguito elenca le etichette dei metadati delle risorse che sono state ritirate e le relative sostituzioni, se presenti.

Nota: nei filtri, il prefisso dell'etichetta resource.metadata viene utilizzato dove la tabella mostra il prefisso metadata.system_labels. Ad esempio, l'etichetta mostrata come metadata.system_labels.name nella tabella è indicata come resource.metadata.name nei filtri.

Tipo di risorsa monitorata	Etichetta deprecata	Etichetta equivalente
Tutti i tipi di 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 nessuna
dataflow_job	metadata.system_labels.name metadata.system_labels.state	resource.labels.job_name nessuna
gae_app	metadata.system_labels.gaeapp metadata.system_labels.gaemodule metadata.system_labels.gaeversion	nessuna^† considera resource.labels.project_id nessuna^† considera resource.labels.module_id nessuna^† considera 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	none
pubsub_topic	metadata.system_labels.name^n.	metadata.system_labels.name
pubsub_subscription	metadata.system_labels.name^n.	metadata.system_labels.name
vpn_gateway	metadata.system_labels.region	resource.labels.region

^* La sintassi dei filtri di Cloud Monitoring non consente l'uso flessibile dell'etichetta resources.labels.project_id e dell'etichetta metadata.system_labels.cloud_account. Ad esempio, non puoi:

• Utilizza OR per combinare un'espressione utilizzando l'etichetta project_id e un'espressione usando le etichette dei metadati.
• Utilizza l'operazione != con l'etichetta project_id.
• Utilizza le funzioni starts_with o has_substring con l'etichetta project_id.

^† Per le risorse gae_app: le etichette delle risorse indicate sono simili alle etichette dei metadati ritirate, pertanto potrebbero essere sostituibili. Ma poiché sono simili, la migrazione non è stata eseguita automaticamente.

^‡ Per le risorse gce_disk e gce_instance: se non imposti altrimenti metadata.user_labels.name, la funzionalità è stata completata automaticamente con il valore di metadata.system_labels.name. La compilazione automatica è terminata anche il 31 luglio 2020. È stata eseguita la migrazione dei criteri di avviso, dei grafici, dei prospetti e dei gruppi di risorse che filtrano il valore metadata.user_labels.name completato automaticamente, per utilizzare invece metadata.system_labels.name.

^# Per le risorse pubsub_topic e pubsub_subscription: abbiamo corretto un bug di lunga data che ha causato la conversione automatica di metadata.system_labels.name in minuscolo (ad esempio, "My-Subscription" è diventato "my-subscription"). Questo ha prodotto un comportamento imprevisto nei casi in cui gli utenti hanno più risorse i cui nomi minuscoli sono identici. Questo comportamento è terminato anche il 31 luglio 2020. Dopo questa data, l'etichetta del sistema di metadati name riflette il nome effettivo dell'argomento o della sottoscrizione (ad esempio "My-Subscription").

Cosa devo fare?

Esistono due passaggi generali:

1. Determina se stai utilizzando le etichette dei metadati interessate da questo ritiro. Consulta Trovare le etichette dei metadati deprecate per informazioni sull'esecuzione dello script del rilevatore fornito.

2. Se utilizzi etichette di metadati interessate, aggiornale o rimuovile. Consulta Aggiornare i filtri per i passaggi più dettagliati.

Trovare le etichette dei metadati deprecate

Puoi utilizzare questo script Python per identificare i riferimenti alle etichette dei metadati deprecate: metadata_label_detection.py.

Nota: lo script non può rilevare le etichette dei metadati nei filtri delle aggregazioni secondarie.

Riepilogo della sintassi: python3 metadata_label_detection.py PROJECT_ID_OR_NUMBER

PROJECT_ID_OR_NUMBER può essere un ID progetto (ad esempio my-project) o un numero di progetto (ad esempio 123456789). Non includere il prefisso projects/.

I seguenti passaggi spiegano come utilizzare lo script:

1. Vai alla console Google Cloud.

   Vai a Google Cloud Console

2. Fai clic su Attiva Cloud Shell nella parte superiore della pagina della console Google Cloud per il tuo progetto.

3. Fai clic su Apri editor nella barra degli strumenti di Cloud Shell. Se l'area di lavoro per la home directory non è già aperta, aprila selezionando File e quindi Apri area di lavoro. Scegli l'area di lavoro con il tuo nome utente.

4. Crea un nuovo file denominato metadata_label_detection.py selezionando File e poi Nuovo file. Incolla il testo di metadata_label_detection.py nell'editor. Salva il file selezionando File e poi Salva.

5. Torna al terminale facendo clic su Apri terminale nella barra degli strumenti di Cloud Shell.

6. Nel prompt della riga di comando in Cloud Shell, installa le dipendenze script eseguendo il comando seguente:

   sudo pip3 install google-cloud-monitoring=="1.*" google-cloud-monitoring-dashboards
   

7. Dopo aver installato le dipendenze, esegui lo script del rilevatore:

   python3 metadata_label_detection.py $GOOGLE_CLOUD_PROJECT
   

Lo script genera un report simile al seguente estratto:

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.

Nota: nei filtri, il prefisso dell'etichetta resource.metadata viene utilizzato laddove lo script segnala il prefisso metadata.system_labels. Ad esempio, l'etichetta indicata come metadata.system_labels.name nell'output è indicata come resource.metadata.name nei filtri.

Aggiornare i filtri

Per aggiornare i criteri di avviso, i grafici, i prospetti e i gruppi di risorse:

1. Accedi alla console Google Cloud.

2. Esegui lo script del rilevatore come descritto in Trovare le etichette deprecate.

3. Esamina ogni criterio di avviso, grafico e gruppo di risorse per controllare se il valore che stai recuperando proviene da una delle etichette deprecate identificate dallo script.

   Per controllare tutti i grafici, devi controllare ogni grafico su ogni dashboard personalizzata che hai definito.

   Ricorda che i filtri utilizzano il prefisso resource.metadata anziché metadata.system_labels.

   Nota: se hai creato dashboard contenenti prospetti utilizzando l'API, devi utilizzare l'API per controllarli. I punteggi non possono essere modificati da Google Cloud Console.

   Per ogni etichetta deprecata, esegui una delle seguenti operazioni:

   • Se l'etichetta non ha alcuna sostituzione, rimuovi l'uso dell'etichetta o elimina il criterio di avviso, il grafico o il gruppo di risorse.

   • Se l'etichetta ha una sostituzione, sostituisci l'etichetta deprecata con quella sostitutiva.

   Se non intervieni, il criterio di avviso, il grafico o il gruppo di risorse interessato non funzioneranno.

   Per ulteriore assistenza sull'aggiornamento tramite Google Cloud Console, consulta le risorse elencate in Modifica.

   In alcuni casi, potresti dover utilizzare l'API Cloud Monitoring anziché Google Cloud Console. L'API può esprimere alcune query che non possono essere create in altro modo.

4. Esegui di nuovo lo script del rilevatore per verificare che non ne rimangano altre.

Informazioni aggiuntive

Per informazioni sulle etichette dei metadati delle risorse, sui filtri o su specifici tipi di risorse monitorate, consulta quanto segue:

• Etichette: Etichette dei metadati delle risorse
• Filtri: filtri di monitoraggio
• Tipi di risorse monitorate specifiche: elenco delle risorse monitorate.

Modifica

Per informazioni sull'aggiornamento dei criteri di avviso, dei grafici, delle dashboard e dei gruppi di risorse, consulta quanto segue:

• Criteri di avviso: Gestione dei criteri
• Dashboard e grafici utilizzando la console Google Cloud: Gestione delle dashboard
• Dashboard utilizzando l'API Monitoring: aggiornamento delle dashboard
• Gruppi di risorse: Modificare un gruppo