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 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.
| 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 Google Cloud 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 Google Cloud 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. |
| Número máximo de visualizações de estatísticas por Google Cloud projeto | 100 | Não é possível aumentar. Esta funcionalidade está na Pré-visualização pública. |
| Por Google Cloud projeto, o número máximo de visualizações de estatísticas por região | 50 | Não é possível aumentar. Esta funcionalidade está na Pré-visualização pública. |
| Por Google Cloud projeto, o número máximo de regiões que podem armazenar visualizações de propriedade do Analytics | 10 | Não é possível aumentar. Esta funcionalidade está na 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.
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. |
| Número de sessões de monitorização em tempo real abertas | 10 por Google Cloud 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. |
| Número de entradas de monitorização em tempo real devolvidas | 60 000 por minuto | Não é possível aumentar. |
| Número de campos restritos | 20 por contentor | Não é possível aumentar. |
| Tamanho de um campo restrito | 800 B | 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 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
300 MB por minuto, por Google Cloud 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 Google Cloud 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 Google Cloud projeto | Não é possível aumentar. Esta quota aplica-se a pedidos API para criar e atualizar exclusões e destinos. |
| Número de Google Cloud projetos ou outros nomes de recursos num único pedido entries.list |
100 | Não é possível aumentar. |
| Número de operações de cópia simultâneas | 1 por Google Cloud 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. |
| Taxa de exportações para tópicos do Pub/Sub | 60 GB por minuto por Google Cloud 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, 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 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 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.
- 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 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 entradas de registo que já existam 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 os pode aumentar nem diminuir.
| Categoria | Valor máximo |
|---|---|
| Número de etiquetas | 10 por métrica |
| Comprimento do valor de label | 1024 B |
| 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 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 | 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
Para ver informações sobre preços, consulte a página de preços do Google Cloud Observability. Se encaminhar os dados de registo para outros Google Cloud serviços, consulte os seguintes documentos: