Monitorar e gerenciar o uso da cota do Data Boost

O Data Boost do Spanner está sujeito a cotas que limitam o número Chamadas ExecuteStreamingSQL e StreamingRead executadas por projeto e por na mesma 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. Em seguida, na lista, selecione DataBoostQuotaPerProjectPerRegion (link em inglês).

  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 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 de recurso ou 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, digite 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 de cota excedida

  2. Adicione um filtro para quota_metric 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 que solicitam o Data Boost (simultâneas chamadas ExecuteStreamingSQL e StreamingRead) por projeto e por região excede um limite específico. Para fazer isso, siga estas etapas:

  1. Siga as instruções Criar políticas de alertas de limite de métrica.
  2. Na lista suspensa Selecione uma métrica, no campo Filtrar por nome de recurso ou 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 > a segunda unidade de processamento e Clique em Aplicar.

  4. Continue criando uma política de alertas e defina o limite para alguns a 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, 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 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.

Impedir que um principal consuma recursos do Data Boost

Se um titular estiver excedendo consistentemente a quantidade de recursos do Data Boost que pode ser razoavelmente esperada, você poderá bloquear o uso de recursos do Data Boost revogando a permissão de gerenciamento de identidade e acesso (IAM) spanner.databases.useDataBoost do titular. É possível revogar automaticamente a 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