Monitorar e gerenciar o uso da cota do Data Boost

O Data Boost do Spanner está sujeito a cotas que limitam o número de chamadas simultâneas ExecuteStreamingSQL e StreamingRead em execução 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 seguintes opções:

    • DataBoostQuotaPerProjectPerRegion para conferir a cota de solicitações simultâneas do Data Boost.
    • DataBoostMilliQuotaPerProjectPerRegion para ver 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 de cotas

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 da cota por região.

  7. Opcional: em Exibição, para Tipo de widget, selecione Gráfico de barras empilhadas.

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 milioperaçõ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 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, selecione Cota do consumidor > Cota > Uso simultâneo da cota e clique em Aplicar.
    2. Na seção Adicionar filtros, clique em Adicionar um filtro para criar um filtro.
    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 milioperações de solicitações simultâneas do Data Boost:

    1. Na lista Selecionar uma métrica, selecione 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 filtro.
    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 1000000 e você quiser receber uma notificação quando as milioperações de solicitação atingirem 80% do limite, insira 800000 no campo Valor do limite.

Tratar erros de cota

Se a taxa de erros de cota excedida for alta, ao usar o Dataflow com o Data Boost, recomendamos que você ajuste o número máximo de workers no job do Dataflow para evitar exceder a cota do Data Boost. Também é possível 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.

Bloquear um principal de consumir recursos do Data Boost

Se um principal estiver excedendo consistentemente a quantidade de recursos do Data Boost que ele pode consumir, é possível impedir que ele use os recursos do Data Boost revogando a permissão spanner.databases.useDataBoost do Identity and Access Management (IAM) do principal. É 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