Etichette dei metadati delle risorse obsolete

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

Inoltre, Monitoring potrebbe creare ulteriori etichette 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 etichette metadati proprie. Per ulteriori informazioni, consulta la sezione 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

Entro il 31 luglio 2020, tutti i criteri di avviso, i grafici, i prospetti e i gruppi di risorse che specificano una risorsa monitorata e che utilizzano le etichette dei metadati per le quali è possibile determinare la sostituzione delle etichette sono stati sottoposti automaticamente a migrazione. 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 un filtro che non specifica una risorsa monitorata ma utilizza etichette di metadati, non è stato possibile determinare se l'etichetta dei metadati è obsoleta: le etichette dei metadati non sono univoche per le risorse monitorate e le etichette deprecate sono associate a risorse monitorate specifiche. I filtri devono essere valutati manualmente.
• La migrazione automatica delle etichette dei metadati nei filtri di un'aggregazione secondaria non veniva eseguita.
• La migrazione delle etichette dei metadati nelle query scritte in Monitoring Query Language (MQL) non è stata eseguita automaticamente.

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

Azione richiesta

Per correggere i criteri di avviso, i grafici, i prospetti o i gruppi di risorse che non hanno più funzionato a causa di etichette dei metadati deprecate, devi intraprendere alcune azioni. Puoi rimuovere i criteri di avviso, i grafici, i prospetti o i gruppi oppure puoi modificare qualsiasi filtro che utilizza quelle ritirate per utilizzare le etichette che forniscono un comportamento simile.

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

Questa pagina include uno script per aiutarti a identificare l'utilizzo delle etichette dei metadati obsolete.

Etichette metadati obsolete

La tabella seguente elenca le etichette dei metadati della risorsa obsolete e le eventuali sostituzioni.

Nota: nei filtri, il prefisso dell'etichetta resource.metadata viene utilizzato dove la tabella mostra il prefisso metadata.system_labels. Ad esempio, l'etichetta visualizzata come metadata.system_labels.name nella tabella è denominata 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 nessuno
dataflow_job	metadata.system_labels.name metadata.system_labels.state	resource.labels.job_name nessuno
gae_app	metadata.system_labels.gaeapp metadata.system_labels.gaemodule metadata.system_labels.gaeversion	nessuno^† considera resource.labels.project_id nessuno^† considera resource.labels.module_id nessuno^† 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'utilizzo flessibile dell'etichetta resources.labels.project_id come l'etichetta metadata.system_labels.cloud_account. Ad esempio, non puoi:

• Utilizza OR per combinare un'espressione usando l'etichetta project_id e un'espressione usando le etichette 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 deprecate, pertanto potrebbero essere ottime sostituzioni. Ma poiché sono solo simili, la migrazione non è stata eseguita automaticamente.

^‡ Per le risorse gce_disk e gce_instance: se non imposti altrimenti metadata.user_labels.name, il valore è stato inserito automaticamente con il valore metadata.system_labels.name. L'inserimento automatico è terminato anche il 31 luglio 2020. Per l'utilizzo di metadata.system_labels.name è stata eseguita la migrazione dei criteri di avviso, dei grafici, dei prospetti e dei gruppi di risorse che filtrano in base al valore metadata.user_labels.name completato automaticamente.

^# Per le risorse pubsub_topic e pubsub_subscription: abbiamo corretto un bug di lunga data che causava 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 avevano più risorse con nomi minuscoli 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 dell'abbonamento (ad esempio, "My-Subscription").

Cosa devo fare?

Esistono due passaggi di alto livello:

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

2. Se utilizzi etichette dei metadati interessate, aggiornale o rimuovile. Per istruzioni più dettagliate, consulta la sezione Aggiornare i filtri.

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 nelle aggregazioni secondarie.

Riepilogo 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 descrivono un modo per utilizzare lo script:

1. Vai a Google Cloud Console.

   Vai a Cloud Console

2. Fai clic su Attiva Cloud Shell nella parte superiore della pagina Google Cloud Console relativa al 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 poi 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 dello script eseguendo questo comando:

   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 rapporto 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 dove lo script segnala il prefisso metadata.system_labels. Ad esempio, l'etichetta mostrata come metadata.system_labels.name nell'output viene 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 a Google Cloud Console.

2. Esegui lo script di rilevamento come descritto in Trovare etichette deprecate.

3. Esamina ogni criterio di avviso, grafici e gruppi di risorse per verificare se il valore recuperato proviene da una delle etichette deprecate identificate dallo script.

   Per controllare tutti i grafici, devi verificare ogni grafico in ciascuna 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 mediante l'API, devi utilizzarle per controllarle. I prospetti non possono essere modificati da Cloud Console.

   Per ogni etichetta deprecata, procedi in uno dei seguenti modi:

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

   • Se l'etichetta è sostitutiva, sostituiscila con la sostituzione.

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

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

   In alcuni casi, potresti dover utilizzare l'API Cloud Monitoring anziché Cloud Console. L'API è in grado di esprimere alcune query che non possono essere costruite.

4. Esegui di nuovo lo script di rilevamento, per verificare che non ci siano etichette obsolete.

Informazioni aggiuntive

Per informazioni su etichette, filtri o tipi specifici di risorse monitorate, consulta quanto segue:

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

In fase di modifica:

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

• Criteri di avviso: gestione dei criteri
• Dashboard e grafici mediante Google Cloud Console: Gestione delle dashboard
• Dashboard tramite l'API Monitoring: aggiornamento delle dashboard
• Gruppi di risorse: Modifica di un gruppo