Cotas e limites

Nesta página, você verá detalhes sobre os limites que se aplicam ao uso do 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 gravadores de registros, esses limites são fixos. Não é possível aumentá-los ou diminuí-los.

Categoria Valor máximo
Tamanho de um LogEntry 256 KB1
Tamanho de uma entrada de registro de auditoria 512 KiB
Número de rótulos 64 por LogEntry
Comprimento de uma chave de rótulo LogEntry 512 B2
Comprimento de um valor de rótulo LogEntry 64 KB2
Comprimento de uma consulta da linguagem de consulta do Logging 20.000 caracteres
Fanout de consulta4 200 buckets
Número de coletores 200 por Google Cloud projeto3
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 Google Cloud projeto3,4,5
Número de campos indexados personalizados 20 por bucket de registro
Número de visualizações de registro 30 por bucket de registro
Carimbo de data/hora mais antigo que pode ser armazenado em buckets de registro6 Determinado pelo período de retenção padrão do bucket de registros. Para um bucket de registros personalizado com o período de retenção padrão, esse valor é de 30 dias atrás.
Carimbo de data/hora futuro que pode ser armazenado em buckets de registros6 Até 1 dia no futuro
Número de escopos de registros por recurso 100
Número de visualizações de registros e projetos incluídos em um escopo de registro 100
Número de projetos incluídos em um escopo de registro 5
Número máximo de vistas do Google Analytics por Google Cloud projeto7 100
Por Google Cloud projeto, o número máximo de visualizações de análise por região é 7 50
Por Google Cloud projeto, o número máximo de regiões que podem armazenar visualizações de análise7 10

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 doGoogle 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 que estão com exclusão pendente.
6 As entradas de registro com carimbos de data/hora fora desses limites são rejeitadas dos buckets de registros. A API Logging aceita entradas com carimbos de data/hora mais antigos, e essas entradas podem ser encaminhadas para destinos de coletores, 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.
7Esse recurso está em pré-lançamento público.

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, selecione uma API e, em seguida, 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 Google Cloud projeto3
Número de entradas de acompanhamento ao vivo 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 de entries.write
Cota sendo substituída. Para mais informações, consulte Cotas de ingestão por região		 120.000 por minuto, por projeto do Google Cloud 1, 3;
ilimitado após 4 de agosto de 2025;
cota removida após 11 de agosto de 2025
Taxa de solicitações de entries.write, por região
Cotas sendo adicionadas. Para mais informações, consulte Cotas de ingestão por região		 4,8 GB por minuto, por projeto Google Cloud , nas regiões asia-east1, asia-northeast1, asia-southeast1, asia-south1, europe-west1, europe-west2, europe-west3, europe-west4, us-central1, us-east4, us-west1 1, 3

300 MB por minuto, por projeto Google Cloud , em todas as regiões restantes1, 3
Número de solicitações entries.list 60 por minuto, por Google Cloud projeto2, 3
Número de nomes de recursos diferentes em um único comando entries.write
4		 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 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 Google Cloud projeto3
Taxa de exportações para um tópico do Pub/Sub6 60 GB por minuto por Google Cloud projeto

1 Usar 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 é o valor 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 da entrada.
5 A cota diária de solicitações de controle se aplica a solicitações de API para criar e atualizar exclusões e coletores. A cota de solicitações de controle por minuto se aplica a tudo o que também está incluído na cota diária de solicitações de controle, além de solicitações de API para excluir registros e gerenciar 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 de erro é listado como topic_over_quota.

Cotas de ingestão por região

A partir de 4 de agosto de 2025, as cotas do Cloud Logging vão limitar, por projetoGoogle Cloud , o volume de dados gravados em uma região de ingestão. Em 4 de agosto de 2025, o Cloud Logging vai parar de limitar o número de solicitações de API entries.write de um projeto Google Cloud . Essa mudança visa melhorar o isolamento e proteger os recursos regionais contra sobrecarga de ingestão.

A tabela a seguir mostra a cota padrão para cada região:

Região de ingestão Valor padrão
asia-east1, asia-northeast1, asia-southeast1, asia-south1, europe-west1, europe-west2, europe-west3, europe-west4, us-central1, us-east4, us-west1 4,8 GB por minuto, por Google Cloud projeto
Todas as regiões restantes 300 MB por minuto, por projeto do Google Cloud

