Questo documento descrive come viene configurato l'ambito delle metriche di un progetto di gestione. Un progetto di gestione viene creato Google Cloud quando abiliti una cartella per il monitoraggio delle applicazioni. Il progetto di gestione immagazzina le informazioni di configurazione richieste dai servizi di osservabilità di Google Cloud ed è il progetto che utilizzi per visualizzare la telemetria della tua applicazione.
Se non utilizzi una cartella abilitata per le app, questo documento non è applicabile. 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 con abilitazione app, Google Cloud Observability tenta di sincronizzare l'elenco dei progetti nella cartella con abilitazione app con l'elenco dei progetti nell'ambito delle metriche. Ad esempio, se aggiungi un progetto alla cartella abilitata per le app, viene emesso un comando per aggiungerlo 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 è pari a 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 di 375 progetti per ambito delle metriche. Se la cartella con l'app abilitata contiene 100 progetti, l'ambito delle metriche elenca tutti i progetti nella cartella con l'app abilitata. 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 tua cartella abilitata per le app contenga 380 progetti. Dopo aver aggiunto 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 in modo da poter aggiungere altri progetti.
Richiedi un aumento della quota, quindi 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 riproverà ad aggiungere un progetto a un ambito delle metriche se il tentativo iniziale per quel progetto non è andato a buon fine.
In entrambi gli scenari, devi modificare manualmente l'ambito delle metriche.
Prima di iniziare
- Se non hai dimestichezza 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 Amministratore monitoraggio (
roles/monitoring.admin) nel progetto di gestione per la tua cartella abilitata per le app e in ogni progetto che vuoi aggiungere all'ambito delle metriche. Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestire 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 avere 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 console Google Cloud, vai alla pagina settings Impostazioni:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
- Nella console Google Cloud, seleziona il progetto di gestione.
Seleziona Ambito delle metriche.
Il riquadro Quota ambito delle metriche mostra l'utilizzo della quota e la quota. Le icone nella scheda Ambito delle metriche hanno il seguente significato:
L'icona di errore error indica che almeno il 90% della quota è stato utilizzato.
L'icona di avviso warning indica che è stato utilizzato tra il 70% e il 90% della tua quota.
Richiedi un aumento della quota
Se il progetto supera il 70% della quota dell'ambito delle metriche, nella scheda Ambito delle metriche viene visualizzata un'icona di avviso (warning) o di errore (error). Per impostazione predefinita, un ambito delle metriche può includere 375 progetti Google Cloud. Se aumenti la quota e aggiungi più di 375 progetti Google Cloud a un ambito delle metriche, potresti riscontrare problemi di prestazioni.
Per richiedere un aumento della quota:
-
Nella console Google Cloud, vai alla pagina settings Impostazioni:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
- Nella console Google Cloud, seleziona il progetto di gestione.
- Seleziona Ambito delle metriche.
Nel riquadro Quota ambito metriche, seleziona Richiedi aumento quota e completa la finestra di dialogo.
Assicurati di richiedere un aumento della quota "Progetti monitorati / Ambito delle metriche di monitoraggio". Puoi trovare informazioni dettagliate su questa attività nel documento Gestire la quota utilizzando la console Google Cloud.
Dopo l'aumento della quota, puoi aggiungere progetti all'ambito delle metriche.
Aggiungere progetti a un ambito delle metriche
Per aggiungere progetti a un ambito delle metriche, procedi nel seguente modo:
-
Nella console Google Cloud, vai alla pagina settings Impostazioni:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
- Nella console Google Cloud, seleziona il progetto di gestione.
Seleziona Ambito delle metriche.
La scheda Ambito delle metriche elenca le risorse monitorate dal progetto Google Cloud corrente. Vengono elencati anche i progetti Google Cloud il cui ambito delle metriche include il progetto Google Cloud corrente.
Per aggiungere progetti Google Cloud 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 in quella pagina verrà aggiornata per elencare le tue selezioni. Se vuoi rimuovere un progetto Google Cloud dall'elenco, fai clic su cancel Rimuovi progetto.
Dopo aver aggiunto i progetti a un ambito delle metriche, sono necessari circa 60 secondi per la propagazione delle modifiche in tutti i sistemi di monitoraggio. 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 in modo da includere i progetti Google Cloud selezionati.
Rimuovere i progetti da un ambito delle metriche
Potresti voler rimuovere i progetti da un ambito delle metriche per migliorare il rendimento o per liberare quota in modo da poter aggiungere un altro progetto. Ad esempio, per impostazione predefinita, un ambito delle metriche può includere 375 progetti Google Cloud. Se hai esaurito questa quota, puoi rimuovere un progetto per aggiungerne un altro.
Dopo aver rimosso un progetto da un ambito delle metriche, i dati delle serie temporali memorizzati nel progetto non possono essere visualizzati in un grafico 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 console Google Cloud, vai alla pagina settings Impostazioni:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
- Nella console Google Cloud, seleziona il progetto di gestione.
- Seleziona Ambito delle metriche.
- Nel riquadro Progetti Google Cloud, seleziona i progetti da rimuovere, fai clic su Rimuovi progetto e 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 console Google Cloud, vai alla pagina settings Impostazioni:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
- Nella console Google Cloud, seleziona il progetto di gestione.
Seleziona Ambito delle metriche.
La scheda Ambito delle metriche elenca le risorse monitorate dal progetto Google Cloud corrente. Vengono elencati anche i progetti Google Cloud il cui ambito delle metriche include il progetto Google Cloud corrente.