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 vengono generati errori RESOURCE_EXHAUSTED.

Controlla la quota

Per controllare la quota di contemporaneità nel tuo progetto, segui questi passaggi:

  1. Vai alla pagina Quote nella console Google Cloud .

    Vai a Quote

  2. Nel campo Filtro, inserisci databoost. Seleziona una delle seguenti opzioni dall'elenco:

    • DataBoostQuotaPerProjectPerRegion per visualizzare la quota di richieste in parallelo di Data Boost.
    • DataBoostMilliQuotaPerProjectPerRegion per visualizzare la quota di richieste in parallelo di Data Boost in millesimi di operazioni.

  3. Nella tabella risultante, individua la tua regione e visualizza il limite per quella regione.

Monitora l'utilizzo della quota

Per monitorare l'utilizzo della quota:

  1. Nella console Google Cloud , vai a Monitoring.
    Vai a Monitoring
  2. Se nel menu di navigazione è mostrato Esplora metriche, selezionalo. In caso contrario, fai clic su Risorse e poi seleziona Esplora metriche.
  3. Nella parte superiore della pagina, seleziona un intervallo di tempo.
  4. Nell'elenco a discesa Metrica, nel campo Filtra in base al nome della risorsa o della metrica, inserisci consumer e premi Enter per restringere la ricerca.
  5. Per visualizzare la quota di richieste in parallelo di Data Boost:
    1. Nell'elenco, seleziona Quota consumer > Quota > Utilizzo quota simultanea, quindi fai clic su Applica.
    2. Fai clic su + AGGIUNGI FILTRO per creare un filtro.
    3. Nell'elenco a discesa Etichetta 1, seleziona quota_metric.
    4. Nel campo di testo Valore 1, inserisci o seleziona spanner.googleapis.com/data_boost_quota.

  6. Per visualizzare la quota di richieste in parallelo di Data Boost in millesimi di operazioni:

    1. Nell'elenco, seleziona Quota consumer > Quota > Utilizzo quota di frequenza, quindi fai clic su Applica.
    2. Fai clic su + AGGIUNGI FILTRO per creare un filtro.
    3. Nell'elenco a discesa Etichetta 1, seleziona quota_metric.
    4. Nel campo di testo Valore 1, inserisci o seleziona spanner.googleapis.com/data_boost_milli_quota.

    In Esplora metriche viene visualizzato un grafico a linee dell'utilizzo della quota per regione.

  7. (Facoltativo) Nella sezione Visualizzazione, per Tipo di widget, seleziona Grafico a barre in pila.

Monitora gli errori e i limiti relativi alle quote

Per monitorare gli errori di quota dovuti alla quota di richieste in parallelo di Data Boost, segui questi passaggi:

  1. In Esplora metriche, seleziona la metrica Quota consumer > Quota > Errore di superamento quota.

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

Per monitorare il limite della quota di milli-operazioni per le richieste in parallelo di Data Boost, segui questi passaggi:

  1. In Esplora metriche, seleziona la metrica Quota consumer > Quota > Limite quota.

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

Imposta un avviso per l'utilizzo di Data Boost

Puoi creare una policy di avviso che ti avvisa quando il numero di query partizionate simultanee 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 riportate in Crea policy di avviso basate su soglie metriche.
  2. Nell'elenco a discesa Seleziona una metrica, nel campo Filtra in base al nome della risorsa o della metrica, inserisci consumer e premi Enter per restringere la ricerca.

  3. Per impostare un avviso sull'utilizzo della quota di richieste in parallelo di Data Boost:

    1. Nell'elenco Seleziona una metrica, seleziona Quota consumer > Quota > Utilizzo quota simultanea, quindi fai clic su Applica.
    2. Nella sezione Aggiungi filtri, fai clic su Aggiungi un filtro per creare un filtro.
    3. Nell'elenco a discesa Filtro, seleziona quota_metric.
    4. Nel campo di testo Valore, inserisci o seleziona spanner.googleapis.com/data_boost_quota e fai clic su Fine.
    5. Continua con la creazione di una policy di avviso e imposta la soglia su una 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 valore massimo, inserisci 160 nel campo Valore soglia.

  4. Per impostare un avviso sull'utilizzo della quota di milli-operazioni per le richieste in parallelo di Data Boost:

    1. Nell'elenco Seleziona una metrica, seleziona Quota consumer > Quota > Utilizzo quota di frequenza, quindi fai clic su Applica.
    2. Nella sezione Aggiungi filtri, fai clic su Aggiungi un filtro per creare un filtro.
    3. Nell'elenco a discesa Filtro, seleziona quota_metric.
    4. Nel campo di testo Valore, inserisci o seleziona spanner.googleapis.com/data_boost_milli_quota e fai clic su Fine.
    5. Continua con la creazione di una policy di avviso e imposta la soglia su una percentuale della quota.

    Ad esempio, se la quota predefinita è 1.000.000 e vuoi ricevere una notifica quando le milli-operazioni della richiesta raggiungono l'80% del limite, inserisci 800.000 nel campo Valore soglia.

Gestisci gli errori di quota

Se la percentuale di errori di superamento della quota è 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. Il tuo workload potrebbe essere limitato dalla quota di richieste in parallelo di Data Boost o dalla quota di milli-operazioni. Potresti dover aumentare la quota di milli-operazioni dopo aver aumentato la quota di richieste in parallelo.

Impedisci a un'entità di utilizzare le risorse Data Boost

Se un'entità supera costantemente la quantità di risorse Data Boost che si può ragionevolmente prevedere che consumi, puoi impedirle di utilizzare le risorse Data Boost revocando l'autorizzazione Identity and Access Management (IAM) 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