Para enviar dados de trace ao seu projeto do Google Cloud, use a API Telemetry (OTLP) ou a API Cloud Trace. A API de telemetria 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 Google Cloud proprietary que é anterior ao suporte à API Telemetry. Os limites da API Telemetry geralmente são 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 da 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 | 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.
2 As operações de gravação incluem PatchTraces, BatchWrite
e CreateSpan. Cada operação de gravação consome uma unidade de cota.
3 Sua cota diária de ingestão de períodos de trace é determinada pelo histórico da sua conta de faturamento e pelas consultas que você fez para aumentar a cota.
Limites
| Descrição | 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 MINIMAL100 na visualização COMPLETE |
| Número máximo de períodos por trace | 1.000 |
| Tamanho máximo do rastro | 50 MB |
| Tamanho máximo de um nome de span | 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 máximo do passado para que um período seja transferido | 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 Trace v2 batchWrite. Da mesma forma, é possível anotar períodos
criando um objeto labels e anexando-o ao objeto
TraceSpan ao usar o
método patchTraces da API Trace v1.
Limites 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 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 |
|---|---|
| Tamanho máximo das chaves de atributo | 512 bytes |
| Tamanho máximo dos valores de atributos | 64 KiB |
Tamanho máximo do nome de um objeto Span* |
1.024 bytes |
Número máximo de atributos anexados a um objeto Span* |
1024 |
Número máximo de atributos de recurso por objeto ResourceSpans* |
1024 |
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 |
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* |
1.024 bytes |
Número máximo de atributos por objeto Event* |
1024 |
Atributos máximos por objeto Link* |
1024 |
| Tamanho máximo dos URLs de esquema | 8.192 bytes |
trace.proto do OpenTelemetry.
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 projetos por escopo do trace | 20 |
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 precisa estar ativado no
projeto do Google Cloud para que você possa clicar nas caixas de seleção.
Monitorar o uso de cotas
Para garantir que você não fique sem cota e não perca visibilidade do desempenho dos apps, faça o agrupamento de atualizações e monitore o uso da cota. Por exemplo, você pode criar uma política de alertas que notifique 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 suas 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 das suas unidades de cota de API ou das cotas 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.