Etichette dei metadati delle risorse obsolete

Le risorse monitorate in Cloud Monitoring sono dotate di un insieme di etichette vengono utilizzati per identificare una particolare istanza del tipo di risorsa-monitorata. Queste etichette sono documentate per ogni tipo di risorsa monitorata in Elenco delle risorse monitorate:

Inoltre, Monitoring 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 maggiori informazioni, consulta Metadati delle risorse etichette.

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

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. Tutti gli altri utilizzi delle etichette deprecate devono essere effettuati manualmente è stata eseguita la migrazione. Questa pagina fornisce informazioni su come eseguirne la migrazione.

Note:

• Se disponi di un filtro che non specifica una risorsa monitorata, utilizza le etichette dei metadati, non è stato possibile determinare se l'etichetta è deprecata: le etichette dei metadati non sono univoche nelle risorse monitorate, e le etichette deprecate sono associate a specifiche risorse monitorate. Questi filtri devono essere valutati manualmente.
• La migrazione delle etichette dei metadati nei filtri di un'aggregazione secondaria non è stata eseguita automaticamente.
• Etichette dei metadati nelle query scritte in Monitoring Query Language (MQL) non sono stati migrati 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 delle etichette dei metadati ritirate, devi intervenire. Puoi rimuovere i criteri di avviso, i grafici prospetti o gruppi oppure puoi modificare i filtri che li utilizzano deprecate per usare etichette che forniscono un comportamento simile.

Analogamente, se hai filtri che utilizzano etichette di metadati ma non specificano risorse monitorate, non è possibile determinare automaticamente se le etichette sono deprecate. ma devi valutarli e intervenire 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 deprecate e le relative sostituzioni, se presenti.

Nota: nei filtri, il prefisso dell'etichetta resource.metadata viene utilizzato quando 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 resources.labels.project_id da usare in modo flessibile quanto È possibile usare l'etichetta metadata.system_labels.cloud_account. Ad esempio, non puoi:

• Utilizza OR per combinare un'espressione mediante la proprietà Etichetta project_id e un'espressione che utilizza i metadati etichette.
• Utilizza l'operazione != con project_id dell'etichetta.
• 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 gce_disk e gce_instance risorse: se non imposti metadata.user_labels.name in altro modo, è stato compilato automaticamente con il valore metadata.system_labels.name. Anche questa compilazione automatica è terminata il 31 luglio 2020. Criteri di avviso, grafici, prospetti e gruppi di risorse che filtrano in base a È stata eseguita la migrazione del valore di 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 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 del sistema di metadati name riflette il nome effettivo della per argomento o sottoscrizione (ad esempio, "My-Subscription").

Che cosa devo fare?

Esistono due passaggi di alto livello:

1. Determina se stai utilizzando etichette di metadati interessate da questo il ritiro. Consulta Trovare i metadati ritirati etichette per informazioni sull'esecuzione script di rilevamento fornito.

2. Se utilizzi etichette di metadati interessate, aggiornale o rimuovile. Per saperne di più, consulta Aggiornare i filtri i passaggi dettagliati.

Trovare le etichette dei metadati deprecate

Puoi utilizzare questo script Python per identificare i riferimenti a metadati deprecati etichette: metadata_label_detection.py.

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

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 seguenti 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 l'area di lavoro la home directory non è già aperta, aprila selezionando File e quindi Apri Workspace. 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 del metadata_label_detection.py nell'editor. Salva il file selezionando File, quindi 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 lo script delle dipendenze 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 report come il 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 riporta il prefisso metadata.system_labels. Ad esempio, l'etichetta mostrato come metadata.system_labels.name nell'output è indicato come resource.metadata.name nei filtri.

Aggiorna 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 Trova le etichette deprecate.

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. Impossibile modificare i prospetti da la 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 è presente un'etichetta sostitutiva, sostituisci quella deprecata con il sostituzione.

   Se non fai nulla, il 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 in un 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 di risorse monitorate, consulta quanto segue:

• Etichette: Etichette metadati delle risorse
• Filtri: Filtri di monitoraggio
• Tipi specifici di risorse monitorate: Elenco delle risorse monitorate

Modifica

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

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