O Cloud Trace aplica dois tipos diferentes de cotas: uma cota de taxa nas suas solicitações de API e uma cota de ingestão de períodos que você envia ao Trace.
Cotas de traces
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. 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
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,
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 1 unidade de cota.
3 Sua cota diária de ingestão de períodos de trace é determinada pelo
histórico da conta de faturamento e pelas solicitações que você fez para aumentos de cota.
Limites de trace
Nesta seção, listamos os limites que se aplicam ao usar a API Cloud Trace.
Limites para métodos de API
| Limites para métodos de API | 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 |
Limites de períodos
| Limites de períodos | Valor |
|---|---|
| Tamanho máximo do nome de um período | 128 bytes |
| Número máximo de rótulos ou atributos por período | 32 |
| Tamanho máximo da chave para um rótulo ou atributo | 128 bytes |
| Tamanho máximo de valor para um rótulo ou atributo | 256 bytes |
| Número máximo de eventos por período | 128 |
| Carimbo de data/hora passado máximo de um período a ser ingerido | 14 dias |
| Carimbo de data/hora futuro máximo de um período a ser ingerido | 3 dias |
| Carimbo de data/hora passado máximo do evento relativo ao carimbo de data/hora do período | 365 dias |
É possível anotar períodos criando um objeto attributes e anexando-o ao objeto Span ao usar a API Cloud 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 Cloud Trace v1.
Limites de traces
| Limites de traces | Valor |
|---|---|
| Número máximo de períodos por trace | 1.000 |
| Tamanho máximo do rastro | 50 MB |
Períodos de retenção do Trace
| Categoria | Período de armazenamento |
|---|---|
| Período de dados armazenados pelo Cloud Trace | 30 dias |
| Relatórios de análise | 30 dias |
Gerenciar sua cota
Nesta seção, descrevemos como solicitar uma alteração em uma cota e como monitorar seu uso.
Solicitar alterações na cota da API Cloud Trace
É possível solicitar limites maiores ou menores da API Cloud Trace usando o Console do Google Cloud:
Na página "Cotas" do Console do Google Cloud, use as caixas de seleção para selecionar API Cloud Trace e clique em Editar cotas.
Se aparecer um erro
Edit is not allowed for this quota, entre em contato com o suporte para solicitar alterações na cota. Observe também que o faturamento precisa estar ativado no projeto do Google Cloud para marcar as caixas de seleção.No painel Alterações de cota, selecione o serviço para expandir a visualização e preencha os campos Novo limite e Descrição da solicitação. Clique em Próxima.
Preencha o formulário no painel Detalhes do contato.
Clique em Enviar solicitação.
Para mais informações, consulte Ver e gerenciar cotas.
Monitorar o uso de cotas
Para garantir que você não fique sem cota e perca a observabilidade do desempenho dos aplicativos, agrupe as atualizações em lotes e monitore o uso da cota. Por exemplo, é possível 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 sua API Cloud Trace e suas cotas de ingestão diária de períodos, consulte Ver e gerenciar cotas.
Para saber como reduzir suas unidades de cota de API e de ingestão de período diária, consulte Como limitar o uso.
Para solicitar um aumento das 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.