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.

Cotas de trace

A tabela a seguir resume as unidades de cota disponíveis para leitura e gravação operações e a cota diária para ingestão de períodos. Por exemplo, você tem um total de 300 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.
Categoria Unidades de cota totais
Operações de leitura1 300 a cada 60 segundos
Operações de gravação2 4.800 a cada 60 segundos
Períodos ingeridos3 3.000.000 a 5.000.000.000 por dia

1 As operações de leitura incluem GetTrace, ListTraces e ListSpan. Uma chamada para ListTraces consome 25 unidades de cota. Chamadas para GetTrace consome ListSpan 1 unidade de cota.
2 As operações de gravação incluem PatchTraces, BatchWrite, e CreateSpan. Cada operação de gravação consome 1 unidade de cota.
3 Sua cota diária de ingestão de períodos de trace é determinada pelo seu histórico da conta de faturamento e as solicitações que você fez para aumentar a cota.

Limites de traces

Esta seção lista os limites que se aplicam ao uso da API Cloud Trace.

Limites para métodos de API

Limites para métodos de API 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 nas visualizações ROOTSPAN e MINIMAL
100 na visualização COMPLETE

Limites de spans

Limites de spans Valor
Tamanho máximo de um nome de período 128 bytes
Número máximo de rótulos ou atributos por período 32
Tamanho máximo da chave de um rótulo ou atributo 128 bytes
Tamanho máximo do valor de um rótulo ou atributo 256 bytes
Número máximo de eventos por período 128
Carimbo de data/hora passado máximo para um período ser ingerido 14 dias
Carimbo de data/hora futuro máximo para que um período seja transferido 3 dias
Carimbo de data/hora máximo do passado para o evento em relação ao carimbo de data/hora da duração 365 dias

É possível anotar períodos criando um objeto attributes e anexando-o ao objeto Span ao usar a API Cloud Trace v2 batchWrite. Da mesma forma, é possível anotar períodos criando um objeto labels e anexando-o ao objeto TraceSpan quando você usa o Método patchTraces da API Cloud Trace v1.

Limites de traces

Limites de rastros Valor
Número máximo de períodos por trace 1.000
Tamanho máximo do trace 50 MB

Períodos de armazenamento do Trace

Categoria Período de armazenamento
Dados de período armazenados pelo Cloud Trace 30 dias
Relatórios de análise 30 dias

Gerenciar sua cota

Esta seção descreve como solicitar uma mudança na cota e como monitorar o uso dela.

Solicitar mudanças na cota da API Cloud Trace

É possível solicitar limites maiores ou menores da API Cloud Trace usando o Console do Google Cloud. Para mais informações, consulte Ver e gerenciar 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 deve estar ativado no projeto do Google Cloud para marcar as caixas de seleção.

Monitorar o uso da cota

Para não ficar sem cota e perder a capacidade de observação apps o desempenho, não se esqueça de agrupar as atualizações e monitorar e cotas, Por exemplo, é possível criar uma política de alertas que notifica quando seu uso excede um limite. Para informações detalhadas sobre como monitorar suas solicitações de API e entender as respostas, consulte Como monitorar o uso da API.

  • Para conferir a API Cloud Trace e suas cotas diárias de ingestão de períodos, consulte Visualizar e gerenciar cotas.

  • Para saber como diminuir suas unidades de cota de API e seu período diário de cotas de ingestão de dados, consulte Como limitar o uso.

  • Solicitar um aumento na sua cota de API ou suas cotas diárias de ingestão de períodos, consulte Solicite mais cota.

  • 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.