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 Cloud de Confiance projeto3 |
| Comprimento de um filtro de inclusão do 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 Cloud de Confiance 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 |
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
Cloud de Confiance projetos numa organização, pode configurar até
200 destinos para cada Cloud de Confiance 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 ver instruções, consulte a secção 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 |
Tamanho de um pedido de entries.write |
10 MB |
Taxa de pedidos de entries.write,
por regiãoPara mais informações, consulte Quotas de carregamento por região |
4,8 GB por minuto, por Cloud de Confiance 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, 3300 MB por minuto, por Cloud de Confiance projeto, em todas as restantes regiões1, 3 |
Número de pedidos de entries.list |
60 por minuto, por Cloud de Confiance projeto2, 3 |
| Número de nomes de recursos diferentes num comando único entries.write4 |
1000 |
| Pedidos de controlo5 por minuto | 600 |
| Pedidos de controlo5 por dia | 1000 por Cloud de Confiance projeto |
| Número de Cloud de Confiance projetos ou outros nomes de recursos num único entries.list pedido |
100 |
| Taxa de exportações para tópicos do Pub/Sub6 | 60 GB por minuto por Cloud de Confiance 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 contra a sobrecarga de carregamento, as quotas do Cloud Logging restringem, porCloud de Confiance 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 Cloud de Confiance projeto |
| Todas as regiões restantes | 300 MB por minuto, por Cloud de Confiance projeto |
Os valores predefinidos para as quotas regionais excedem os volumes de carregamento da maioria dos utilizadores. No entanto, se, antes da aplicação das quotas, o volume de carregamento do seu projeto de uma região nos seis ou mais meses anteriores estivesse 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 para a 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:
-
Na Cloud de Confiance 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.
- 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 superiores ou inferiores através da Cloud de Confiance consola. Para mais informações, consulte o artigo Veja e faça a gestão das quotas.
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.
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 |
|---|---|
_Required |
400 dias |
_Default |
30 dias |
| Definido pelo utilizador | 30 dias |