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 ExecuteStreamingSQL e StreamingRead simultâneas 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.

    Acesse Cotas

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

  3. Na tabela resultante, localize sua região e veja 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 for exibido 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. Na lista, selecione Cota do consumidor > Cota > Uso de cota simultânea 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, insira ou selecione spanner.googleapis.com/data_boost_quota.

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

  9. Opcional: em Exibição, em 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 na cota excedida.

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

Definir um alerta de uso do Data Boost

É possível criar uma política de alertas que notifica 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étricas.
  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, escolha Instância do Cloud Spanner > Instância > Unidade de processamento secundária e clique em Aplicar.

  4. Continue criando uma política de alertas e defina o limite para uma porcentagem da cota.

    Por exemplo, se a cota padrão for 200 e você quiser ser notificado quando o número de solicitações simultâneas atingir 80% do máximo, insira 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 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.

Bloquear o consumo de recursos do Data Boost por um principal

Se um principal exceder constantemente a quantidade de recursos do Data Boost que se espera que sejam consumidos, é 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. 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