Monitorar e gerenciar o uso de cotas do Data Boost

O Spanner Data Boost 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, elas 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.

    Acesse Cotas

  2. No campo Filtro, digite databoost. Em seguida, na lista, selecione DataBoostQuotaPerProjectPerRegion.

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

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. Selecione a opção Metrics Explorer se ela aparecer no menu de navegaçã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. Na lista, selecione Cota do consumidor > Cota > Uso simultâneo da cota e clique em Aplicar.
  6. Clique em + ADICIONAR FILTRO para criar um filtro.
  7. Na lista suspensa Rótulo 1, selecione quota_metric.

  8. No campo de texto Valor 1, digite ou selecione spanner.googleapis.com/data_boost_quota.

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

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

Monitorar erros de cota

Para monitorar erros de cota, 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.

Definir um alerta para o uso do Data Boost

É possível criar uma política de alertas que notifique quando o número de consultas particionadas simultâneas que solicitam o Data Boost (chamadas ExecuteStreamingSQL e StreamingRead simultâneas) por projeto e por região exceder um limite específico. 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 data_boost e pressione Enter para restringir a pesquisa.
  3. Na lista Selecionar uma métrica, selecione Instância do Cloud Spanner > Instância > Unidade de processamento, segundo e, em seguida, clique em Aplicar.

  4. 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, digite 160 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 que você ajuste o número máximo de workers no job do Dataflow para evitar exceder a cota do Data Boost. Você também pode se inscrever para uma cota maior.

Impedir que um principal consuma recursos do Data Boost

Se um principal exceder consistentemente a quantidade de recursos do Data Boost que pode ser razoavelmente esperado para ele, impeça que ele use esses recursos revogando a permissão do Identity and Access Management (IAM) spanner.databases.useDataBoost do principal. Para automatizar a revogação da permissão, configure 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