Esta página fornece detalhes sobre os limites que se aplicam à utilização do Cloud Logging.
Quotas de registo e limites de utilização
A tabela seguinte apresenta as quotas e os limites aplicáveis à utilização do Cloud Logging. Em geral, pode pedir um aumento de uma quota. No entanto, não é possível alterar os limites.
Algumas entradas são apresentadas como sendo por projeto, mas a nota indica que a entrada também se aplica a contas de faturação, pastas e organizações, e não é hierárquica. 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.
| Categoria | Valor máximo do limite ou valor da quota inicial |
Notas |
|---|---|---|
Tamanho de um
LogEntry |
256 KB | Este limite é aproximado e baseia-se nos tamanhos de dados internos, não no tamanho real do pedido da API REST. Não é possível aumentar. |
| Tamanho de uma entrada do registo de auditoria | 512 KiB | Não é possível aumentar. |
| Número de etiquetas | 64 por LogEntry |
Não é possível aumentar. |
Comprimento de uma chave de etiqueta LogEntry |
512 B | O Cloud Logging trunca as chaves de etiquetas demasiado grandes quando a respetiva entrada de registo associada é escrita. Não é possível aumentar. |
Comprimento de um valor de etiqueta LogEntry |
64 KB | O Cloud Logging trunca os valores de etiquetas demasiado grandes quando a respetiva entrada de registo associada é escrita. Não é possível aumentar. |
| Comprimento de uma consulta de linguagem de consulta de registo | 20 000 carateres | Não é possível aumentar. |
| Divisão do pedido | 200 contentores | 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. Não é possível aumentar. Por motivos de desempenho, minimize o número de contentores de registos e crie-os numa região. Se precisar frequentemente de consultar entradas de registo originárias de recursos diferentes, pondere encaminhar as entradas de registo para alguns contentores de registos centralizados. |
| Número de ralos | 200 por Cloud de Confiance projeto | Pode ser aumentado para 4000. Esta quota também se aplica a contas de faturação, pastas e organizações, e não é hierárquica. |
| Comprimento de um filtro de inclusão do destino | 20 000 carateres | Não é possível aumentar. |
| Comprimento de um filtro de exclusão de destino | 20 000 carateres | Não é possível aumentar. |
| Número de filtros de exclusão | 50 por lava-louça | Não é possível aumentar. Se precisar de mais de 50 filtros de exclusão, refine o filtro de inclusão. |
| Número de contentores de registos | 100 por Cloud de Confiance projeto | Pode ser aumentado para 2500. Esta quota é o número máximo de contentores que podem conter entradas de registo para um recurso e inclui contentores que estão com eliminação pendente. Esta quota também se aplica a contas de faturação, pastas e organizações, e não é hierárquica. Se aumentar o número máximo de contentores de registos, pode ter uma experiência do utilizador degradada porque o âmbito do registo predefinido não pode incluir todos os contentores de registos num projeto. |
| Número de campos indexados personalizados | 20 por contentor de registos | Não é possível aumentar. O Cloud Logging suporta a indexação de texto completo. Por isso, não recomendamos que defina a indexação personalizada. |
| Número de visualizações de registos | 30 por contentor de registos | Pode ser aumentado para 1000 visualizações de registos num único contentor de registos. Se aumentar o número máximo de visualizações de registos, pode ter uma experiência do utilizador degradada porque o âmbito do registo predefinido não pode incluir todos os contentores de registos num projeto. |
| A data/hora mais antiga que pode ser armazenada em contentores de registos | Determinado pelo período de retenção 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. A API Logging aceita entradas de registo com datas/horas mais antigas e essas entradas de registo são encaminhadas para destinos de contentores. No entanto, se as entradas de registo com data/hora mais antigas forem encaminhadas para um contentor de registos, não são armazenadas. |
| Data/hora futura que pode ser armazenada em contentores de registos | Até 1 dia no futuro | A API Logging rejeita entradas com datas/horas
superiores a 1 dia no futuro e devolve um erro INVALID_ARGUMENT. Não é possível aumentar. |
| Número de âmbitos de registo por recurso | 100 | Pode ser aumentado para 10 000. |
| Número de visualizações de registos e projetos incluídos num âmbito de registo | 100 | Recomendamos que um âmbito de registo liste as visualizações de registos em vez de projetos, sempre que possível. A apresentação dos resultados das visualizações do registo reduz o tempo de consulta e aumenta a clareza relativamente às entradas do registo que estão a ser consultadas. |
| Número de projetos incluídos num âmbito de registo | 5 | Recomendamos que um âmbito de registo liste as visualizações de registos em vez de projetos, sempre que possível. As visualizações de registos podem estar em projetos diferentes. |
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.
Para ver as quotas da API, aceda ao painel de controlo da API, selecione uma API e, de seguida, selecione Quotas.
| Categoria | Valor máximo do limite ou valor da quota inicial |
Notas |
|---|---|---|
| Tempo de vida dos tokens de página da API | 24 horas | Não é possível aumentar. |
Tamanho de um pedido de entries.write |
10 MB | Não é possível aumentar. |
Taxa de pedidos de entries.write,
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
300 MB por minuto, por Cloud de Confiance projeto, em todas as restantes regiões |
Pode pedir um aumento da quota. Esta quota também se aplica a contas de faturação, pastas e organizações, e não é hierárquica. Para mais informações sobre estas quotas, consulte o artigo Quotas de carregamento por região. A utilização de filtros de exclusão não reduz a taxa de pedidos de gravação, porque as entradas do registo são excluídas após a realização do pedido |
Número de pedidos de entries.list |
60 por minuto, por Cloud de Confiance projeto | Não é possível aumentar. Este limite também se aplica a contas de faturação, pastas e organizações, e não é hierárquico. Para consultar grandes volumes de registos, considere usar as APIs BigQuery. Para transferir grandes volumes de registos, considere usar um destino de registos ou copiar entradas de registo. |
Número de nomes de recursos diferentes num único comando entries.write |
1000 | Não é possível aumentar. O campo |
| Pedidos de controlo por minuto | 600 | Não é possível aumentar. Esta quota aplica-se a tudo o que também está incluído na quota de pedidos de controlo diários, além dos pedidos API para eliminar registos e gerir métricas baseadas em registos. |
| Controlar pedidos por dia | 1000 por Cloud de Confiance projeto | Não é possível aumentar. Esta quota aplica-se a pedidos API para criar e atualizar exclusões e destinos. |
| Número de Cloud de Confiance projetos ou outros nomes de recursos num único pedido entries.list |
100 | Não é possível aumentar. |
| Taxa de exportações para tópicos do Pub/Sub | 60 GB por minuto por Cloud de Confiance projeto, pasta ou organização onde o destino está definido | Pode apresentar um pedido de apoio técnico para aumentar a sua quota. O aumento da quota é concedido com base na disponibilidade do Pub/Sub. Se a taxa de exportações exceder a quota, o erro é
registado numa entrada de registo. O campo de resumo indica um erro de configuração do destino e o código de erro é apresentado como |
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, 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 a partir 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 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 de terem sido 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 |