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 quanto ao número de buckets e coletores 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 KB1 |
Tamanho de uma entrada de registro de auditoria | 512 KiB |
Número de rótulos | 64 por LogEntry |
Tamanho de uma chave de rótulo LogEntry |
512 B2 |
Tamanho de um valor de rótulo LogEntry |
64 KB2 |
Tamanho de uma consulta de linguagem de consulta do Logging | 20.000 caracteres |
Fanout de consultas4 | 200 buckets |
Número de coletores | 200 por projeto do Google Cloud3 |
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 projeto do Google Cloud3,4,5 |
Número de campos indexados personalizados | 20 por bucket de registros |
Número de visualizações de registros | 30 por bucket de registros |
Carimbo de data/hora mais antigo que pode ser armazenado em buckets de registros6 | 30 dias no passado |
Carimbo de data/hora futuro que pode ser armazenado em buckets de registros6 | Até 1 dia no futuro |
1 Esse limite aproximado tem como base o tamanho de dados internos, e não o tamanho real da solicitação da API REST.
2 O Cloud Logging trunca valores e chaves de rótulo muito grandes quando a entrada de registro associada é gravada.
3 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 do Google Cloud em uma organização, poderá configurar até 200 coletores para cada projeto do Google Cloud. Para essa mesma organização, também é possível configurar até 200 coletores no nível da organização.
4 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.
5 Esse limite inclui buckets com exclusão pendente.
6 As entradas de registro com carimbos de data/hora fora desses limites são
rejeitadas nos buckets de registros. A API Logging aceita entradas com carimbos de data/hora mais antigos, que podem ser roteadas para destinos do coletor, mas não armazenadas no armazenamento de registros. A API Logging rejeita entradas com carimbos de data/hora
mais de um dia no futuro e retorna um
erro INVALID_ARGUMENT
.
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. Clique em uma API e selecione Cotas. |
Ciclo de vida dos tokens de página da API | 24 horas |
Número de sessões de acompanhamento em tempo real abertas | 10 por projeto do Google Cloud3 |
Número de entradas de acompanhamento em tempo real retornadas | 60.000 por minuto |
Número de campos restritos | 20 por bucket |
Tamanho de um campo restrito | 800 B |
Tamanho de uma solicitação entries.write |
10 MB |
Número de solicitações entries.write |
120.000 por minuto, por projeto do Google Cloud1, 3 |
Número de solicitações entries.list |
60 por minuto, por projeto do Google Cloud2, 3 |
Número de nomes de recursos diferentes em um único comando do entries.write 4 |
1000 |
Controlar solicitações5 por minuto | 600 |
Solicitações de controle5 por dia | 1.000 por projeto do Google Cloud |
Número de projetos do Google Cloud ou outros nomes de recursos em uma única solicitação do entries.list |
100 |
Número de operações de cópia simultâneas | 1 por projeto do Google Cloud3 |
Taxa de exportações para um tópico do Pub/Sub6 | 60 GB por minuto por projeto do Google Cloud |
1 O uso de 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.
2 Esse valor é a configuração padrão.
3 Esse limite também se aplica a contas de faturamento, pastas e organizações e não é hierárquico.
4 O campo logName
de uma entrada de registro especifica o nome do recurso da entrada de registro.
5 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 que 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.
6 Se a taxa de exportação 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 do erro é listado como topic_over_quota
.
Solicitar alterações na cota da API Cloud Logging
É possível solicitar limites maiores ou menores da API Logging usando o Console do Google Cloud. Para mais informações, consulte Ver e gerenciar cotas.
Se aparecer um erro Edit is not allowed for this quota
,
entre em contato com o suporte para
solicitar alterações na cota. Observe também que o faturamento precisa estar ativado no projeto do Google Cloud para que seja possível marcar as caixas de seleção.
Otimize o uso de entries.list
O uso esperado de entries.list
é pesquisar registros correspondentes. Esse método não se destina à recuperação de alto volume de entradas de registro. Se
você estiver esgotando regularmente sua cota 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ê sabe com antecedência que as entradas de registro que quer analisar excedem a cota
entries.list
, configure um coletor de registros para exportar os registros para um destino compatível.
- Para analisar as entradas de registro fora do Logging, copie as entradas de registro que já existem no Logging para os buckets do Cloud Storage. Ao copiar registros para um bucket do Cloud Storage, é possível compartilhar entradas de registro com auditores fora do Logging e executar scripts no Cloud Storage.
- Para agregar e analisar suas entradas de registro no Logging, crie ou faça upgrade de um bucket de registros para usar a Análise de dados de registros. Com a Análise de dados de registros, é possível consultar suas entradas de registro usando o SQL padrão do BigQuery.
Métricas com base em registros
Os limites a seguir se aplicam ao uso das métricas com base em registros definidas pelo usuário. Com exceção do número de descritores de métrica, esses limites são fixos. Não é possível aumentá-los ou diminuí-los.
Categoria | Valor máximo |
---|---|
Número de rótulos | 10 por métrica |
Comprimento do valor do rótulo | 1.024 B |
Comprimento da descrição do rótulo | 800 B |
Comprimento de um filtro | 20.000 caracteres |
Tamanho dos descritores de métrica | 8.000 B |
Número de descritores de métricas | 500 por projeto do Google Cloud2 |
Número de séries temporais ativas1 | 30.000 por métrica |
Número de buckets de histograma | 200 por métrica de distribuição personalizada |
Retenção de dados | Consulte Cloud Monitoring: retenção de dados |
1 Uma série temporal ficará ativa se você tiver gravado pontos de dados nela nas últimas 24 horas.
2 Esse limite também se aplica a contas de faturamento, pastas e organizações, e não é hierárquico.
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 do coletor.
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 | Armazenamento personalizado |
---|---|---|
_Required |
400 dias | Não configurável |
_Default |
30 dias | Configurável |
Definido pelo usuário | 30 dias | Configurável |
Para _Default
e os buckets de registros definidos pelo usuário, configure o Cloud Logging para reter seus registros por um período entre 1 e 3.650 dias. Para mais informações sobre como definir regras de retenção, consulte Configurar a retenção personalizada.
Preços
O Cloud Logging não cobra para rotear registros para um
destino compatível. No entanto, o destino pode aplicar cobranças.
Com exceção do bucket de registros _Required
,
o Cloud Logging cobra pelo streaming de registros para buckets de registros e
por um armazenamento maior que o período de armazenamento padrão do bucket de registros.
O Cloud Logging não cobra pela cópia de registros ou por consultas emitidas pela página Análise de registros ou pela página Análise de registros.
Para mais informações, consulte estes documentos:
- Resumo de preços do Cloud Logging
Custos de destino:
- As cobranças de geração de registros de fluxo de VPC são aplicadas quando você envia e exclui seus registros de fluxo da nuvem privada virtual do Cloud Logging.