Para ajudar você a planejar a capacidade e evitar interrupções de serviço, o Cloud Logging aplica cotas e limites do sistema a solicitações de API, armazenamento e configurações de recursos. É possível solicitar aumentos para a maioria das cotas, mas os limites do sistema são fixos e não podem ser alterados.
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 alterar 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 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.
| Categoria | Valor máximo do limite ou valor da cota inicial de |
Observações |
|---|---|---|
Tamanho de um
LogEntry |
256 KiB | Esse limite é aproximado e se baseia em tamanhos de dados internos, não no tamanho real da solicitação de 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. |
Tamanho de um valor de rótulo LogEntry |
64 KiB | O Cloud Logging trunca valores de rótulo muito grandes quando a entrada de registro associada é gravada. Não é possível aumentar. |
| Tamanho 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ê precisa consultar com frequência entradas de registro que se originam em recursos diferentes, considere rotear entradas de registro para alguns buckets de registro centralizados. |
| Número de coletores | 200 por projeto do Google Cloud | 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. |
| Tamanho de um filtro de inclusão de coletor | 20.000 caracteres | Não é possível aumentar. |
| Tamanho 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 registro | 100 por projeto do Google Cloud | 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 que estão 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, a experiência do usuário poderá ser prejudicada, porque o escopo de registro 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 a indexação de texto completo. Portanto, não recomendamos que você defina a indexação personalizada. |
| Número de visualizações de registro | 30 por bucket de registros | Pode ser aumentado para 1.000 visualizações de registro em um único bucket de registros. Se você aumentar o número máximo de visualizações de registro, poderá ter uma experiência do usuário prejudicada, porque o escopo do registro padrão não pode incluir todas as visualizações de registro em um projeto. |
| Carimbo de data/hora mais antigo que pode ser armazenado em buckets de registro | Determinado pelo período de armazenamento 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 roteadas 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 do registro por recurso | 100 | Pode ser aumentado para 10.000. |
| Número de visualizações de registro e projetos incluídos em um escopo do registro | 100 | Recomendamos que um escopo do registro liste as visualizações de registros em vez de projetos, quando possível. Listar as visualizações de registro 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 do registro liste as visualizações de registro em vez de projetos, quando possível. As visualizações de registro 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 mudanças nas cotas e nos limites da API Logging. Para instruções, consulte Solicitar mudanças nas cotas da API Cloud Logging nesta página.
Para ver suas cotas de API, acesse o painel de APIs, selecione uma API e, em seguida, selecione Cotas.
| Categoria | Valor máximo do limite ou valor da cota inicial |
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 Google Cloud 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 Google Cloud em todas as outras regiões |
É 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. O uso de filtros de exclusão
não reduz a taxa de solicitações de gravação porque as entradas de registro são
excluídas após a solicitação |
Número de solicitações de entries.list |
60 por minuto, por Google Cloud 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 copie as 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 solicitações de API administrativas e de configuração. Inclui todas as solicitações na cota diária de solicitações de controle, além de solicitações que excluem registros ou gerenciam recursos, como buckets de registros, visualizações de registros, políticas do IAM em visualizações de registros, escopos do registro e métricas com base em registros. |
| Solicitações de controle por dia | 1.000 por projeto do Google Cloud | Não é possível aumentar. Essa cota se aplica a solicitações de API para criar e atualizar exclusões e coletores. |
| Número de Google Cloud projetos ou outros nomes de recursos em uma única solicitação entries.list |
100 | Não é possível aumentar. |
| Taxa de exportações para tópicos do Pub/Sub | 60 GB/min por projeto, pasta ou organização do Google Cloud em que o coletor está 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 coletor, e o código do erro é listado como Para informações sobre solução de problemas, consulte Problemas de cota com coletores. |
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 o volume de dados gravados em uma região de ingestão por projeto doGoogle Cloud .
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 do Google Cloud |
| Todas as outras regiões | 300 MB por minuto, por projeto do Google Cloud |
Os valores padrão das cotas regionais excedem os volumes de ingestão da maioria dos usuários. No entanto, se o volume de ingestão do projeto de uma região estiver próximo ou acima da cota padrão nos seis meses ou mais antes da aplicação das cotas, sua cota inicial incluirá um aumento automático único. Portanto, suas cotas podem ser maiores do que os padrões na tabela anterior. Para informações sobre como analisar cotas, consulte Analisar as cotas da API Cloud 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 exceder as cotas, consulte Gerenciar e monitorar suas cotas do Logging.
Analisar as cotas da API Cloud Logging
Para analisar as cotas da API Cloud Logging, faça o seguinte:
-
No console do Google Cloud , 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 nas cotas da API Cloud Logging
Para determinar se é possível solicitar um limite maior ou menor da API Logging para a cota usando o console do Google Cloud , acesse a página Cotas e limites do sistema e pesquise a cota de interesse.
- Se a cota estiver listada, use essa página para solicitar uma alteração no limite. Para mais informações sobre essas etapas, consulte Ver e gerenciar cotas.
- Se a cota não estiver listada ou se você solicitar uma atualização de cota e receber o erro
Edit is not allowed for this quota, entre em contato com o suporte e solicite uma alteração na cota. O faturamento precisa estar ativado no projeto doGoogle Cloud para editar cotas no console do Google Cloud .
Gerenciar e monitorar as cotas da API Cloud Logging
Para evitar interrupções de serviço causadas por cotas excedidas, faça o seguinte:
- Use o ajuste automático de cotas para monitorar o uso de cotas e solicitar aumentos para você. Para mais informações, consulte Ajustador de cotas.
- 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 se destina à recuperação de grandes volumes de entradas de registro. Se
você estiver esgotando regularmente sua cota de entries.list, considere as
seguintes opções:
Verifique se você está usando 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 os 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 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 seguintes períodos de retenção do Cloud Logging se aplicam a buckets de registros, independentemente dos tipos de registros incluídos no bucket ou se eles foram copiados de outro local:
| Bucket | Recursos | Período de armazenamento padrão | Retenção de clientes personalizada |
|---|---|---|---|
_Required |
projeto, pasta, organização | 400 dias | Não configurável |
_Default |
pasta, organização | 30 dias | Não configurável |
_Default |
projeto | 30 dias | Configurável |
| Definido pelo usuário | projeto | 30 dias | Configurável |
Para _Default e buckets de registros definidos pelo usuário que estão em projetos, é possível
configurar o Cloud Logging para reter os registros entre
1 dia e
. Para informações sobre como definir regras de retenção, consulte Configurar retenção personalizada.
Para armazenar entradas de registro de uma pasta ou organização por mais de 30 dias, crie um coletor de registros e encaminhe essas entradas para um bucket de registros em um projeto.