O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Cotas e limites

O Cloud Trace aplica cotas de taxa, limites de ingestão de períodos e períodos de retenção de dados que dependem da API usada para enviar dados de rastreamento ao projeto Google Cloud : a API Telemetry (OTLP) ou a API Cloud Trace. A API Telemetry implementa a especificação OTLP do OpenTelemetry e oferece maior compatibilidade com o ecossistema de código aberto OpenTelemetry.

Cotas e limites da API Trace

Esta seção fornece informações sobre cotas e limites que se aplicam somente à API Trace. As cotas e os limites listados nesta seção não se aplicam à API Telemetry.

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

Cotas

A tabela a seguir resume as unidades de cota disponíveis para operações de leitura e gravação e a cota diária para ingestão de intervalos da API Trace. Por exemplo, você tem um total de 300 a cada 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 leitura¹	300 a cada 60 segundos
Operações de gravação²	4.800 a cada 60 segundos
Períodos ingeridos^3,4	3.000.000 a 5.000.000.000 por dia

¹ As operações de leitura incluem GetTrace, ListTraces e ListSpan. Uma chamada para ListTraces consome 25 unidades de cota. As chamadas para GetTrace consomem ListSpan uma unidade de cota. Consultar e visualizar traces usando o Trace Explorer no console do Google Cloud não consome essa cota.
² As operações de gravação incluem PatchTraces, BatchWrite e CreateSpan. Cada operação de gravação consome uma unidade de cota.
³ Essa cota se aplica apenas a períodos ingeridos usando a API Cloud Trace. A ingestão pela API Telemetry não tem restrições. ⁴ Sua cota diária de ingestão de períodos de rastreamento da API Cloud Trace é determinada pelo histórico da sua conta de faturamento e pelos pedidos de aumento de cota que você fez.

Limites

Esta tabela lista os limites da API Cloud Trace.

Descrição	Valor
Número máximo de períodos por chamada `GetTrace`	10.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`
Tamanho máximo de um nome de período	1.024 bytes
Número máximo de rótulos ou atributos por intervalo	1024
Tamanho máximo da chave de um rótulo ou atributo	512 bytes
Tamanho máximo do valor de um rótulo ou atributo	65.532 bytes
Número máximo de eventos por período	256
Carimbo de data/hora máximo no passado para que um intervalo seja ingerido	14 dias
Carimbo de data/hora futuro máximo para ingestão de um período	3 dias
Carimbo de data/hora máximo do evento em relação ao carimbo de data/hora do período	365 dias

Exceder um limite pode não resultar em uma falha de chamada de API com um erro. Por exemplo, um erro não é informado quando o número de atributos anexados a um período excede 1.024. Em vez disso, neste cenário, a API Cloud Trace usa um algoritmo não determinístico para selecionar 1.024 atributos a serem ingeridos. Os atributos restantes são descartados.

A API Cloud Trace fornece detalhes sobre os endpoints GetTrace, PatchTraces e ListTraces.

A forma de anotar períodos depende do endpoint de API Cloud Trace. Se você usar o endpoint batchWrite, adicione atributos ao objeto Span. Se você usar o endpoint patchTraces, adicione rótulos ao objeto TraceSpan.

Limites e cotas da API Telemetry

Esta seção lista os limites que se aplicam apenas quando a API Telemetry é usada para ingerir dados de rastreamento. A API Telemetry, que implementa a API OTLP do OpenTelemetry, foi criada para uso com aplicativos instrumentados usando um dos SDKs do OpenTelemetry. Os limites listados nesta seção não se aplicam à API Cloud Trace.

Descrição	Valor	Observação
Tamanho máximo das chaves de atributo	512 bytes	Limite.
Tamanho máximo dos valores de atributo	64 KiB	Limite.
Tamanho máximo do nome de um objeto `Span`^*	1.024 bytes	Limite.
Número máximo de atributos anexados a um objeto `Span`^*	1024	Limite.
Número máximo de atributos de recurso por objeto `ResourceSpans`^*	1024	Limite.
Número máximo de atributos por objeto `ResourceSpan`^* Inclui atributos anexados a objetos filhos dos seguintes tipos: `Resource`, `Span`, `ScopeSpans`, `Event` e `Link.`	8192	Limite.
Número máximo de objetos `Event`^* por objeto `Span`^*	256	Limite.
Número máximo de objetos `Link`^* por objeto `Span`^*	128	Limite.
Tamanho máximo do nome de um objeto `Event`^*	1.024 bytes	Limite.
Número máximo de atributos por objeto `Event`^*	1024	Limite.
Número máximo de atributos por objeto `Link`^*	1024	Limite.
Tamanho máximo dos URLs de esquema	8.192 bytes	Limite.
Número máximo de bytes de ingestão de rastreamento por minuto	2,4 GB para as seguintes regiões: `asia-east1, asia-northeast1, asia-southeast1, asia-south1, europe-west1, europe-west2, europe-west3, europe-west4, us-central1, us-east4, us-west1`. 300 MB para todas as outras regiões.	Cota.

^* Para uma definição dessa estrutura, consulte o arquivo trace.proto.

Limites nos escopos de trace

Limites nos escopos de trace	Valor
Número máximo de escopos de rastreamento por projeto	100
Número máximo de visualizações por escopo de rastreamento	20

Períodos de armazenamento do Trace

Categoria	Período de armazenamento
Intervalos armazenados no bucket `_Trace`	30 dias

Gerenciar sua cota

Nesta seção, descrevemos como solicitar uma mudança em uma cota e monitorar o uso dela.

Solicitar mudanças nas cotas da API Cloud Trace

Para determinar se é possível solicitar um limite maior ou menor da API Cloud Trace para cota usando o console Google Cloud , acesse a página Cotas e limites do sistema e pesquise a cota de interesse.

Se a cota estiver listada, use essa página para pedir uma mudança no limite. Para mais informações sobre essas etapas, consulte Ver e gerenciar cotas.

Se a cota não estiver listada ou se você solicitar uma atualização e receber o erro Edit is not allowed for this quota, entre em contato com o Cloud Customer Care e peça uma mudança na cota. O faturamento precisa estar ativado no projetoGoogle Cloud para editar cotas no console Google Cloud .

Monitorar o uso da cota

Para não ficar sem cota e perder a observabilidade da performance dos seus apps, verifique se você está agrupando as atualizações e monitorando o uso da cota. Por exemplo, é possível criar uma política de alertas que notifica você quando o 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 as cotas diárias de ingestão de períodos, consulte Ver e gerenciar cotas.
Para saber como diminuir as unidades de cota da API e as unidades de cota de ingestão diária de períodos, consulte Como limitar o uso.
Para pedir um aumento nas unidades de cota da API ou nas cotas diárias de ingestão de períodos, consulte Solicitar 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.

Consultas de alto volume

Para consultas de alto volume dos dados de rastreamento, crie um conjunto de dados vinculado do BigQuery e use a API BigQuery.

Não use a API Cloud Trace para consultas de alto volume, porque as chamadas para a API Trace têm limite de taxa.

Cotas e limites Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.