Questo documento descrive come viene configurato l'ambito delle metriche di un progetto di gestione. Un progetto di gestione viene creato da Google Cloud quando abiliti una cartella per il monitoraggio delle applicazioni. Il progetto di gestione memorizza le informazioni di configurazione richieste dai servizi Google Cloud Observability ed è il progetto che utilizzi per visualizzare la telemetria della tua applicazione.
Se non utilizzi una cartella abilitata per l'app, questo documento non si applica. Consulta invece Configurare un ambito delle metriche.
Questa pagina descrive come visualizzare l'utilizzo della quota dell'ambito delle metriche, come richiedere un aggiornamento della quota e come aggiornare manualmente l'ambito delle metriche del progetto di gestione.
Come viene gestito l'ambito delle metriche per un progetto di gestione
Per le cartelle abilitate per le app, Google Cloud Observability tenta di sincronizzare l'elenco dei progetti nella cartella abilitata per le app con l'elenco dei progetti nell'ambito delle metriche. Ad esempio, se aggiungi un progetto alla cartella abilitata per l'app, viene emesso un comando per aggiungere il progetto all'ambito delle metriche.
Quando il numero di progetti nella cartella abilitata per le app non supera la quota dell'ambito delle metriche, che per impostazione predefinita è di 375 progetti per ambito delle metriche, Google Cloud Observability può mantenere sincronizzato l'elenco dei progetti nell'ambito delle metriche con l'elenco dei progetti nella cartella abilitata per le app. Ad esempio, supponiamo che la quota sia 375 progetti per ambito delle metriche. Se la cartella abilitata per le app contiene 100 progetti, l'ambito delle metriche elenca tutti i progetti nella cartella abilitata per le app. Se aggiungi progetti alla cartella abilitata per le app, questi vengono aggiunti anche all'ambito delle metriche.
Quando il numero di progetti nella cartella abilitata per le app supera la quota dell'ambito delle metriche, l'elenco dei progetti nell'ambito delle metriche non includerà tutti i progetti nella cartella abilitata per le app. Ad esempio, supponiamo che la quota sia di 375 progetti per ambito delle metriche e che la cartella abilitata per le app contenga 380 progetti. Dopo l'aggiunta di 375 progetti all'ambito delle metriche, la quota è esaurita e i tentativi di aggiungere i 5 progetti rimanenti non vanno a buon fine. Di conseguenza, alcuni dati dell'applicazione non sono disponibili per il tuo progetto di gestione.
Se la quota dell'ambito delle metriche è esaurita, puoi procedere in uno dei seguenti modi:
Modificare i progetti elencati nell'ambito delle metriche. Ad esempio, puoi rimuovere alcuni progetti dall'ambito delle metriche per aggiungerne altri.
Richiedi un aumento della quota e poi aggiungi manualmente i progetti che non sono stati aggiunti automaticamente. Nell'esempio precedente, devi aggiungere manualmente i 5 progetti che non è stato possibile aggiungere all'ambito delle metriche. Google Cloud Observability non riprova ad aggiungere un progetto a un ambito delle metriche quando il tentativo iniziale per quel progetto non è riuscito.
In entrambi gli scenari devi modificare manualmente l'ambito delle metriche.
Prima di iniziare
- Se non hai familiarità con il termine ambito delle metriche, consulta Panoramica degli ambiti delle metriche.
-
Per ottenere le autorizzazioni necessarie per configurare un ambito delle metriche, chiedi all'amministratore di concederti il ruolo IAM Monitoring Admin (
roles/monitoring.admin) nel progetto di gestione per la cartella abilitata per l'app e in ogni progetto che vuoi aggiungere o rimuovere dall'ambito delle metriche. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
Visualizzare l'utilizzo della quota
Per evitare di dover gestire manualmente l'ambito delle metriche per il progetto di gestione, assicurati di disporre di una quota disponibile prima di aggiungere progetti alla cartella abilitata per le app. Questa sezione descrive come visualizzare l'utilizzo attuale delle quote.
Per visualizzare l'utilizzo della quota dell'ambito delle metriche:
-
Nella Google Cloud console, vai alla pagina settings Impostazioni:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
- Nella Google Cloud console, seleziona il progetto di gestione.
Seleziona Ambito metrica.
Il riquadro Quota ambito delle metriche mostra l'utilizzo e la quota. Le icone nella scheda Ambito delle metriche hanno il seguente significato:
L'icona di errore, error, indica che è stato utilizzato almeno il 90% della tua quota.
L'icona di avviso, warning, indica che è stato utilizzato tra il 70% e il 90% della quota.
Richiedi un aumento della quota
Se l'utilizzo della quota dell'ambito delle metriche del tuo progetto supera il 70%, viene visualizzata un'icona di avviso, warning, o un'icona di errore, error, nella scheda Ambito delle metriche. Per impostazione predefinita, un ambito delle metriche può includere 375 Google Cloud progetti. Se aumenti la quota e aggiungi più di 375 Google Cloud progetti a un ambito delle metriche, potresti riscontrare problemi di prestazioni.
Per richiedere un aumento della quota:
-
Nella Google Cloud console, vai alla pagina settings Impostazioni:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
- Nella Google Cloud console, seleziona il progetto di gestione.
- Seleziona Ambito metrica.
Nel riquadro Quota ambito metriche, seleziona Richiedi aumento quota e completa la finestra di dialogo.
Assicurati di richiedere un aumento della quota denominata "Progetti monitorati / ambito delle metriche di monitoraggio". Puoi trovare informazioni dettagliate su questa attività nel documento Gestire la quota utilizzando la console Google Cloud .
Una volta aumentata la quota, puoi aggiungere progetti all'ambito delle metriche.
Aggiungere progetti a un ambito delle metriche
Per aggiungere progetti a un ambito delle metriche:
-
Nella Google Cloud console, vai alla pagina settings Impostazioni:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
- Nella Google Cloud console, seleziona il progetto di gestione.
Seleziona Ambito metrica.
La scheda Ambito delle metriche elenca le risorse monitorate dal Google Cloud progetto attuale. Elenca anche i progetti Google Cloud il cui ambito delle metriche include il progetto Google Cloud corrente.
Per aggiungere Google Cloud progetti all'ambito delle metriche:
- Nel riquadro Progetti Google Cloud, fai clic su Aggiungi progetti.
Nella finestra di dialogo Aggiungi progetti Google Cloud, fai clic su Seleziona progetti, quindi effettua le selezioni. Per salvare le modifiche, fai clic su Aggiungi progetti.
Tornerai alla pagina Impostazioni e la tabella verrà aggiornata per elencare le tue selezioni. Se vuoi rimuovere un Google Cloud progetto dall'elenco, fai clic su cancel Rimuovi progetto.
Dopo aver aggiunto progetti a un ambito delle metriche, sono necessari circa 60 secondi perché le modifiche vengano propagate a tutti i sistemi di Monitoring. Prima di creare un grafico o un criterio di avviso, attendi almeno 60 secondi. Potresti dover aggiornare la pagina della console Google Cloud per visualizzare le nuove metriche.
L'ambito delle metriche del progetto selezionato è stato aggiornato per includere i Google Cloud progetti selezionati.
Rimuovere progetti da un ambito delle metriche
Potresti voler rimuovere progetti da un ambito delle metriche per migliorare il rendimento o per liberare quota in modo da poter aggiungere un progetto diverso. Ad esempio, per impostazione predefinita, un ambito delle metriche può includere 375 Google Cloud progetti. Se hai esaurito questa quota, potresti rimuovere un progetto per poterne aggiungere un altro.
Dopo aver rimosso un progetto da un ambito delle metriche, i dati delle serie temporali archiviati in quel progetto non possono essere rappresentati graficamente o monitorati dal progetto di definizione dell'ambito. La rimozione di un progetto da un ambito delle metriche non modifica la configurazione di grafici, dashboard, criteri di avviso, controlli di uptime o gruppi che hai definito. Tuttavia, le serie temporali visualizzate nei grafici e quelle monitorate dai criteri di avviso potrebbero cambiare.
Per rimuovere i progetti da un ambito delle metriche:
-
Nella Google Cloud console, vai alla pagina settings Impostazioni:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
- Nella Google Cloud console, seleziona il progetto di gestione.
- Seleziona Ambito metrica.
- Nel riquadro Progetti Google Cloud, seleziona i progetti che vuoi rimuovere, fai clic su Rimuovi progetto e poi completa la finestra di dialogo di conferma.
Elenca i progetti in un ambito delle metriche
Per elencare le risorse in un ambito delle metriche:
-
Nella Google Cloud console, vai alla pagina settings Impostazioni:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
- Nella Google Cloud console, seleziona il progetto di gestione.
Seleziona Ambito metrica.
La scheda Ambito delle metriche elenca le risorse monitorate dal Google Cloud progetto attuale. Elenca anche i progetti Google Cloud il cui ambito delle metriche include il progetto Google Cloud corrente.