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'etichettaproject_id
e un'espressione che utilizza 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 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.
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 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.
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
.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