Os valores padrão das cotas regionais excedem os volumes de ingestão da maioria dos usuários. No entanto, se antes de 4 de agosto de 2025, o volume de ingestão do seu projeto em uma região nos últimos seis meses ou mais estiver próximo ou acima da cota padrão para essa região, sua cota inicial vai incluir um aumento automático único. Portanto, suas cotas podem ser maiores do que os padrões na tabela anterior.

Você pode revisar suas cotas regionais antes de 4 de agosto de 2025, mas elas não serão aplicadas até depois dessa data. Para informações sobre como revisar cotas, consulte Revisar suas cotas do Logging.

Em 4 de agosto de 2025, a cota para o número de solicitações de entries.write será alterada para ilimitada.

Em 11 de agosto de 2025, a cota para o número de solicitações de entries.write será removida.

Se você exceder uma cota regional após 4 de agosto de 2025, suas solicitações de gravação para a API Cloud Logging poderão ser rejeitadas com uma mensagem de erro "recurso esgotado". Para recomendações que ajudam a evitar o excesso de cotas, consulte Gerenciar e monitorar suas cotas do Logging.

Analise suas cotas da API Cloud Logging

Para revisar suas cotas da API Cloud Logging, faça o seguinte:

  1. No console do Google Cloud , acesse a página Cotas e limites do sistema:

    Acesse Cotas e limites do sistema

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo IAM e administrador.

  2. Filtre a lista de cotas do serviço da API Cloud Logging.

Solicitar mudanças na cota da API Cloud Logging

É possível solicitar limites de API do Logging maiores ou menores usando o Google Cloud console. 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 projetoGoogle Cloud para que você possa clicar nas caixas de seleção.

Gerenciar e monitorar suas cotas da API Cloud Logging

Para evitar interrupções de serviço causadas pelo excesso de cotas, faça o seguinte:

  • Use o ajuste automático de cota para monitorar o uso e solicitar aumentos para você. Para mais informações, consulte Ajustador de cota.
  • Crie alertas sobre cotas para receber notificações sobre o uso. Para mais informações, consulte Configurar alertas de cota.

Otimizar o uso de entries.list

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

  • Verifique se você está usando a API Cloud Logging de maneira eficaz. Para mais informações, consulte Otimizar o uso da API.

  • Se você souber com antecedência que as entradas de registro que quer analisar excedem a cota do entries.list, configure um coletor de registros para exportar seus registros para um destino compatível.

  • Para analisar entradas de registro fora do Logging, é possível copiar entradas de registro que já existem no Logging para buckets do Cloud Storage. Ao copiar registros para um bucket do Cloud Storage, é possível compartilhar entradas de registro com auditores fora do Logging e executar scripts no Cloud Storage.

  • Para agregar e analisar as entradas de registro no Logging, armazene as entradas em um bucket de registros e faça upgrade desse bucket para usar a Análise de registros. Para informações sobre essas etapas, consulte Configurar buckets de registro.

    Com a análise de registros, é possível consultar entradas de registro usando o SQL padrão do BigQuery.

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étricas, 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 do filtro1 20.000 caracteres
Tamanho dos descritores de métrica 8.000 B
Número de descritores de métrica 500 por Google Cloud projeto2
Número de séries temporais3 ativas 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 Cada métrica com base em registros contém um filtro. Quando uma entrada de registro corresponde ao filtro, ela é contada. Os filtros são definidos usando a linguagem de consulta do Logging.
2 Esse limite também se aplica a contas de faturamento, pastas e organizações e não é hierárquico.
3 Uma série temporal ficará ativa se você tiver gravado pontos de dados nela nas últimas 24 horas.

Registro de auditoria

Os tamanhos máximos dos registros de auditoria são mostrados na tabela a seguir. Esses valores podem ajudar você a estimar o espaço necessário nos destinos de gravador.

Tipo de registro de auditoria Tamanho máximo
Atividade do administrador 512 KiB
Acesso aos dados 512 KiB
Evento do sistema 512 KiB
Política negada 512 KiB

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

Preços

O Cloud Logging não cobra pelo encaminhamento de registros para um destino compatível, mas o destino pode aplicar cobranças. Com exceção do bucket de registros _Required, o Cloud Logging cobra pelo streaming de registros para buckets de registros e pelo armazenamento por mais tempo do que o período de armazenamento padrão do bucket.

O Cloud Logging não cobra pela cópia de registros, pela criação de escopos de registros ou visualizações de análise nem por consultas emitidas nas páginas do Explorador de registros ou da Análise de dados de registros.

Para mais informações, consulte estes documentos: