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. |
| Número máximo de visualizações de análise por projeto do Google Cloud | 100 | Não é possível aumentar. Esse recurso está em pré-lançamento público. |
| Por projeto do Google Cloud , o número máximo de visualizações de análise por região | 50 | Não é possível aumentar. Esse recurso está em pré-lançamento público. |
| Por Google Cloud projeto, o número máximo de regiões que podem armazenar visualizações de análise | 10 | Não é possível aumentar. Esse recurso está em pré-lançamento público. |
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. |
| Número de sessões de tailing em tempo real abertas | 10 por projeto do Google Cloud | Não é possível aumentar. Esse limite também se aplica a contas de faturamento, pastas e organizações e não é hierárquico. |
| Número de entradas de tailing em tempo real retornadas | 60.000 por minuto | Não é possível aumentar. |
| Número de campos restritos | 20 por bucket | Não é possível aumentar. |
| Tamanho de um campo restrito | 800 B | 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. |
| Número de operações de cópia simultâneas | 1 por projeto do Google Cloud | Não é possível aumentar. Esse limite também se aplica a contas de faturamento, pastas e organizações e não é hierárquico. |
| 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 Cloud Customer Care 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.
- Para analisar entradas de registro fora do Logging, é possível copiar retroativamente as entradas de registro que já existem no Logging para 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, armazene-as em um bucket de registros e faça upgrade desse bucket para usar a Análise de Observabilidade. Para informações sobre essas etapas, consulte Configurar buckets de registros.
Com a Análise de Observabilidade, é possível consultar as entradas de registro usando o SQL padrão do BigQuery.
Métricas com base em registros
Esta entrada se aplica apenas aos dados de métricas que o Google Cloud Observability deriva dos seus dados de registro (métricas com base em registros). Esta seção não se aplica aos dados de métricas gravados pelos serviços do Google Cloud ou pelos seus aplicativos.
Os limites a seguir se aplicam ao uso de métricas com base em registros definidas pelo usuário. Com exceção do número de descritores de métricas, esses limites são fixos e não podem ser aumentados ou reduzidos.
| 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 |
| Duração do filtro1 | 20.000 caracteres |
| Tamanho dos descritores de métrica | 8.000 B |
| Número de descritores de métricas | 500 por Google Cloud projeto2 |
| Número de séries temporais ativas3 | 30.000 por métrica4 |
| Número de buckets do histograma | 200 por métrica de distribuição personalizada |
| Retenção de dados | Consulte Cloud Monitoring: retenção de dados. |
1 Cada métrica com base em registros contém um filtro. Quando uma entrada de registro
corresponde ao filtro, ela é contada. Os filtros são definidos usando
a linguagem de consulta do Logging.
2 Esse limite também se aplica a contas de faturamento, pastas e
organizações e não é hierárquico.
3 Uma série temporal estará ativa se você tiver gravado
pontos de dados nela nas últimas 24
horas.
4 O sistema limita o número de série temporal ativas por recurso monitorado
a 1.000.000. Para métricas com base em registros no nível do projeto, o recurso é definido pelo recurso na entrada de registro. Para
métricas com base em registros com escopo de bucket,
o recurso é logging_bucket.
Quando esse limite é atingido, o sistema limita os dados de métricas do recurso. É possível reduzir o número de série temporal de uma
métrica com base em registros reduzindo a cardinalidade dela.
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
3650 days. 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.
Preços
Para informações sobre preços, consulte a página Preços do Google Cloud Observability. Se você rotear dados de registro para outros serviços do Google Cloud , consulte os seguintes documentos: