Quotas e limites

Esta página fornece detalhes sobre os limites que se aplicam à utilização do Cloud Logging.

Limites de utilização do registo

Os seguintes limites aplicam-se à utilização do Cloud Logging. Com exceção dos limites relativos ao número de contentores de registos e destinos, estes limites são fixos. Não pode aumentá-los nem diminuí-los.

Categoria Valor máximo
Tamanho de um LogEntry 256 KB1
Tamanho de uma entrada do registo de auditoria 512 KiB
Número de etiquetas 64 por LogEntry
Comprimento de uma chave de etiqueta LogEntry 512 B2
Comprimento de um valor de etiqueta LogEntry 64 KB2
Comprimento de uma consulta de linguagem de consulta de registo 20 000 carateres
Divisão do pedido4 200 contentores
Número de ralos 200 por Google Cloud projeto3
Comprimento de um filtro de inclusão de destino 20 000 carateres
Comprimento de um filtro de exclusão de destino 20 000 carateres
Número de filtros de exclusão 50 por lava-louça
Número de contentores de registos 100 por Google Cloud projeto3,4,5
Número de campos indexados personalizados 20 por contentor de registos
Número de visualizações de registos 30 por contentor de registos
Data/hora mais antiga que pode ser armazenada em contentores de registos6 Determinado pelo período de retenção predefinido do contentor de registos. Para um contentor de registos personalizado com o período de retenção predefinido, este valor é de 30 dias no passado.
Indicação de tempo futura que pode ser armazenada em contentores de registos6 Até 1 dia no futuro
Número de âmbitos de registo por recurso 100
Número de visualizações de registos e projetos incluídos num âmbito de registo 100
Número de projetos incluídos num âmbito de registo 5
Número máximo de visualizações de propriedades do Analytics por Google Cloud projeto7 100
Por Google Cloud projeto, o número máximo de visualizações de estatísticas por região7 50
Por Google Cloud projeto, o número máximo de regiões que podem armazenar vistas de estatísticas7 10

1 Este limite aproximado baseia-se nos tamanhos dos dados internos e não no tamanho real do pedido da API REST.
2 O Cloud Logging trunca as chaves e os valores de etiquetas demasiado grandes quando a entrada de registo associada é escrita.
3 Este limite também se aplica a contas de faturação, pastas e organizações, e não é hierárquico. Por exemplo, se tiver vários Google Cloud projetos numa organização, pode configurar até 200 destinos para cada Google Cloud projeto. Para essa mesma organização, também pode configurar até 200 destinos ao nível da organização.
4 Este limite é o número máximo de contentores que podem conter entradas de registo para um recurso. Para mais informações, consulte o artigo A consulta devolve um erro.
5 Este limite inclui contentores que estão com eliminação pendente.
6 As entradas do registo com indicações de tempo fora destes limites são rejeitadas dos contentores de registos. A API Logging aceita entradas com datas/horas mais antigas, e essas entradas podem ser encaminhadas para destinos de sinks, mas não são armazenadas no armazenamento de registos. A API Logging rejeita entradas com data/hora mais de 1 dia no futuro e devolve um erro INVALID_ARGUMENT.
7Esta funcionalidade está em pré-visualização pública.

Quotas e limites da Logging API

Os seguintes limites aplicam-se à sua utilização da API Logging. Pode pedir alterações às quotas e aos limites da API Logging. Para instruções, consulte Pedir alterações à quota da API Cloud Logging nesta página.

Categoria Valor máximo
Utilização da API Para ver as suas quotas, aceda ao painel de controlo da API, selecione uma API e, de seguida, selecione Quotas.
Tempo de vida dos tokens de página da API 24 horas
Número de sessões de monitorização em tempo real abertas 10 por Google Cloud projeto3
Número de entradas de monitorização em tempo real devolvidas 60 000 por minuto
Número de campos restritos 20 por contentor
Tamanho de um campo restrito 800 B
Tamanho de um pedido de entries.write 10 MB
Taxa de pedidos de entries.write, por região
Para mais informações, consulte Quotas de carregamento por região		 4,8 GB por minuto, por Google Cloud projeto, 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 Google Cloud projeto, em todas as regiões restantes1, 3
Número de pedidos de entries.list 60 por minuto, por Google Cloud projeto2, 3
Número de nomes de recursos diferentes num comando
entries.writeúnico4		 1000
Pedidos de controlo5 por minuto 600
Pedidos de controlo5 por dia 1000 por Google Cloud projeto
Número de Google Cloud projetos ou outros nomes de recursos num
único pedidoentries.list		 100
Número de operações de cópia simultâneas 1 por Google Cloud projeto3
Taxa de exportações para tópicos do Pub/Sub6 60 GB por minuto por Google Cloud projeto, pasta ou
organização onde o destino está definido

1 A utilização de filtros de exclusão não reduz este número porque os registos são excluídos após o pedido entries.write ser feito.
2Este valor é a predefinição.
3 Este limite também se aplica a contas de faturação, pastas e organizações, e não é hierárquico.
4 O campo logName de uma entrada de registo especifica o nome do recurso da entrada de registo.
5 A quota de pedidos de controlo diária aplica-se a pedidos API para criar e atualizar exclusões e destinos. A quota de pedidos de controlo por minuto aplica-se a tudo o que também está incluído na quota de pedidos de controlo diária, além dos pedidos de API para eliminar registos e gerir métricas baseadas em registos.
6 Se a taxa de exportações exceder a quota, o erro é registado numa entrada do registo. O campo de resumo indica um erro de configuração do destino e o código de erro é apresentado como topic_over_quota.

Quotas de carregamento por região

Para melhorar o isolamento e proteger os recursos regionais da sobrecarga de carregamento, as quotas do Cloud Logging restringem, porGoogle Cloud projeto, o volume de dados escritos numa região de carregamento.

A tabela seguinte mostra a quota predefinida para cada região:

Região de carregamento Valor predefinido
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 Google Cloud projeto

Os valores predefinidos para as quotas regionais excedem os volumes de carregamento da maioria dos utilizadores. No entanto, se, antes de 4 de agosto de 2025, o volume de carregamento do seu projeto de uma região nos seis ou mais meses anteriores estava próximo ou acima da quota predefinida para essa região, a sua quota inicial inclui um aumento automático único. Por conseguinte, as suas quotas podem ser superiores aos valores predefinidos na tabela anterior. Para obter informações sobre a revisão de quotas, consulte o artigo Reveja as suas quotas de registo.

Se exceder uma quota regional, os seus pedidos de gravação na API Cloud Logging podem ser rejeitados com uma mensagem de erro "recurso esgotado". Para ver recomendações que ajudam a evitar exceder as quotas, consulte o artigo Faça a gestão e monitorize as suas quotas de registo.

Reveja as quotas da Cloud Logging API

Para rever as quotas da API Cloud Logging, faça o seguinte:

  1. Na Google Cloud consola, aceda à página Quotas e limites do sistema:

    Aceda a Quotas e limites do sistema

    Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é IAM e administração.

  2. Filtre a lista de quotas para o serviço da API Cloud Logging.

Peça alterações à quota da Cloud Logging API

Pode pedir limites da API Logging mais altos ou mais baixos através da Google Cloud consola. Para mais informações, consulte o artigo Veja e faça a gestão das quotas.

Se receber um erro Edit is not allowed for this quota, pode contactar o apoio técnico para solicitar alterações à quota. Tenha também em atenção que a faturação tem de estar ativada no Google Cloud projeto para clicar nas caixas de verificação.

Faça a gestão e a monitorização das suas quotas da API Cloud Logging

Para evitar interrupções do serviço causadas pela ultrapassagem das quotas, pode fazer o seguinte:

  • Use o ajuste automático de quotas para monitorizar a utilização de quotas e pedir aumentos por si. Para mais informações, consulte o artigo Ajustador de quotas.
  • Crie alertas sobre quotas para receber notificações acerca da utilização. Para mais informações, consulte o artigo Configure alertas de quota.

Otimize a utilização de entries.list

A utilização esperada de entries.list é pesquisar registos correspondentes. Este método não se destina à obtenção de grandes volumes de entradas de registo. Se esgota regularmente a sua quota de entries.list, considere as seguintes opções:

  • Certifique-se de que está a usar a API Cloud Logging de forma eficaz. Para mais informações, consulte o artigo Otimize a utilização da API.

  • Se souber antecipadamente que as entradas de registo que quer analisar excedem a quota de entries.list, configure um destino de registo para exportar os registos para um destino suportado.

  • Para analisar entradas de registo fora do Logging, pode copiar retroativamente as entradas de registo que já existem no Logging para contentores do Cloud Storage. Quando copia registos para um contentor do Cloud Storage, pode partilhar entradas de registo com auditores fora do Logging e executar scripts no Cloud Storage.

  • Para agregar e analisar as suas entradas de registo no Logging, armazene as entradas de registo num contentor de registos e, em seguida, atualize esse contentor de registos para usar o Log Analytics. Para obter informações sobre estes passos, consulte o artigo Configure contentores de registo.

    O Log Analytics permite-lhe consultar as suas entradas de registo através do SQL padrão do BigQuery.

Métricas baseadas em registos

Os seguintes limites aplicam-se à sua utilização de métricas baseadas em registos definidas pelo utilizador. Com exceção do número de descritores de métricas, estes limites são fixos e não pode aumentá-los nem diminuí-los.

Categoria Valor máximo
Número de etiquetas 10 por métrica
Comprimento do valor de label 1024 mil milhões
Comprimento da descrição da etiqueta 800 B
Duração do filtro1 20 000 carateres
Comprimento dos descritores de métricas 8000 B
Número de descritores de métricas 500 por Google Cloud projeto2
Número de intervalos temporais ativos3 30 000 por métrica
Número de intervalos do histograma 200 por métrica de distribuição personalizada
Retenção de dados Consulte o artigo Cloud Monitoring: retenção de dados

1 Cada métrica baseada em registos contém um filtro. Quando uma entrada de registo corresponde ao filtro, a entrada de registo é contabilizada. Os filtros são definidos através da linguagem de consulta de registo.
2 Este limite também se aplica a contas de faturação, pastas e organizações e não é hierárquico.
3Uma série cronológica está ativa se tiver escrito pontos de dados na mesma nas últimas 24 horas.

Registo de auditoria

Os tamanhos máximos dos registos de auditoria são apresentados na tabela seguinte. Estes valores podem ajudar a estimar o espaço necessário nos seus destinos de sincronização.

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

Períodos de retenção de registos

Os seguintes períodos de retenção do Cloud Logging aplicam-se aos contentores de registos, independentemente dos tipos de registos incluídos no contentor ou se foram copiados de outra localização. As informações de retenção são as seguintes:

Grupo Período de retenção predefinido Retenção personalizada
_Required 400 dias Não configurável
_Default 30 dias Configurável
Definido pelo utilizador 30 dias Configurável

Para os contentores de registos _Default e definidos pelo utilizador, pode configurar o Cloud Logging para reter os registos entre 1 dia e 3650 dias. Para ver informações sobre como definir regras de retenção, consulte o artigo Configure a retenção personalizada.

Preços

O Cloud Logging não cobra o encaminhamento de registos para um destino suportado. No entanto, o destino pode aplicar cobranças. Com exceção do contentor de registos _Required, o Cloud Logging cobra taxas para transmitir registos para contentores de registos e para armazenamento durante um período superior ao período de retenção predefinido do contentor de registos.

O Cloud Logging não cobra pela cópia de registos, pela criação de âmbitos de registo ou vistas de estatísticas, nem por consultas emitidas através das páginas do Explorador de registos ou Log Analytics.

Para mais informações, consulte os seguintes documentos: