Algumas ou todas as informações nesta página podem não se aplicar à nuvem confiável da S3NS.

Esta página foi traduzida pela API Cloud Translation.

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 KB¹
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 B²
Comprimento de um valor de rótulo `LogEntry`	64 KB²
Comprimento de uma consulta da linguagem de consulta do Logging	20.000 caracteres
Fanout de consulta⁴	200 buckets
Número de coletores	200 por Trusted Cloud projeto³
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 Trusted Cloud projeto³,^4,⁵
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 registro⁶	Determinado pelo período de armazenamento padrão do bucket de registros. Para um bucket de registros personalizado com o período de armazenamento padrão, esse valor é de 30 dias atrás.
Carimbo de data/hora futuro que pode ser armazenado em buckets de registros⁶	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

¹ Esse limite aproximado tem como base o tamanho de dados internos, e não o tamanho real da solicitação da API REST.
² O Cloud Logging trunca valores e chaves de rótulo muito grandes quando a entrada de registro associada é gravada.
³ 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 doTrusted Cloud em uma organização, poderá configurar até 200 coletores para cada projeto do Trusted Cloud . Para essa mesma organização, também é possível configurar até 200 coletores no nível da organização.
⁴ 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.
⁵ Esse limite inclui buckets que estão com exclusão pendente.
⁶ 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.
⁷Esse 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
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 Trusted 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 Trusted 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` ¹^{, 3} 300 MB por minuto, por projeto Trusted Cloud , em todas as regiões restantes¹^{, 3}
Número de solicitações `entries.list`	60 por minuto, por Trusted Cloud projeto²^{, 3}
Número de nomes de recursos diferentes em um único comando `entries.write` ⁴	1000
Solicitações de controle⁵ por minuto	600
Solicitações de controle⁵ por dia	1.000 por projeto do Trusted Cloud
Número de projetos Trusted Cloud ou outros nomes de recursos em uma única solicitação `entries.list`	100
Taxa de exportações para um tópico do Pub/Sub⁶	60 GB por minuto por Trusted Cloud projeto

¹ 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.
²Esse é o valor padrão.
³ Esse limite também se aplica a contas de faturamento, pastas e organizações e não é hierárquico.
⁴ O campo logName de uma entrada de registro especifica o nome do recurso da entrada.
⁵ 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.
⁶ 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 projetoTrusted 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 Trusted 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 Trusted Cloud projeto
Todas as regiões restantes	300 MB por minuto, por projeto do Trusted 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:

No console do Trusted 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.
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 API Logging maiores ou menores usando o Trusted Cloud console. Para mais informações, consulte Ver e gerenciar cotas.

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.

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
`_Required`	400 dias
`_Default`	30 dias
Definido pelo usuário	30 dias