Monitorare e gestire l'utilizzo della quota di Data Boost

Spanner Data Boost è soggetto a quote che limitano il numero di chiamate ExecuteStreamingSQL e StreamingRead simultanee eseguite per progetto e per regione. Quando il numero di richieste in parallelo supera la quota, le richieste non vanno a buon fine e generano errori RESOURCE EXHAUSTED.

Controlla la tua quota

Per verificare la quota di contemporaneità nel tuo progetto:

  1. Vai alla pagina Quote nella console Google Cloud.

    Vai a Quote

  2. Nel campo Filtro, inserisci databoost. Quindi, nell'elenco, seleziona DataBoostQuotaPerProjectPerRegion.

  3. Nella tabella risultante, individua la tua regione e visualizzane il limite.

Monitoraggio dell'utilizzo della quota

Per monitorare l'utilizzo della quota, segui questi passaggi:

  1. Nella console Google Cloud, vai a Monitoring.
    Vai a Monitoring
  2. Se nel menu di navigazione è visualizzato Metrics Explorer, selezionalo. In caso contrario, fai clic su Risorse e poi seleziona Metrics Explorer.
  3. Nella parte superiore della pagina, seleziona un intervallo di tempo.
  4. Nell'elenco a discesa Metrica, nel campo Filtra per nome risorsa o metrica, inserisci consumer e premi Enter per restringere la ricerca.
  5. Nell'elenco, seleziona Quota consumer > Quota > Utilizzo simultaneo della quota, quindi fai clic su Applica.
  6. Fai clic su + AGGIUNGI FILTRO per creare un filtro.
  7. Nell'elenco a discesa Etichetta 1, seleziona quota_metric.

  8. Nel campo di testo Valore 1, inserisci o seleziona spanner.googleapis.com/data_boost_quota.

    Metrics Explorer mostra un grafico a linee dell'utilizzo della quota per regione.

  9. (Facoltativo) In Display, per Tipo di widget, seleziona Grafico a barre in pila.

Monitorare gli errori di quota

Per monitorare gli errori di quota:

  1. In Metrics Explorer, seleziona la metrica Quota consumer > Quota > Errore Quota superata.

  2. Aggiungi un filtro per quota_metric uguale a spanner.googleapis.com/data_boost_quota.

Imposta un avviso per l'utilizzo di Data Boost

Puoi creare un criterio di avviso che ti avvisa quando il numero di query partizionate in parallelo che richiedono Data Boost (chiamate ExecuteStreamingSQL e StreamingRead simultanee) per progetto e per regione supera una determinata soglia. Per farlo, segui questi passaggi:

  1. Segui le istruzioni in Creare criteri di avviso per soglia di metriche.
  2. Nell'elenco a discesa Seleziona una metrica, nel campo Filtra per nome risorsa o metrica, inserisci data_boost e premi Enter per restringere la ricerca.
  3. Nell'elenco Seleziona una metrica, seleziona Istanza Cloud Spanner > Istanza > Seconda unità di elaborazione, quindi fai clic su Applica.

  4. Continua con la creazione di un criterio di avviso e imposta la soglia su una certa percentuale della quota.

    Ad esempio, se la quota predefinita è 200 e vuoi ricevere una notifica quando il numero di richieste in parallelo raggiunge l'80% del massimo, inserisci 160 nel campo Valore soglia.

Gestire gli errori di quota

Se la percentuale di errori di quota superata è elevata, quando utilizzi Dataflow con Data Boost, ti consigliamo di modificare il numero massimo di worker nel job Dataflow per evitare di superare la quota di Data Boost. Puoi anche richiedere una quota più alta.

Impedisci a un'entità di consumare risorse Data Boost

Se un'entità supera costantemente la quantità di risorse Data Boost che potrebbe essere ragionevolmente utilizzata, puoi impedire all'entità di utilizzare le risorse Data Boost revocando l'autorizzazione IAM (Identity and Access Management) di spanner.databases.useDataBoost dall'entità. Puoi automatizzare la revoca dell'autorizzazione configurando il canale di notifica di un avviso come webhook che richiama una Cloud Function. Per ulteriori informazioni, consulta i seguenti argomenti:

Passaggi successivi