Etichette dei metadati delle risorse obsolete

Le risorse monitorate in Cloud Monitoring includono 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 di 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 le proprie etichette dei metadati delle risorse. Per ulteriori informazioni, consulta Etichette dei metadati delle risorse.

Un gruppo di etichette dei metadati delle risorse monitorate è stato deprecato. Le etichette nel set sono ridondanti e possono essere sostituite da etichette equivalenti esistenti oppure rappresentano concetti obsoleti non 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 etichette di metadati per le quali è possibile determinare etichette sostitutive sono state migrate automaticamente per utilizzare le sostituzioni entro il 31 luglio 2020. Tutti gli altri utilizzi delle etichette deprecate devono essere migrati manualmente. Questa pagina fornisce informazioni su come eseguirne la migrazione.

Eventuali criteri di avviso, grafici, prospetti e 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 smettere di funzionare.

Azione richiesta

Per riparare i criteri di avviso, i grafici, i prospetti o i gruppi di risorse che hanno smesso di funzionare a causa di etichette di metadati deprecate, devi intraprendere qualche azione. Puoi rimuovere criteri di avviso, grafici, prospetti o gruppi oppure modificare qualsiasi filtro che utilizza le etichette deprecate in modo da utilizzare etichette che forniscono un comportamento simile.

Allo stesso modo, se disponi di filtri che utilizzano etichette di metadati ma non specificano risorse monitorate, non è possibile determinare automaticamente se queste etichette sono deprecate. Devi valutarli e risolverli manualmente.

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

Etichette metadati deprecate

La tabella seguente elenca le etichette dei metadati delle risorse deprecate e le relative sostituzioni, se presenti.

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`^#	`metadata.system_labels.name`
`pubsub_subscription`	`metadata.system_labels.name`^#	`metadata.system_labels.name`
`vpn_gateway`	`metadata.system_labels.region`	`resource.labels.region`

^* La sintassi del filtro di Cloud Monitoring non consente l'utilizzo dell'etichetta resources.labels.project_id con la stessa flessibilità dell'etichetta metadata.system_labels.cloud_account. Ad esempio, non puoi:

Utilizza OR per combinare un'espressione con l'etichetta project_id e un'espressione che utilizza 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 deprecate, pertanto potrebbero essere delle buone sostituzioni. Tuttavia, 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, è stato inserito automaticamente con il valore di metadata.system_labels.name. Questa compilazione automatica è terminata il 31 luglio 2020. È 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 compilato automaticamente per utilizzare invece metadata.system_labels.name.

^# 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 lettere minuscole (ad esempio, "My-Subscription" diventò "my-subscription"). Questo ha generato un comportamento imprevisto nei casi in cui gli utenti avessero più risorse con nomi minuscoli identici. Anche questa pratica è terminata 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?

Sono previsti due passaggi generali:

Determina se stai utilizzando etichette di metadati interessate da questo ritiro. Consulta Trovare le etichette dei metadati deprecate per informazioni sull'esecuzione dello script del rilevatore fornito.
Se stai utilizzando le etichette dei metadati interessate, aggiornale o rimuovile. Per ulteriori informazioni sulla procedura, consulta la pagina relativa all'aggiornamento dei 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.

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

Vai alla console Google Cloud.

Vai alla console Google Cloud
Fai clic su Attiva Cloud Shell nella parte superiore della pagina della console Google Cloud relativa al progetto.
Fai clic su Apri editor nella barra degli strumenti di Cloud Shell. Se l'area di lavoro della home directory non è già aperta, aprila selezionando File e poi Apri area di lavoro. Scegli lo spazio di lavoro con il tuo nome utente.
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.
Torna al terminale facendo clic su Apri terminale nella barra degli strumenti di Cloud Shell.
Al 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
```
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.

Aggiorna i filtri

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

Accedi alla console Google Cloud.
Esegui lo script del rilevatore come descritto in Trovare etichette deprecate.
Ispeziona ciascun criterio di avviso, grafico e gruppo di risorse per verificare se il valore che stai recuperando proviene da una delle etichette deprecate identificate dallo script.

Per controllare tutti i grafici, devi selezionarli in 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 controllarle. I prospetti non possono essere modificati dalla console Google Cloud.

Per ogni etichetta deprecata, esegui una delle seguenti operazioni:
- Se non è prevista alcuna etichetta sostitutiva, rimuovine l'utilizzo 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 esegui alcuna operazione, il criterio di avviso, il grafico o il gruppo di risorse interessati non funzioneranno.

Per ulteriore assistenza su come apportare aggiornamenti utilizzando la console Google Cloud, consulta le risorse elencate in Modifica.

In alcuni casi, potrebbe essere necessario utilizzare l'API Cloud Monitoring anziché la console Google Cloud. L'API può esprimere alcune query che non possono essere create in altro modo.
Esegui di nuovo lo script del rilevatore per verificare che non rimangano etichette deprecate.

Informazioni aggiuntive

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

Etichette: Etichette dei metadati delle risorse
Filtri: filtri di Monitoring
Tipi specifici di risorse monitorate: Elenco di risorse monitorate

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 la console Google Cloud: Gestione delle dashboard
Dashboard utilizzando l'API Monitoring: aggiornamento delle dashboard
Gruppi di risorse: modifica di un gruppo