Nesta página, você verá detalhes sobre os limites que se aplicam ao uso do Cloud Logging.
Para entender sua cota mensal para ingestão e armazenamento do Logging, consulte o resumo de preços do Cloud Logging.
Para informações detalhadas sobre preços do Logging, consulte Preços do pacote de operações do Google Cloud: Cloud Logging.
Limites de uso do Logging
Os limites a seguir se aplicam ao uso do Cloud Logging. Com exceção dos limites no número de buckets e coletores de registros, esses limites são fixos. Não é possível aumentá-los ou diminuí-los.
| Categoria | Valor máximo |
|---|---|
| Tamanho de uma entrada de registro | 256 KB1 |
| Tamanho de uma entrada de registro de auditoria | 512 KiB |
| Número de rótulos | 64 por entrada de registro |
| Comprimento de uma chave de rótulo de entrada de registro | 512 B2 |
| Comprimento de um valor de rótulo de entrada de registro | 64 KB2 |
| Comprimento de uma consulta | 20.000 caracteres |
| Distribuição de consultas4 | 200 buckets |
| Número de coletores | 200 por projeto do Cloud3 |
| Comprimento de um filtro de inclusão de coletor | 20.000 caracteres |
| Comprimento de um filtro de exclusão de coletor | 20.000 caracteres |
| Número de filtros de exclusão | 50 por coletor |
| Número de buckets de registros | 100 por projeto do Cloud3,4,5 |
| Número de campos indexados personalizados | 20 por bucket de registros |
| Número de visualizações de registro | 30 por bucket de registros |
| Carimbo de data/hora mais recente ingerido em buckets de registro6 | 30 dias atrás |
| O carimbo de data/hora futuro pode ser ingerido em buckets de registro6 | Até um dia no futuro |
1 Esse limite aproximado tem como base o tamanho de dados internos, e não o tamanho real da solicitação da API REST.
2 O Cloud Logging trunca valores e chaves de rótulo muito grandes quando a entrada de registro associada é gravada.
3 Esse limite também se aplica a contas de faturamento, pastas e organizações e não é hierárquico. Por exemplo, se você tiver vários projetos do Cloud em uma organização, poderá configurar até 200 coletores para cada projeto do Cloud. Para essa mesma organização, também é possível configurar até 200 coletores no nível da organização.
4 Esse limite é o número máximo de buckets que podem conter entradas de registro para um recurso. Para mais informações, consulte A consulta retorna um erro.
5 Esse limite inclui buckets com exclusão pendente.
6 As entradas de registro com carimbos de data/hora fora desses limites são rejeitadas nos buckets de registros. A API Logging aceita entradas com carimbos de data/hora
anteriores. Essas entradas podem ser roteadas para destinos de coletor, mas não
armazenadas no armazenamento de registros. A API Logging rejeita entradas com carimbos de data/hora
mais de um dia no futuro e retorna um
erro INVALID_ARGUMENT.
Cotas e limites da API Logging
Os limites a seguir se aplicam ao uso da API Logging. É possível solicitar alterações nas cotas e limites da API Logging. Para instruções, consulte Como solicitar alterações na cota da API Cloud Logging nesta página.
| Categoria | Valor máximo |
|---|---|
| Uso da API | Para ver suas cotas, acesse o painel de APIs. Clique em uma API e selecione Cotas. |
| Ciclo de vida dos tokens de página da API | 24 horas |
| Número de sessões abertas de acompanhamento ao vivo | 10 por projeto do Cloud3 |
| Número de entradas de cauda ativa retornadas | 60.000 por minuto |
| Número de campos restritos | 20 por bucket |
| Tamanho de um campo restrito | 800 B |
| Tamanho de uma solicitação entries.write | 10 MB |
| Número de solicitações Entries.write | 120.000 por minuto, por projeto do Cloud1, 3 |
| Número de solicitações Entries.list | 60 por minuto, por projeto do Cloud2, 3 |
| Solicitações de controle4 por minuto | 600 |
| Solicitações de controle4 por dia | 1.000 por projeto do Cloud |
| Número de projetos do Cloud ou outros nomes de recursos em uma única solicitação Entries.list | 100 |
| Número de operações de cópia simultâneas | 1 por projeto do Cloud3 |
1 O uso de filtros de exclusão não reduz esse número porque os registros são excluídos depois que a solicitação Entries.write é feita.
2Esse valor é a configuração padrão.
3 Esse limite também se aplica a contas de faturamento, pastas e organizações e não é hierárquico.
4 A cota de solicitação de controle diária se aplica às solicitações de API para criar e atualizar exclusões e coletores. A cota de solicitação de controle por minuto se aplica a tudo que também é incluído na cota diária de solicitação de controle, além de solicitações de API para excluir registros e gerenciar métricas com base em registros.
Como solicitar alterações na cota da API Cloud Logging
É possível solicitar limites maiores ou menores da API Logging usando o console do Google Cloud:
Na página Cotas, use as caixas de seleção para selecionar API Cloud Logging e, em seguida, 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 Cloud para clicar nas 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 Como trabalhar com reservas.
Otimizar o uso do entries.list
O uso esperado de Entries.list é para pesquisar registros correspondentes. Se
você estiver esgotando sua cota entries.list regularmente, consulte
Ler e listar registros de forma eficiente para
dicas sobre como otimizar seu uso.
Métricas com base em registros
Os limites a seguir se aplicam ao uso de métricas com base em registros definidas pelo usuário. Exceto pelo número de descritores de métrica, esses limites são fixos. Não é possível aumentá-los ou diminuí-los.
| Categoria | Valor máximo |
|---|---|
| Número de rótulos | 10 por métrica |
| Comprimento do valor do rótulo | 1.024 B |
| Comprimento da descrição do rótulo | 800 B |
| Comprimento de um filtro | 20.000 caracteres |
| Tamanho dos descritores de métrica | 8.000 B |
| Número de descritores de métrica | 500 por projeto do Cloud2 |
| Número de séries temporais1 | 30.000 por métrica |
| Número de buckets de histograma | 200 por métrica de distribuição personalizada |
1 Uma série temporal ficará ativa se você tiver gravado pontos de dados nela nas últimas 24 horas.
2 Esse limite também se aplica a contas de faturamento, pastas e organizações e não é hierárquico.
Períodos de armazenamento de registros
Os períodos de armazenamento do Cloud Logging a seguir se aplicam aos buckets de registro, independentemente dos tipos de registros incluídos ou se foram copiados de outro local. As informações de retenção são as seguintes:
| Bucket de registro | Período de armazenamento padrão | Armazenamento personalizado |
|---|---|---|
_Required |
400 dias | Não configurável |
_Default |
30 dias | Configurável |
| Definido pelo usuário | 30 dias | Configurável |
Para _Default e os buckets de registros definidos pelo usuário, configure o Cloud Logging para reter seus registros por um período entre 1 e 3.650 dias. Para mais informações sobre como definir regras de retenção, consulte Configurar a retenção personalizada.