Cotas e limites

O Cloud Trace aplica dois tipos diferentes de cotas: uma cota de taxa nas suas solicitações de API e uma cota de ingestão de períodos que você envia ao Trace.

Limites de uso da API Trace

Método de API Unidades de cota totais
GetTrace1
ListTraces2
ListSpan1
300 a cada 60 segundos
PatchTraces1
BatchWriteSpans1
CreateSpan1
4.800 a cada 60 segundos

1 Cada chamada de API consome 1 unidade de cota.
2 Cada chamada de API consome 25 unidades de cota.

Você tem um total de 300 unidades de cota por 60 segundos para os três comandos de API GetTrace, ListTraces e ListSpan. Veja a seguir dois exemplos diferentes de como você poderia usar todas as unidades de cota disponíveis:

  • Faça 12 chamadas de API ListTraces a cada 60 segundos.
  • Faça 10 chamadas de API ListTraces e 50 de GetTrace a cada 60 segundos.

Os outros limites e restrições da API Cloud Trace são:

Restrições e limites Valor
Número máximo de períodos por chamada GetTrace 1.000
Número máximo de períodos por chamada PatchTraces 25.000
Número máximo de traces por chamada ListTraces 1.000 na visualização mínima/ROOTSPAN
100 na visualização COMPLETE
Número máximo de períodos por trace 1.000
Número máximo de bytes por trace 50 MB
Número máximo de rótulos/atributos por período 32
Tamanho de chave por rótulo/atributo 128 bytes
Tamanho de valor por rótulo/atributo 256 bytes

Como solicitar alterações na cota da API Cloud Trace

É possível solicitar limites maiores ou menores da API Cloud Trace usando o console do Google Cloud:

  1. Na página "Cotas", use as caixas de seleção para selecionar API Cloud Trace e clique em Editar cotas.

    Se aparecer um erro Edit is not allowed for this quota, entre em contato com o suporte para solicitar alterações na cota. O faturamento precisa estar ativado no projeto do Google Cloud para que você possa marcar as caixas de seleção.

  2. No painel Alterações de cota, selecione o serviço para expandir a visualização e preencha os campos Novo limite e Descrição da solicitação. Clique em Próxima.

  3. Preencha o formulário no painel Detalhes do contato.

  4. Clique em Enviar solicitação.

Para mais informações, consulte Como trabalhar com reservas.

Limite diário de ingestão de períodos de trace

Sua cota diária de ingestão de períodos de trace é determinada pelo histórico da sua conta de faturamento e pelas consultas que você fez para aumentar a cota. Veja na tabela a seguir o intervalo de alocações de cota:

Categoria Unidades de cota
Períodos ingeridos 3.000.000 a 5.000.000.000 por dia

Qual é a relação entre as cotas e os preços?

Os preços do Cloud Trace são calculados com base na ingestão e verificação do período do Trace. Os dados de latência são empacotados em um trace, que é composto de extensões. Os períodos são ingeridos pelo back-end do Cloud Trace, que disponibiliza os dados para visualização e geração de relatórios em tempo real no console do Google Cloud. Quando você visualiza dados de trace, os períodos armazenados são verificados como parte do processo de recuperação.

As cotas diárias de períodos definem a quantidade máxima de períodos que podem ser ingeridos antes da falha da chamada de API com um erro de recurso esgotado. As cotas de taxa de API definem a quantidade máxima de chamadas de API que podem ser feitas antes da falha da chamada com um erro de recurso esgotado.

Todas as chamadas de API consomem cotas de API. As chamadas de API de gravação também consomem cotas de ingestão diária de períodos. Por exemplo, se você precisar emitir patches para 10.000 períodos, terá duas opções:

  • Enviar uma solicitação patchTraces com os 10.000 períodos.

  • Enviar 10.000 solicitações de patchTraces, cada uma com um período, e distribuí-las ao longo de vários minutos para não atingir os limites de cota da API.

A primeira opção usa uma unidade de cota de API, e a segunda, 10.000 unidades de cotas de API. As duas opções usam 10.000 unidades de cota diária de ingestão de período. O preço das duas opções é o mesmo, porque ele é determinado pelo número de períodos ingeridos, não pelo número de chamadas de API.

Períodos de retenção do Trace

Categoria Período de armazenamento
Todos os dados de período do trace 30 dias
Relatórios de análise 30 dias

Como gerenciar sua cota

Para garantir que você não fique sem cota e não perca visibilidade do desempenho dos aplicativos, verifique periodicamente o uso de sua cota ou crie uma política de alerta. Para informações detalhadas sobre como monitorar suas solicitações de API e entender as respostas, consulte Como monitorar o uso da API.

  • Confira o artigo Como visualizar sua cota e saiba como ver sua cota diária de ingestão de períodos e a cota da API Cloud Trace.

  • Veja Como limitar o uso para reduzir suas unidades de cota de API e de ingestão diária de períodos.

  • Veja Como solicitar mais cota para solicitar um aumento das suas unidades de cota de API ou de ingestão diária de períodos.

  • Veja Como criar um alerta de ultrapassagem de cota para informações detalhadas sobre como criar políticas de alerta a fim de monitorar sua cota da API Trace e sua ingestão de períodos de trace.