Cotas e limites

Nesta página, você verá detalhes sobre os limites que se aplicam ao uso do Cloud Logging.

Para entender sua cota mensal de armazenamento do Logging, consulte o resumo de preços do Cloud Logging.

Para informações detalhadas sobre os 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 de 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
Fanout de consulta4 200 buckets
Número de coletores 200 por projeto do Google 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 Google 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 antigo que pode ser armazenado em buckets de registros6 30 dias no passado
Carimbo de data/hora futuro que pode ser armazenado em buckets de registros6 Até 1 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 Google Cloud em uma organização, poderá configurar até 200 coletores para cada projeto do Google 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 dos buckets de registro. A API Logging aceita entradas com carimbos de data/hora mais antigos, e essas entradas podem ser roteadas para destinos do coletor, mas não armazenadas no armazenamento de registros. A API Logging rejeita entradas com carimbos de data/hora com 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 de acompanhamento ao vivo abertas 10 por projeto do Google Cloud3
Número de entradas de acompanhamento em tempo real 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 entries.write solicitações 120.000 por minuto em cada projeto do Google Cloud1, 3
Número de entries.list solicitações 60 por minuto em cada projeto do Google Cloud2, 3
Número de nomes de recursos diferentes em um único comando entries.write4 1000
Solicitações de controle5 por minuto 600
Solicitações de controle5 por dia 1.000 por projeto do Google Cloud
Número de projetos do Google 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 Google Cloud3
Taxa de exportações para um tópico do Pub/Sub6 1 GB por segundo por projeto do Google Cloud

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 O campo logName de uma entrada de registro especifica o nome do recurso dessa entrada.

5 A cota de solicitações de controle diárias se aplica às solicitações de API para criação e atualização de exclusões e coletores. A cota de solicitação de controle por minuto se aplica a tudo que também está incluído na cota diária de solicitações de controle, além das solicitações de API para exclusão de registros e gerenciamento de métricas com base em registros.

6 Se a taxa de exportações exceder a cota, o erro será registrado em uma entrada de registro. O campo de resumo indica um erro de configuração do coletor, e o código do erro é listado como topic_over_quota.

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:

  1. Na página "Cotas", use as caixas de seleção para selecionar API Cloud Logging 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. O faturamento precisa estar ativado no projeto do Google Cloud para que você possa marcar as caixas de seleção.

  2. 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.

  3. Preencha o formulário no painel Detalhes do contato.

  4. Clique em Enviar solicitação.

Para mais informações, consulte Como trabalhar com reservas.

Otimize o uso do entries.list

O uso esperado de entries.list é pesquisar registros correspondentes. Esse método não se destina à recuperação em alto volume de entradas de registro. Se você estiver esgotando sua cota entries.list regularmente, considere as seguintes opções:

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. Com exceção do 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 Google Cloud2
Número de séries temporais ativas1 30.000 por métrica
Número de buckets de histograma 200 por métrica de distribuição personalizada
Retenção de dados Consulte Cloud Monitoring: retenção de dados

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.