Nesta página, você verá detalhes sobre os limites que se aplicam ao uso do Cloud Logging.
Cotas e limites de uso do Logging
A tabela a seguir lista as cotas e os limites que se aplicam ao uso do Cloud Logging. Em geral, é possível solicitar um aumento de cota. No entanto, não é possível mudar os limites.
Algumas entradas são listadas como sendo por projeto, mas a observação indica que a entrada também se aplica a contas de faturamento, pastas e organizações e não é hierárquica. Por exemplo, se você tiver vários projetos do Cloud de Confiance em uma organização, poderá configurar até 200 coletores para cada projeto do Cloud de Confiance . Para essa mesma organização, também é possível configurar até 200 coletores no nível da organização.
| Categoria | Valor máximo do limite ou valor inicial da cota |
Observações |
|---|---|---|
Tamanho de um
LogEntry |
256 KB | Esse limite é aproximado e tem como base os tamanhos de dados internos, e não o tamanho real da solicitação da API REST. Não é possível aumentar. |
| Tamanho de uma entrada de registro de auditoria | 512 KiB | Não é possível aumentar. |
| Número de rótulos | 64 por LogEntry |
Não é possível aumentar. |
Comprimento de uma chave de rótulo LogEntry |
512 B | O Cloud Logging trunca chaves de rótulo muito grandes quando a entrada de registro associada é gravada. Não é possível aumentar. |
Comprimento de um valor de rótulo LogEntry |
64 KB | O Cloud Logging trunca valores de rótulo muito grandes quando a entrada de registro associada é gravada. Não é possível aumentar. |
| Comprimento de uma consulta da linguagem de consulta do Logging | 20.000 caracteres | Não é possível aumentar. |
| Desdobramento de consulta | 200 buckets | 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. Não é possível aumentar. Por motivos de desempenho, minimize o número de buckets de registros e crie-os em uma região. Se você precisar consultar com frequência entradas de registro originadas em recursos diferentes, considere rotear as entradas para alguns buckets de registro centralizados. |
| Número de coletores | 200 por Cloud de Confiance projeto | Pode ser aumentado para 4.000. Essa cota também se aplica a contas de faturamento, pastas e organizações e não é hierárquica. |
| Comprimento de um filtro de inclusão de coletor | 20.000 caracteres | Não é possível aumentar. |
| Comprimento de um filtro de exclusão de coletor | 20.000 caracteres | Não é possível aumentar. |
| Número de filtros de exclusão | 50 por coletor | Não é possível aumentar. Se você precisar de mais de 50 filtros de exclusão, refine o filtro de inclusão. |
| Número de buckets de registros | 100 por Cloud de Confiance projeto | Pode ser aumentado para 2.500. Essa cota é o número máximo de buckets que podem conter entradas de registro para um recurso e inclui buckets com exclusão pendente. Essa cota também se aplica a contas de faturamento, pastas e organizações e não é hierárquica. Se você aumentar o número máximo de buckets de registros, poderá ter uma experiência do usuário ruim porque o escopo de registros padrão não pode incluir todos os buckets de registros em um projeto. |
| Número de campos indexados personalizados | 20 por bucket de registros | Não é possível aumentar. O Cloud Logging é compatível com indexação de texto completo. Portanto, não recomendamos que você defina indexação personalizada. |
| Número de visualizações de registro | 30 por bucket de registros | Pode ser aumentado para 1.000 visualizações de registros em um único bucket de registros. Se você aumentar o número máximo de visualizações de registros, poderá ter uma experiência do usuário ruim porque o escopo de registros padrão não pode incluir todos os buckets de registros em um projeto. |
| Carimbo de data/hora mais antigo que pode ser armazenado em buckets de registro | Determinado pelo período de retenção do bucket de registros. | Para um bucket de registros personalizado com o período de armazenamento padrão, esse valor é de 30 dias no passado. A API Logging aceita entradas de registro com carimbos de data/hora mais antigos, e essas entradas são encaminhadas para destinos de coletor. No entanto, se as entradas de registro com carimbos de data/hora mais antigos forem roteadas para um bucket de registros, elas não serão armazenadas. |
| Carimbo de data/hora futuro que pode ser armazenado em buckets de registros | Até 1 dia no futuro | A API Logging rejeita entradas com carimbos de data/hora
com mais de um dia no futuro e retorna um erro
INVALID_ARGUMENT. Não é possível aumentar. |
| Número de escopos de registros por recurso | 100 | Pode ser aumentado para 10.000. |
| Número de visualizações de registros e projetos incluídos em um escopo de registro | 100 | Recomendamos que um escopo de registros liste visualizações de registros em vez de projetos, quando possível. Listar visualizações de registros reduz o tempo de consulta e aumenta a clareza sobre quais entradas de registro estão sendo consultadas. |
| Número de projetos incluídos em um escopo de registro | 5 | Recomendamos que um escopo de registros liste visualizações de registros em vez de projetos, quando possível. As visualizações de registros podem estar em projetos diferentes. |
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.
Para ver suas cotas de API, acesse o painel de APIs, selecione uma API e, em seguida, Cotas.
| Categoria | Valor máximo do limite ou valor inicial da cota |
Observações |
|---|---|---|
| Ciclo de vida dos tokens de página da API | 24 horas | Não é possível aumentar. |
Tamanho de uma solicitação entries.write |
10 MB | Não é possível aumentar. |
Taxa de solicitações de entries.write por região |
4,8 GB por minuto, por projeto do Cloud de Confiance , 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 projeto do Cloud de Confiance , em todas as regiões restantes |
É possível solicitar um aumento de cota. Essa cota também se aplica a contas de faturamento, pastas e organizações e não é hierárquica. Para mais informações sobre essas cotas, consulte Cotas de ingestão por região. Usar filtros de exclusão
não reduz a taxa de solicitações de gravação porque as entradas de registro são
excluídas depois que a solicitação |
Número de solicitações entries.list |
60 por minuto, por Cloud de Confiance projeto | Não é possível aumentar. Esse limite também se aplica a contas de faturamento, pastas e organizações e não é hierárquico. Para consultar grandes volumes de registros, use as APIs BigQuery. Para transferir grandes volumes de registros, use um coletor de registros ou Copiar entradas de registro. |
Número de nomes de recursos diferentes em um único comando entries.write |
1000 | Não é possível aumentar. O campo |
| Solicitações de controle por minuto | 600 | Não é possível aumentar. Essa cota se aplica a tudo o que também 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. |
| Solicitações de controle por dia | 1.000 por Cloud de Confiance projeto | Não é possível aumentar. Essa cota se aplica a solicitações de API para criar e atualizar exclusões e gravadores. |
Número de projetos Cloud de Confiance ou outros nomes de recursos em uma única solicitaçãoentries.list |
100 | Não é possível aumentar. |
| Taxa de exportações para tópicos do Pub/Sub | 60 GB por minuto por projeto, pasta ou organização Cloud de Confiance em que o gravador é definido | Você pode enviar uma solicitação de suporte para aumentar sua cota. O aumento da cota é concedido com base na disponibilidade do Pub/Sub. Se a taxa de exportações exceder a cota, o erro será registrado em uma entrada de registro. O campo de resumo indica um erro de configuração do
gravador e o código de erro é listado como
|
Cotas de ingestão por região
Para melhorar o isolamento e proteger os recursos regionais contra sobrecarga de ingestão, as cotas do Cloud Logging restringem, por projeto doCloud de Confiance , o volume de dados gravados em uma região de ingestão.
A tabela a seguir mostra a cota padrão para cada região:
| Região de ingestão | Valor padrão |
|---|---|
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 projeto Cloud de Confiance |
| Todas as regiões restantes | 300 MB por minuto, por projeto do Cloud de Confiance |
Os valores padrão das cotas regionais excedem os volumes de ingestão da maioria dos usuários. No entanto, se antes da aplicação das cotas, o volume de ingestão do seu projeto em uma região nos últimos seis meses ou mais estava próximo ou acima da cota padrão para essa região, sua cota inicial inclui um aumento automático único. Portanto, suas cotas podem ser maiores do que os padrões na tabela anterior. Para informações sobre como revisar cotas, consulte Revisar suas cotas do Logging.
Se você exceder uma cota regional, suas solicitações de gravação para a API Cloud Logging poderão ser rejeitadas com uma mensagem de erro "recurso esgotado". Para recomendações que ajudam a evitar o excesso de cotas, consulte Gerenciar e monitorar suas cotas do Logging.
Analise suas cotas da API Cloud Logging
Para revisar suas cotas da API Cloud Logging, faça o seguinte:
-
No console do Cloud de Confiance , acesse a página Cotas e limites do sistema:
Acesse Cotas e limites do sistema
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo IAM e administrador.
- Filtre a lista de cotas do serviço da API Cloud Logging.
Solicitar mudanças na cota da API Cloud Logging
É possível solicitar limites maiores ou menores da API Logging usando o console doCloud de Confiance . Para mais informações, consulte Ver e gerenciar cotas.
Gerenciar e monitorar suas cotas da API Cloud Logging
Para evitar interrupções de serviço causadas pelo excesso de cotas, faça o seguinte:
- Use o ajuste automático de cota para monitorar o uso e solicitar aumentos para você. Para mais informações, consulte Ajustador de cota.
- Crie alertas sobre cotas para receber notificações sobre o uso. Para mais informações, consulte Configurar alertas de cota.
Otimizar o uso de entries.list
O uso esperado de entries.list é pesquisar
registros correspondentes. Esse método não foi criado para recuperação de grande volume de entradas de
registro. Se você estiver esgotando regularmente sua cota de entries.list, considere as seguintes opções:
Use a API Cloud Logging de forma eficaz. Para mais informações, consulte Otimizar o uso da API.
Se você souber com antecedência que as entradas de registro que quer analisar excedem a cota de
entries.list, configure um coletor de registros para exportar seus registros para um destino compatível.
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 de gravador.
| 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 |
|---|---|
_Required |
400 dias |
_Default |
30 dias |
| Definido pelo usuário | 30 dias |