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 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 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 Google Cloud 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 Google Cloud 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. |
| Número máximo de visualizações do Google Analytics por projeto 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 projeto do Google Cloud , 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 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. |
| Número de sessões de acompanhamento ao vivo abertas | 10 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. |
| Número de entradas de acompanhamento ao vivo 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 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 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 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 Google Cloud 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 Google Cloud ou outros nomes de recursos em uma única solicitaçãoentries.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 por minuto por projeto, pasta ou organização Google Cloud 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 doGoogle Cloud , 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 Google Cloud |
| Todas as regiões restantes | 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 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 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 na cota da API Cloud Logging
É possível solicitar limites maiores ou menores da API Logging usando o console doGoogle 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. O faturamento precisa estar ativado no
projetoGoogle Cloud para que você possa clicar nas caixas de seleção.
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.
- Para analisar entradas de registro fora do Logging, é possível copiar 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 dados de registros. Para informações sobre essas etapas, consulte Configurar buckets de registro.
Com a análise de registros, é possível consultar entradas de registro usando o SQL padrão do BigQuery.
Métricas com base em registros
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. 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 do filtro1 | 20.000 caracteres |
| Tamanho dos descritores de métrica | 8.000 B |
| Número de descritores de métrica | 500 por Google Cloud projeto2 |
| Número de séries temporais3 ativas | 30.000 por métrica |
| 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 ficará ativa se você tiver gravado
pontos de dados nela nas últimas 24
horas.
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 | 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
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: