Le risorse monitorate in Cloud Monitoring includono un set di etichette utilizzate per identificare una determinata 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 ulteriori etichette 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 etichette metadati proprie. Per ulteriori informazioni, consulta la sezione 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
Entro il 31 luglio 2020, tutti i criteri di avviso, i grafici, i prospetti e i gruppi di risorse che specificano una risorsa monitorata e che utilizzano le etichette dei metadati per le quali è possibile determinare la sostituzione delle etichette sono stati sottoposti automaticamente a migrazione. 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 le etichette dei metadati di cui non è stata eseguita la migrazione automatica o manuale entro il 31 luglio 2020 non sono più supportati e potrebbero non funzionare più.
Azione richiesta
Per correggere i criteri di avviso, i grafici, i prospetti o i gruppi di risorse che non hanno più funzionato a causa di etichette dei metadati deprecate, devi intraprendere alcune azioni. Puoi rimuovere i criteri di avviso, i grafici, i prospetti o i gruppi oppure puoi modificare qualsiasi filtro che utilizza quelle ritirate per utilizzare le etichette che forniscono un comportamento simile.
Analogamente, se hai filtri che utilizzano le etichette dei metadati ma non specificano le risorse monitorate, non è possibile determinare automaticamente se queste etichette sono obsolete. Devi valutarle e risolvere i problemi manualmente.
Questa pagina include uno script per aiutarti a identificare l'utilizzo delle etichette dei metadati obsolete.
Etichette metadati obsolete
La tabella seguente elenca le etichette dei metadati della risorsa obsolete e le eventuali sostituzioni.
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 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'utilizzo flessibile dell'etichetta
resources.labels.project_id
come l'etichetta
metadata.system_labels.cloud_account
.
Ad esempio, non puoi:
- Utilizza
OR
per combinare un'espressione usando l'etichettaproject_id
e un'espressione usando le etichette 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 ottime sostituzioni. Ma 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
, il valore è stato inserito automaticamente con il valore metadata.system_labels.name
.
L'inserimento automatico è terminato anche il 31 luglio 2020.
Per l'utilizzo di metadata.system_labels.name
è 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
completato automaticamente.
# 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 minuscolo (ad esempio, "My-Subscription"
è diventato "my-subscription"
). Questo ha prodotto un comportamento imprevisto nei casi in cui gli utenti avevano più risorse con nomi minuscoli 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 dell'abbonamento (ad esempio, "My-Subscription"
).
Cosa devo fare?
Esistono due passaggi di alto livello:
Decidi se stai utilizzando etichette dei metadati interessate da questo ritiro. Consulta Trovare le etichette dei metadati deprecate per informazioni sull'esecuzione dello script di rilevamento fornito.
Se utilizzi etichette dei metadati interessate, aggiornale o rimuovile. Per istruzioni più dettagliate, consulta la sezione Aggiornare i 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 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 descrivono un modo per utilizzare lo script:
Vai a Google Cloud Console.
Fai clic su Attiva Cloud Shell nella parte superiore della pagina Google Cloud Console relativa al 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 poi 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 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 rapporto 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 a Google Cloud Console.
Esegui lo script di rilevamento come descritto in Trovare etichette deprecate.
Esamina ogni criterio di avviso, grafici e gruppi di risorse per verificare se il valore recuperato proviene da una delle etichette deprecate identificate dallo script.
Per controllare tutti i grafici, devi verificare ogni grafico in ciascuna dashboard personalizzata che hai definito.
Ricorda che i filtri utilizzano il prefisso
resource.metadata
anzichémetadata.system_labels
.Per ogni etichetta deprecata, procedi in uno dei seguenti modi:
Se l'etichetta non ha sostituzioni, rimuovi l'uso dell'etichetta o elimina il criterio di avviso, il grafico o il gruppo di risorse.
Se l'etichetta è sostitutiva, sostituiscila con la sostituzione.
Se non intervieni, il criterio di avviso, il grafico o il gruppo di risorse interessati non funzioneranno.
Per ulteriore assistenza sull'aggiornamento mediante Google Cloud Console, consulta le risorse elencate in Modifica.
In alcuni casi, potresti dover utilizzare l'API Cloud Monitoring anziché Cloud Console. L'API è in grado di esprimere alcune query che non possono essere costruite.
Esegui di nuovo lo script di rilevamento, per verificare che non ci siano etichette obsolete.
Informazioni aggiuntive
Per informazioni su etichette, filtri o tipi specifici di risorse monitorate, consulta quanto segue:
- Etichette: Etichette metadati delle risorse
- Filtri: Filtri di monitoraggio
- Tipi di risorse monitorate specifiche: elenco di risorse monitorate
In fase di 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 Google Cloud Console: Gestione delle dashboard
- Dashboard tramite l'API Monitoring: aggiornamento delle dashboard
- Gruppi di risorse: Modifica di un gruppo