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.
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.
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'etichettaproject_id
e un'espressione usando le etichette dei metadati. - Utilizza l'operazione
!=
con l'etichettaproject_id
. - Utilizza le funzioni
starts_with
ohas_substring
con l'etichettaproject_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:
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.
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
.
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:
Vai alla console Google Cloud.
Fai clic su Attiva Cloud Shell nella parte superiore della pagina della console Google Cloud per il tuo progetto.
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.
Crea un nuovo file denominato
metadata_label_detection.py
selezionando File e poi Nuovo file. Incolla il testo dimetadata_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.
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
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.
Aggiornare i filtri
Per aggiornare i criteri di avviso, i grafici, i prospetti e i gruppi di risorse:
Accedi alla console Google Cloud.
Esegui lo script del rilevatore come descritto in Trovare le etichette deprecate.
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
.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.
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