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 do envio de dados de trace usando a API Telemetry (OTLP) ou a API Cloud Trace. Entender esses limites ajuda a monitorar seu uso para que você não perca a observabilidade dos seus aplicativos.

Cotas e limites da API Trace

Nesta seção, fornecemos informações sobre cotas e limites que se aplicam apenas à API Trace. As cotas e os limites listados nesta seção não se aplicam à API Telemetry.

O Cloud Trace aplica 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 ao Trace.

Cotas

A tabela a seguir resume as unidades de cota disponíveis para operações de leitura e gravação, além da cota diária para ingestão de períodos da API Trace. Por exemplo, você tem um total de 300 por 60 segundos para os três comandos da 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, ListSpan. Uma chamada para ListTraces consome 25 unidades de cota. As chamadas para GetTrace consomem ListSpan 1 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 trace para a API Cloud Trace é determinada pelo histórico da sua conta de faturamento e pelas solicitações 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 período	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 período seja ingerido	14 dias
Carimbo de data/hora futuro máximo para um período ser ingerido	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 na chamada de API com um erro. Por exemplo, um erro não é relatado quando o número de atributos anexados a um período excede 1.024. Em vez disso, nesse cenário, a API Cloud Trace usa um algoritmo não determinístico para selecionar 1.024 atributos para ingestão. Os atributos restantes são descartados.

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

A maneira como você anota 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

Nesta seção, listamos os limites que se aplicam apenas quando a API Telemetry é usada para ingerir dados de trace. A API Telemetry, que implementa a API OTLP do OpenTelemetry, foi projetada 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	Limitado.
Tamanho máximo dos valores de atributo	64 KiB	Limitado.
Tamanho máximo do nome de um objeto `Span`^*	1.024 bytes	Limitado.
Número máximo de atributos anexados a um objeto `Span`^*	1024	Limitado.
Número máximo de atributos de recurso por objeto `ResourceSpans`^*	1024	Limitado.
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	Limitado.
Número máximo de objetos `Event`^* por objeto `Span`^*	256	Limitado.
Número máximo de objetos `Link`^* por objeto `Span`^*	128	Limitado.
Tamanho máximo do nome de um objeto `Event`^*	1.024 bytes	Limitado.
Número máximo de atributos por objeto `Event`^*	1024	Limitado.
Máximo de atributos por objeto `Link`^*	1024	Limitado.
Tamanho máximo dos URLs de esquema	8.192 bytes	Limitado.
Número máximo de bytes de ingestão de trace 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 trace por projeto	100
Número máximo de visualizações por escopo de trace	20

Períodos de armazenamento do Trace

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

Gerenciar sua cota

Nesta seção, descrevemos como solicitar uma alteração em uma cota e como monitorar o uso da cota.

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 a cota usando o console do 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 solicitar uma alteração 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 de cota e receber o erro Edit is not allowed for this quota, entre em contato com o suporte e solicite uma alteração na cota. O faturamento precisa estar ativado no projeto doGoogle Cloud para editar cotas no console do Google Cloud .

Monitorar o uso de cotas

Para garantir que você não fique sem cota e perca a observabilidade do desempenho dos seus apps, verifique se você agrupa as atualizações e monitora o uso da cota. Por exemplo, é possível criar uma política de alertas que notifique você quando o uso exceder 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 de período diário, consulte Como limitar o uso.
Para solicitar 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 trace, 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 limitação de taxa.

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