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

  1. Vai all'hub dei suggerimenti. Vedi anche la Guida introduttiva all'hub dei suggerimenti.

    Vai all'hub dei suggerimenti

  2. 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

  1. 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".
  2. 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, esegui gcloud 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

  1. 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".
  2. 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.