Para enviar dados de trace ao seu Google Cloud projeto, use a API Telemetry (OTLP) ou a API Cloud Trace. A API Telemetry implementa a API OTLP do OpenTelemetry e oferece maior compatibilidade e suporte ao ecossistema de código aberto do OpenTelemetry. A API Trace é uma API proprietária Google Cloud que antecede o suporte à API Telemetry. Os limites da API Telemetry costumam ser mais generosos do que os da API Trace.
Cotas e limites da API Trace
Esta seção fornece 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 suas solicitações de API Cloud Trace e uma cota de ingestão de 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 e a 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 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
ListTracesa cada 60 segundos. - Faça 10 chamadas de API
ListTracese 50 deGetTracea 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,4 | 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. As chamadas para GetTrace consomem ListSpan 1 unidade de cota. Consultar e visualizar traces
usando o Trace Explorer no Google Cloud console não consome
essa 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 Essa cota se aplica apenas a períodos ingeridos usando a API Cloud Trace.
A ingestão pela API Telemetry é irrestrita.
4 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 MINIMAL100 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 para ingestão de um período | 14 dias |
| Carimbo de data/hora máximo para ingestão de um período | 3 dias |
| Carimbo de data/hora máximo para evento em relação ao carimbo de data/hora do período | 365 dias |
Exceder um limite pode não resultar em uma chamada de API com falha e um erro. Por exemplo, um erro não é informado quando o número de atributos anexados a um período excede 1024. Em vez disso, nesse cenário, a API Cloud Trace usa um algoritmo não determinístico para selecionar 1024 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 como você anota os períodos depende do endpoint de API Cloud Trace. Se você usar o
batchWrite endpoint, adicione atributos ao
Span objeto. Se você usar o
patchTraces endpoint, adicione rótulos ao
TraceSpan objeto.
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 trace. A API Telemetry, que implementa a API OTLP do OpenTelemetry, foi projetada para uso com aplicativos instrumentados usando um dos os 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 Span* objeto |
1024 | Limite. |
Número máximo de atributos de recurso por ResourceSpans* objeto |
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 Link* objetos 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 Event* objeto |
1024 | Limite. |
Atributos máximos por Link* objeto |
1024 | Limite. |
| Tamanho máximo de URLs de esquema | 8192 bytes | Limite. |
| Número máximo de bytes de ingestão de trace por minuto | 2,4 GB para as seguintes regiões: 300 MB para todas as outras regiões. |
Cota. |
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
_Trace bucket |
30 dias |
Gerenciar sua cota
Esta seção descreve como solicitar uma mudança em uma cota e como 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 Google Cloud console, acesse a página Cotas e limites do sistema e pesquise a cota de interesse.
- Se a cota estiver listada, você poderá usar essa página para solicitar uma mudança no limite. Para mais informações sobre essas etapas, consulte Visualizar 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, então entre em contato com o Cloud Customer Care e solicite uma mudança na cota. O faturamento precisa estar ativado no Google Cloud projeto para editar cotas no Google Cloud console.
Monitorar o uso da cota
Para garantir que você não fique sem cota e não perca a observabilidade do desempenho dos aplicativos, verifique se você agrupa suas atualizações e monitora o uso da cota. Por exemplo, você pode criar uma política de alertas que notifica 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 Visualizar e gerenciar cotas.
Para saber como reduzir suas unidades de cota de API e de ingestão diária de períodos, consulte Como limitar o uso.
Para solicitar um aumento nas suas unidades de cota de API ou de ingestão diária 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 são limitadas por taxa.