Etichette dei metadati delle risorse obsolete

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

Inoltre, il monitoraggio potrebbe creare etichette aggiuntive per acquisire i metadati di 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 ritirato. Le etichette nel set sono ridondanti e possono essere sostituite da etichette equivalenti esistenti oppure rappresentano concetti obsoleti non più supportati dai criteri di avviso, dai grafici, dai prospetti o dai gruppi di risorse di Cloud Monitoring.

Effetti del ritiro

Per tutti i criteri di avviso, i grafici, i prospetti e i gruppi di risorse che specificano una risorsa monitorata e utilizzano etichette dei metadati per le quali è stato possibile determinare le etichette sostitutive, è stata eseguita automaticamente la migrazione per utilizzare le sostituzioni entro il 31 luglio 2020. Per tutti gli altri utilizzi delle etichette ritirate è necessaria la migrazione manuale. Questa pagina fornisce informazioni su come eseguirne la migrazione.

Note:

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

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

Azione richiesta

Per riparare criteri di avviso, grafici, prospetti o gruppi di risorse che non funzionano più a causa di etichette dei metadati ritirate, devi intervenire. Puoi rimuovere i criteri di avviso, i grafici, gli indicatori o i gruppi oppure modificare i filtri che utilizzano queste etichette ritirate in modo da utilizzare etichette che forniscono un comportamento simile.

Analogamente, se hai filtri che utilizzano etichette dei metadati, ma non specifichi le risorse monitorate, non è possibile determinare automaticamente se queste etichette sono ritirate. Devi valutarle e risolverle manualmente.

Questa pagina include uno script che ti aiuta a identificare gli utilizzi delle etichette dei metadati ritirate.

Etichette dei metadati ritirate

La tabella seguente elenca le etichette dei metadati delle risorse che verranno ritirate e le eventuali sostituzioni.

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

Tipo di risorsa monitorata	Etichetta obsoleta	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^† valuta resource.labels.project_id nessuno^† valuta resource.labels.module_id nessuno^† valuta 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	nessuno
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 di utilizzare l'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 che utilizza 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 ritirate, pertanto potrebbero essere una buona alternativa. Tuttavia, poiché sono solo simili, non è stata eseguita la migrazione automatica.

^‡ Per le risorse gce_disk e gce_instance: se non imposti metadata.user_labels.name, il valore viene compilato automaticamente con il valore di metadata.system_labels.name. Anche questo completamento automatico è terminato 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 in modo da utilizzare metadata.system_labels.name.

^# Per le risorse pubsub_topic e pubsub_subscription: abbiamo corretto un bug di vecchia data che causava la conversione automatica di metadata.system_labels.name in lettere minuscole (ad es. "My-Subscription" diventava "my-subscription"). Ciò ha prodotto un comportamento imprevisto nei casi in cui gli utenti avevano più risorse i cui nomi in minuscolo sono identici. Anche questo comportamento è terminato il 31 luglio 2020. Dopo questa data, l'etichetta di sistema dei metadati name riflette il nome effettivo dell'argomento o dell'abbonamento (ad esempio "My-Subscription").

Che cosa devo fare?

Esistono due passaggi di alto livello:

1. Determina se utilizzi etichette dei metadati interessate da questo ritiro. Per informazioni sull'esecuzione dello script del rilevatore fornito, consulta Trovare le etichette dei metadati ritirate.

2. Se utilizzi le etichette dei metadati interessate, aggiornale o rimuovile. Per i passaggi dettagliati, consulta Aggiornare i filtri.

Trovare le etichette dei metadati ritirate

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

Nota: lo script non è in grado di rilevare le etichette dei metadati nei filtri nelle aggregazioni secondarie.

Riepilogo della sintassi: python3 metadata_label_detection.py PROJECT_ID_OR_NUMBER

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

I passaggi riportati di seguito descrivono un modo per utilizzare lo script:

1. Vai alla console Google Cloud.

   Vai alla console Google Cloud

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 lo spazio di lavoro per la tua home directory non è già aperto, apri selezionando File, quindi Apri spazio di lavoro. Scegli lo spazio 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 del 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. Al prompt della riga di comando in Cloud Shell, installa le dipendenze dello script eseguendo il seguente 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 report come l'estratto riportato di seguito:

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 riporta il prefisso metadata.system_labels. Ad esempio, l'etichetta visualizzata 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 alla console Google Cloud.

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

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

   Per controllare tutti i grafici, devi controllare ogni grafico 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 controllarli. Le schede di valutazione non possono essere modificate dalla console Google Cloud.

   Per ogni etichetta ritirata, esegui una delle seguenti operazioni:

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

   • Se l'etichetta ha un'etichetta sostitutiva, sostituisci l'etichetta ritirata con quella sostitutiva.

   Se non esegui alcuna operazione, la criterio di avviso, il grafico o il gruppo di risorse interessato non funzionerà.

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

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

4. Esegui di nuovo lo script del rilevatore per verificare che non ci siano etichette ritirate.

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 monitoraggio
• Tipi specifici di risorse monitorate: Elenco delle risorse monitorate

Modifica

Per informazioni su come aggiornare i criteri di avviso, i grafici, le dashboard e i gruppi di risorse, consulta quanto segue:

• Criteri di avviso: Gestire i criteri
• Dashboard e grafici utilizzando la console Google Cloud: Gestire le dashboard
• Dashboard mediante l'API Monitoring: Aggiornamento delle dashboard
• Gruppi di risorse: modificare un gruppo