Monitorar e gerenciar o uso da cota do Data Boost

O Spanner Data Boost está sujeito a cotas que limitam o número de chamadas simultâneas de ExecuteStreamingSQL e StreamingRead executadas por projeto e por região. Quando o número de solicitações simultâneas excede a cota, as solicitações falham com erros RESOURCE EXHAUSTED.

Verificar sua cota

Para verificar a cota de simultaneidade no seu projeto, siga estas etapas:

  1. Acesse a página "Cotas" no console do Google Cloud .

    Acessar "Cotas"

  2. No campo Filtro, digite databoost. Na lista, selecione uma das opções a seguir:

    • DataBoostQuotaPerProjectPerRegion para conferir a cota de solicitações simultâneas do Data Boost.
    • DataBoostMilliQuotaPerProjectPerRegion para conferir a cota de solicitações simultâneas do Data Boost em milioperações.

  3. Na tabela resultante, localize sua região e confira o limite dela.

Monitorar o uso da cota

Para monitorar o uso da cota, siga estas etapas:

  1. No console do Google Cloud , acesse o Monitoring.
    Acessar o Monitoring
  2. Se o Metrics Explorer aparecer no menu de navegação, selecione-o. Caso contrário, clique em Recursos e selecione Metrics Explorer.
  3. Na parte de cima da página, selecione um intervalo de tempo.
  4. Na lista suspensa Métrica, no campo Filtrar por nome do recurso ou da métrica, digite consumer e pressione Enter para restringir a pesquisa.
  5. Para conferir a cota de solicitações simultâneas do Data Boost:
    1. Na lista, selecione Cota do consumidor > Cota > Uso de cota simultânea e clique em Aplicar.
    2. Clique em + ADICIONAR FILTRO para criar um filtro.
    3. Na lista suspensa Rótulo 1, selecione quota_metric.
    4. No campo de texto Valor 1, insira ou selecione spanner.googleapis.com/data_boost_quota.

  6. Para conferir a cota de solicitações simultâneas do Data Boost em milioperações:

    1. Na lista, selecione Cota do consumidor > Cota > Uso da cota de taxa e clique em Aplicar.
    2. Clique em + ADICIONAR FILTRO para criar um filtro.
    3. Na lista suspensa Rótulo 1, selecione quota_metric.
    4. No campo de texto Valor 1, insira ou selecione spanner.googleapis.com/data_boost_milli_quota.

    O Metrics Explorer mostra um gráfico de linhas do uso de cota por região.

  7. Opcional: em Display, para Widget type, selecione Stacked bar chart.

Monitorar erros e limites de cota

Para monitorar erros de cota devido à cota de solicitações simultâneas do Data Boost, siga estas etapas:

  1. No Metrics Explorer, selecione a métrica Cota do consumidor > Cota > Erro de cota excedida.

  2. Adicione um filtro para quota_metric igual a spanner.googleapis.com/data_boost_quota.

Para monitorar o limite da cota de milli-operações de solicitações simultâneas do Data Boost, siga estas etapas:

  1. No Metrics Explorer, selecione a métrica Cota do consumidor > Cota > Limite de cota.

  2. Adicione um filtro para quota_metric igual a spanner.googleapis.com/data_boost_milli_quota.

Definir um alerta para o uso do Data Boost

É possível criar uma política de alertas que notifica você quando o número de consultas particionadas simultâneas que solicitam o Data Boost (chamadas simultâneas de ExecuteStreamingSQL e StreamingRead) por projeto e por região excede um determinado limite. Para fazer isso, siga estas etapas:

  1. Siga as instruções em Criar políticas de alertas de limite de métrica.
  2. Na lista suspensa Selecionar uma métrica, no campo Filtrar por nome do recurso ou da métrica, digite consumer e pressione Enter para restringir a pesquisa.

  3. Para definir um alerta sobre o uso da cota de solicitações simultâneas do Data Boost:

    1. Na lista Selecionar uma métrica, escolha Cota do consumidor > Cota > Uso de cota simultânea e clique em Aplicar.
    2. Na seção Adicionar filtros, clique em Adicionar um filtro para criar um.
    3. Na lista suspensa Filtro, selecione quota_metric.
    4. No campo de texto Valor, insira ou selecione spanner.googleapis.com/data_boost_quota e clique em Concluído.
    5. Continue criando uma política de alertas e defina o limite como uma porcentagem da cota.

    Por exemplo, se a cota padrão for 200 e você quiser receber uma notificação quando o número de solicitações simultâneas atingir 80% do máximo, insira 160 no campo Valor do limite.

  4. Para definir um alerta sobre o uso da cota de solicitações simultâneas do Data Boost em milioperações:

    1. Na lista Selecionar uma métrica, escolha Cota do consumidor > Cota > Uso da cota de taxa e clique em Aplicar.
    2. Na seção Adicionar filtros, clique em Adicionar um filtro para criar um.
    3. Na lista suspensa Filtro, selecione quota_metric.
    4. No campo de texto Valor, insira ou selecione spanner.googleapis.com/data_boost_milli_quota e clique em Concluído.
    5. Continue criando uma política de alertas e defina o limite como uma porcentagem da cota.

    Por exemplo, se a cota padrão for 1.000.000 e você quiser receber uma notificação quando as milioperações de solicitação atingirem 80% do limite, insira 800.000 no campo Valor do limite.

Processar erros de cota

Se a taxa de erros de cota excedida for alta ao usar o Dataflow com o Data Boost, recomendamos ajustar o número máximo de workers no job do Dataflow para evitar exceder a cota do Data Boost. Você também pode solicitar uma cota maior. Sua carga de trabalho pode ser limitada pela cota de solicitações simultâneas do Data Boost ou pela cota de milioperações. Talvez seja necessário aumentar sua cota de milioperações depois de aumentar a cota de solicitações simultâneas.

Impedir que um principal consuma recursos do Data Boost

Se um principal exceder consistentemente a quantidade de recursos do Data Boost que ele pode consumir, bloqueie o uso desses recursos revogando a permissão spanner.databases.useDataBoost do Identity and Access Management (IAM). É possível automatizar a revogação da permissão configurando o canal de notificação de um alerta como um webhook que invoca uma função do Cloud. Para mais informações, consulte os tópicos a seguir:

A seguir