Motore per suggerimenti sui limiti di servizio (quota)
Il motore per suggerimenti sui limiti di servizio analizza l'utilizzo delle quote di servizio da parte dei progetti della tua organizzazione e fornisce suggerimenti che ti aiutano a identificare le risorse che potrebbero avvicinarsi ai limiti di quota.
Panoramica
I limiti di quota servono a gestire le risorse e a proteggerti da picchi di utilizzo imprevisti, ma possono essere complicati da monitorare e gestire. Il motore per suggerimenti sui limiti di servizio analizza l'utilizzo della quota e ti fornisce le seguenti funzionalità per aiutarti a individuare potenziali colli di bottiglia prima che si trasformino in un problema:
- Suggerimenti per la revisione delle quote con utilizzo elevato
- Insight sull'utilizzo per ogni quota con utilizzo elevato
Il monitoraggio proattivo e l'adozione di misure in base ai suggerimenti sulle quote possono contribuire a ridurre il rischio di esaurimento della quota. Oltre ai suggerimenti che vengono aggiornati una volta al giorno, puoi configurare avvisi sull'utilizzo della quota utilizzando Cloud Monitoring per qualsiasi quota che potrebbe richiedere il monitoraggio in tempo reale.
Come funziona
Il motore per suggerimenti sui limiti di servizio analizza l'utilizzo rispetto a tariffa, allocazione e quote simultanee negli ultimi 30 giorni. Se in qualsiasi momento durante questi 30 giorni l'utilizzo ha raggiunto l'80% del limite attuale, verrà generato un suggerimento.
Prezzi
Fai riferimento ai prezzi del motore per suggerimenti.
Prima di iniziare
Prima di poter visualizzare gli approfondimenti e i consigli, devi eseguire le seguenti operazioni:
- Devi abilitare l'API Recommender. Devi abilitare l'API solo su un singolo progetto. Puoi quindi utilizzare lo stesso progetto per esaminare suggerimenti e insight per altri progetti utilizzando la funzionalità --billing-project di gcloud/API.
- Assicurati di aver assegnato uno di questi ruoli obbligatori:
Descrizione | Ruoli |
---|---|
Visualizza i suggerimenti |
recommender.serviceLimitViewer |
Visualizza e aggiorna i consigli |
recommender.serviceLimitAdmin |
Questi ruoli forniscono un insieme di autorizzazioni che ti consentono di accedere agli insight e ai suggerimenti. Per ulteriori informazioni sui ruoli, consulta Comprendere i ruoli e concedere le autorizzazioni IAM.
Puoi anche disattivare tutti gli approfondimenti e i consigli sui limiti di servizio nel Centro trasparenza e controllo. Per modificare le impostazioni di disattivazione, devi disporre del ruolo IAM dataprocessing.admin
. Per ulteriori informazioni sulla disattivazione, consulta la sezione Disattivare approfondimenti e consigli.
ID motore per suggerimenti
Ecco l'ID motore per suggerimenti del limite di servizio (quota) e il tipo di insight:
google.resourcemanager.serviceLimit.Recommender
google.resourcemanager.serviceLimit.Insight
Autorizzazioni IAM richieste
Per accedere all'elenco di suggerimenti e insight sui limiti di servizio, sono necessarie le seguenti autorizzazioni:
recommender.resourcemanagerServiceLimitRecommendations.get
recommender.resourcemanagerServiceLimitRecommendations.list
recommender.resourcemanagerServiceLimitInsights.get
recommender.resourcemanagerServiceLimitInsights.list
Per aggiornare i consigli e gli approfondimenti (ad esempio per ignorare un suggerimento), sono necessarie le seguenti autorizzazioni:
recommender.resourcemanagerServiceLimitRecommendations.update
recommender.resourcemanagerServiceLimitInsights.update
Visualizzazione dei suggerimenti sui limiti di servizio (quota)
È possibile accedere a insight e suggerimenti tramite la console Cloud, gcloud
o l'API Recommender per tutti i clienti.
L'esportazione dei suggerimenti tramite BigQuery è disponibile anche per i clienti con pacchetto di assistenza Standard, Avanzato o Premium.
Console
Vai all'hub dei suggerimenti. Vedi anche la Guida introduttiva all'hub dei suggerimenti.
Nella scheda Esamina e gestisci l'utilizzo della quota, fai clic su Visualizza tutto.
gcloud
Per visualizzare consigli e approfondimenti utilizzando gcloud
, segui i passaggi riportati di seguito.
Per ulteriori informazioni, consulta gli articoli Utilizzo dell'API - Approfondimenti e Utilizzo dell'API - Consigli.
Suggerimenti
Per elencare i suggerimenti per il progetto in cui hai abilitato l'API Recommender, esegui questo comando:
gcloud recommender recommendations list \ --project=PROJECT_ID \ --location=LOCATION \ --recommender=google.resourcemanager.serviceLimit.Recommender
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto.LOCATION
: la regione o la zona Cloud. Se un tipo di quota non è definito a livello di regione o zona, rientrerà nella località "globale".
Per elencare i suggerimenti in un altro progetto durante l'utilizzo di un progetto in cui hai abilitato l'API Recommender (come nel passaggio precedente), esegui questo comando:
gcloud recommender recommendations list \ --billing-project=BILLING_PROJECT_ID \ --project=PROJECT_ID \ --location=LOCATION \ --recommender=google.resourcemanager.serviceLimit.Recommender
Sostituisci quanto segue:
BILLING_PROJECT_ID
: l'ID del progetto che hai abilitato con l'API Recommender (valore equivalente a PROJECT_ID) indicato nel passaggio precedente.PROJECT_ID
: l'ID di un altro progetto per il quale vuoi visualizzare i suggerimenti.LOCATION
: la regione o la zona Cloud. Se un tipo di quota non è definito a livello di regione o zona, rientrerà nella località "globale".
Insight
È possibile utilizzare un insieme di comandi simile per elencare gli insight. Basta apportare due modifiche a ciascuno dei comandi precedenti:
- Anziché eseguire
gcloud recommender recommendations list
, eseguigcloud recommender insights list
. - Invece di trasmettere
--recommender=google.resourcemanager.serviceLimit.Recommender
pass--insight-type=google.resourcemanager.serviceLimit.Insight
Ad esempio, per elencare gli insight per un determinato progetto, esegui questo comando:
gcloud recommender insights list
--project=PROJECT_ID
--location=LOCATION
--insight-type=google.resourcemanager.serviceLimit.Insight
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto.LOCATION
: la regione o la zona Cloud. Se un tipo di quota non è definito a livello di regione o zona, rientrerà nella località "globale".
API
Per visualizzare suggerimenti e approfondimenti, puoi utilizzare curl
per inviare una richiesta alle API del motore per suggerimenti. Per autorizzare le richieste dalla riga di comando,
usa i token di accesso OAuth. Un token di accesso OAuth è una stringa che concede accesso temporaneo a un'API.
Suggerimenti
Per elencare i suggerimenti per il progetto in cui hai abilitato l'API Recommender, esegui questo comando:
curl \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/\ recommenders/google.resourcemanager.serviceLimit.Recommender/recommendations"
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto.LOCATION
: la regione o la zona Cloud. Se un tipo di quota non è definito a livello di regione o zona, rientrerà nella località "globale".
Per elencare i suggerimenti in un altro progetto durante l'utilizzo di un progetto in cui hai abilitato l'API Recommender (come nel passaggio precedente), esegui questo comando:
curl \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "x-goog-user-project: BILLING_PROJECT_ID" \ "https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/\ recommenders/google.resourcemanager.serviceLimit.Recommender/recommendations"
Sostituisci quanto segue:
BILLING_PROJECT_ID
: l'ID del progetto che hai abilitato con l'API Recommender (valore equivalente a PROJECT_ID) indicato nel passaggio precedente.PROJECT_ID
: l'ID di un altro progetto per il quale vuoi visualizzare i suggerimenti.LOCATION
: la regione o la zona Cloud. Se un tipo di quota non è definito a livello di regione o zona, rientrerà nella località "globale".
Insight
È possibile utilizzare un insieme di comandi simile per elencare gli insight. Basta sostituire recommenders/google.resourcemanager.serviceLimit.Recommender/recommendations
con insightTypes/google.resourcemanager.serviceLimit.Insight/insights
nell'URL.
Ad esempio, per elencare gli insight per un determinato progetto, esegui questo comando:
curl
-H "Authorization: Bearer $(gcloud auth print-access-token)"
"https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/
insightTypes/google.resourcemanager.serviceLimit.Insight/insights"
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto.LOCATION
: la regione o la zona Cloud. Se un tipo di quota non è definito a livello di regione o zona, rientrerà nella località "globale".
Esportazione in BigQuery
È possibile esportare suggerimenti e approfondimenti in blocco in una tabella BigQuery. Per maggiori dettagli, consulta la documentazione di BigQuery Export.