Para enviar dados de rastreio para o seu Google Cloud projeto, pode usar a API Telemetry (OTLP) ou a API Cloud Trace. A API Telemetry implementa a API OTLP OpenTelemetry e oferece maior compatibilidade e suporte para o ecossistema OpenTelemetry de código aberto. A API Trace é uma API Google Cloud proprietária que antecede o suporte para a API Telemetry. Os limites da API Telemetry são frequentemente mais generosos do que os da API Trace.
Quotas e limites da API Trace
Esta secção fornece informações sobre quotas e limites que se aplicam apenas à API Trace. As quotas e os limites indicados nesta secção não se aplicam à API Telemetry.
O Cloud Trace aplica dois tipos diferentes de quotas: uma quota de taxa nos seus pedidos da API Cloud Trace e uma quota de carregamento em intervalos que envia para o Trace.
Quotas
A tabela seguinte resume as unidades de quota disponíveis para operações de leitura e escrita, e a quota diária para carregar intervalos para a API Trace. Por exemplo, tem um total de 300 por 60 segundos para os três comandos da API GetTrace, ListTraces e ListSpan. Seguem-se dois exemplos diferentes de como pode usar todas as unidades de quota disponíveis:
- Fazer 12 chamadas à API
ListTracespor cada 60 segundos. - Fazer 10 chamadas API
ListTracese 50 chamadas APIGetTracepor 60 segundos.
| Categoria | Total de unidades de quota |
|---|---|
| Operações de leitura1 | 300 por 60 segundos |
| Operações de escrita2 | 4800 por 60 segundos |
| Intervalos carregados3 | 3 000 000 por dia – 5 000 000 000 por dia |
1 As operações de leitura incluem GetTrace, ListTraces,
ListSpan. Uma chamada para ListTraces consome 25 unidades de quota. As chamadas para
GetTrace consomem ListSpan 1 unidade de quota.
2 As operações de escrita incluem PatchTraces, BatchWrite e CreateSpan. Cada operação de escrita consome 1 unidade de quota.
3 A sua quota diária de carregamento de intervalos de rastreio é determinada pelo
histórico da conta de faturação e pelos pedidos que fez para aumentos da quota.
Limites
Esta tabela apresenta os limites da Cloud Trace API.
| Descrição | Valor |
|---|---|
Número máximo de intervalos por chamada GetTrace |
1000 |
Número máximo de intervalos por chamada PatchTraces |
25 000 |
Número máximo de rastreios por chamada ListTraces |
1000 nas visualizações ROOTSPAN e MINIMAL100 na visualização COMPLETE |
| Número máximo de intervalos por rastreio | 1000 |
| Tamanho máximo do rastreio | 50 MB |
| Comprimento máximo de um nome de intervalo | 128 bytes |
| Número máximo de etiquetas ou atributos por intervalo | 32 |
| Tamanho máximo da chave para uma etiqueta ou um atributo | 128 bytes |
| Tamanho máximo do valor de uma etiqueta ou um atributo | 256 bytes |
| Número máximo de eventos por intervalo | 128 |
| Data/hora máxima anterior para ingestão de um intervalo | 14 dias |
| Data/hora máxima futura para a ingestão de um intervalo | 3 dias |
| Data/hora máxima anterior para o evento relativamente à data/hora do intervalo | 365 dias |
Exceder um limite pode não resultar numa chamada à API que falhe com um erro. Por exemplo, não é comunicado um erro quando o número de atributos anexados a um intervalo excede 32. Em alternativa, neste cenário, a API Cloud Trace usa um algoritmo não determinístico para selecionar 32 atributos a carregar. Os restantes atributos são rejeitados.
A API Cloud Trace fornece detalhes sobre os pontos finais GetTrace, PatchTraces e ListTraces.
A forma como anota os intervalos depende do ponto final da Cloud Trace API. Se usar o ponto final
batchWrite, adicione atributos ao objeto
Span. Se usar o ponto final patchTraces, adicione etiquetas ao objeto TraceSpan.
Limites da API Telemetry
Esta secção apresenta os limites que se aplicam apenas quando a API Telemetry é usada para carregar dados de rastreio. A API Telemetry, que implementa a API OTLP OpenTelemetry, foi concebida para utilização com aplicações que são instrumentadas através de um dos SDKs OpenTelemetry. Os limites indicados nesta secção não se aplicam à API Cloud Trace.
| Descrição | Valor |
|---|---|
| Tamanho máximo das chaves de atributos | 512 bytes |
| Tamanho máximo dos valores dos atributos | 64 KiB |
Tamanho máximo do nome de um objeto Span* |
1024 bytes |
Número máximo de atributos anexados a um objeto Span* |
1024 |
Número máximo de atributos de recursos por objeto ResourceSpans* |
1024 |
Número máximo de atributos por objeto ResourceSpan*Inclui atributos anexados a objetos secundários dos seguintes tipos: Resource, Span, ScopeSpans,
Event e Link. |
8192 |
Número máximo de objetos Event* por objeto Span* |
256 |
Número máximo de objetos Link* por objeto Span* |
128 |
Tamanho máximo do nome de um objeto Event* |
1024 bytes |
Número máximo de atributos por objeto Event* |
1024 |
Atributos máximos por objeto Link* |
1024 |
| Tamanho máximo dos URLs de esquemas | 8192 bytes |
trace.proto.
Limites nos âmbitos de rastreio
| Limites nos âmbitos de rastreio | Valor |
|---|---|
| Número máximo de âmbitos de rastreio por projeto | 100 |
| Número máximo de projetos por âmbito de rastreio | 20 |
Períodos de retenção de rastreios
| Categoria | Período de retenção |
|---|---|
| Abranja dados armazenados pelo Cloud Trace | 30 dias |
Faça a gestão da sua quota
Esta secção descreve como pedir uma alteração numa quota e como monitorizar a utilização da quota.
Solicite alterações à quota da Cloud Trace API
Pode pedir limites da API Cloud Trace mais elevados ou mais baixos através da Google Cloud consola. Para mais informações, consulte o artigo Veja e faça a gestão das quotas.
Se receber um erro Edit is not allowed for this quota, pode
contactar o apoio técnico para solicitar alterações à
quota. Tenha também em atenção que a faturação tem de estar ativada no
Google Cloud projeto para clicar nas caixas de verificação.
Monitorize a utilização da sua quota
Para garantir que não esgota a quota e perde a observabilidade do desempenho das suas apps, certifique-se de que agrupa as atualizações e monitoriza a utilização da quota. Por exemplo, pode criar uma política de alertas que lhe envia uma notificação quando a sua utilização excede um limite. Para ver informações detalhadas sobre a monitorização dos pedidos da API e a compreensão das respetivas respostas, consulte o artigo Monitorizar a utilização da API.
Para ver a sua API Cloud Trace e as quotas de carregamento de intervalos diárias, consulte o artigo Veja e faça a gestão das quotas.
Para saber como diminuir as unidades da quota da API e as unidades da quota de carregamento do intervalo diário, consulte o artigo Limitar a utilização.
Para pedir um aumento das unidades da quota da API ou das quotas de carregamento de intervalos diários, consulte o artigo Peça mais quota.
Consulte o artigo Criar um alerta de excesso de quota para ver informações detalhadas sobre a criação de políticas de alerta para monitorizar a sua quota da API Trace e a ingestão de intervalos de rastreio de taxa.