Neste documento, descrevemos como usar o Cloud Monitoring para observar tendências nos dados de registro e receber notificações quando as condições especificadas ocorrerem. Para fornecer ao Cloud Monitoring dados dos seus dados de registro, o Logging é compatível com os seguintes recursos:
É possível gerar métricas personalizadas com base nas entradas de registro. Essas métricas são chamadas de métricas com base em registros. Também é possível criar políticas de alertas com base em métricas para receber notificações quando uma métrica com base em registros atender a uma condição. Para mais informações, consulte Visualizar dados de entrada de registro com métricas com base em registros.
É possível usar políticas de alertas para monitorar, quase em tempo real, quando uma mensagem aparece nas entradas de registro. Essas políticas são chamadas de políticas de alertas com base em registros. Para mais informações, consulte Monitorar entradas de registro individuais para mensagens.
É possível escrever uma consulta SQL na Análise de Observabilidade e criar uma política de alertas que monitora os resultados da consulta. Essas políticas de alertas são chamadas de políticas de alertas baseadas em SQL. Para mais informações, consulte Monitorar consulta SQL SQL.
As políticas de alertas baseadas em SQL estão em pré-lançamento público.
O restante deste documento descreve as diferenças entre essas três políticas de alertas e fornece informações sobre autorização, custos e limites.
Visualizar dados de entrada de registro com métricas com base em registros
Use métricas com base em registros quando quiser monitorar eventos recorrentes nos dados de registros ao longo do tempo. As métricas com base em registros geram dados numéricos com base nos dados de registro e são adequadas quando você quer fazer o seguinte:
- Conte as ocorrências de uma mensagem, como um aviso ou erro, nos dados de registro e receba uma notificação quando o número de ocorrências ultrapassar um limite.
- Observe as tendências dos dados, como os valores de latência nos dados de registro, e receba uma notificação quando os valores mudarem de maneira inaceitável.
- Crie gráficos para exibir os dados numéricos extraídos.
Como as métricas com base em registros geram dados numéricos com base nos dados de registro, é possível usar essas métricas em políticas de alertas e mostrá-las em gráficos. Para informações sobre como criar políticas de alertas e gráficos para métricas com base em registros, consulte Configurar notificações para métricas com base em registros.
O Cloud Monitoring oferece um conjunto de métricas predefinidas baseadas em registros, e você pode definir as suas próprias. Para ver uma lista de métricas com base em registros definidas pelo sistema, clique no botão add_circle a seguir:
Métricas com base em registros definidas pelo usuário
É possível criar métricas com base em registros para extrair dados numéricos dos seus dados de registro. As métricas com base em registros definidas pelo usuário calculam valores das entradas de registro incluídas e excluídas.
Por padrão, as métricas com base em registros definidas pelo usuário coletam dados de todas as entradas de registro recebidas pelo roteador de registros no projeto do Google Cloud , mas é possível definir métricas com base em registros que coletam dados de entradas de registro roteadas para um bucket de registros específico.
- Para saber como definir e usar métricas com base em registros para envolvidos no projeto, consulte Como usar métricas com base em registros.
- Para informações sobre como definir e usar métricas com base em registros no nível do bucket, consulte Métricas com base em registros em buckets de registros.
Se você definir suas próprias métricas com base em registros, poderá haver cobranças. Para mais informações sobre os custos associados à ingestão de métricas, consulte Preços do Google Cloud Observability.
Monitorar entradas de registro individuais para mensagens
Quando quiser receber uma notificação sempre que uma mensagem específica ocorrer em uma entrada de registro, use políticas de alerta com base em registros. As políticas de alertas com base em registros são úteis para capturar eventos relacionados à segurança em entradas de registro, como as seguintes:
- Você quer receber uma notificação se um evento aparecer em um registro de auditoria. por exemplo, um usuário acessa a chave de segurança de uma conta de serviço.
- O aplicativo grava mensagens de implantação em registros, e você quer ser notificado quando uma alteração na implantação for registrada.
As políticas de alertas com base em registros são úteis para eventos que você espera que sejam raros e importantes. Você não quer saber sobre uma tendência ou um padrão, mas sim que algo aconteceu.
As políticas de alertas com base em registros são definidas em um projeto e verificam uma entrada de registro quando as seguintes condições são verdadeiras:
- O faturamento está ativado.
- A entrada de registro é originada em um projeto.
Os coletores no projeto em que a entrada de registro é originada ou em um projeto para o qual a entrada de registro é roteada, encaminham a entrada de registro para um bucket de registros.
Por exemplo, suponha que uma entrada de registro seja originada no projeto
A. Se um coletor de registros no projetoAencaminhar a entrada de registro para um bucket de registros, as políticas de alertas com base em registros definidas no projetoAvão verificar a entrada de registro.Como segundo exemplo, suponha que uma entrada de registro seja originada no projeto
Xe que um coletor de registros no projetoXencaminhe a entrada de registro para o projetoY. Se um coletor no projetoYrotear a entrada de registro para um bucket de registros, as políticas de alertas com base em registros definidas no projetoXe no projetoYvão verificar a entrada de registro.
Não é possível usar políticas de alertas baseadas em registros para monitorar entradas de registro que se originam em pastas, contas de faturamento ou organizações, nem para monitorar entradas de registro que não estão armazenadas em buckets de registros. Se você criar coletores agregados, eles poderão interceptar uma entrada de registro e impedir que ela seja roteada pelos coletores no projeto em que a entrada de registro se origina.
Para saber como criar políticas de alertas com base em registros, consulte Configurar políticas de alertas com base em registros.
Monitorar resultados de consulta SQL
É possível configurar políticas de alertas que usam a Análise de Observabilidade para executar consultas SQL nos dados de entrada de registro. Esses tipos de políticas de alertas são eficazes quando você quer receber notificações com base em padrões que não podem ser avaliados por políticas de alertas baseadas em registros, como padrões complexos em entradas de registro ou agregações de dados de registro. Para mais informações, consulte Monitorar os resultados da consulta SQL com uma política de alertas.
Comparação das opções de alerta
Esta seção compara políticas de alertas criadas com base em métricas com base em registros, políticas de alertas com base em registros e políticas de alertas com base em SQL.
Tabela de resumo
A tabela a seguir resume as técnicas de alerta e fornece links para mais informações:
| Políticas de alertas com base em métricas | Políticas de alertas com base em registros | Políticas de alertas baseadas em SQL | Mais informações |
|---|---|---|---|
| Com base nas métricas derivadas de entradas de registro | Com base em strings em entradas de registro individuais | Com base em tabelas retornadas por consultas SQL em entradas de registro | Métricas com base em registros Alertas com base em registros Alertas com base em SQL |
| Usado para notificar você sobre tendências ao longo do tempo | Usado para notificar você quando uma mensagem específica aparece em um registro | Usadas para notificar você sobre um padrão em uma janela de entradas de registro. | Métricas com base em registros Alertas com base em registros Alertas com base em SQL |
Calculado com base em
|
Corresponder apenas às entradas de registro incluídas | Calculado com base em entradas de registro em uma janela deslizante | Entradas de registro disponíveis Alertas com base em SQL |
| Operar com métricas de todos os projetos no escopo de métricas do projeto de escopo | Operar em entradas de registro que atendam às seguintes condições:
|
Operar em visualizações de registro acessíveis por conjuntos de dados vinculados do BigQuery. Esses conjuntos de dados podem estar em qualquer projeto. | Escopo de métricas Conjuntos de dados vinculados do BigQuery |
| O alerta é criado quando o valor de uma métrica atende a uma condição por um período especificado | Um alerta é criado sempre que uma entrada de registro específica corresponde a um filtro | O alerta é criado quando a tabela de resultados da consulta atende a uma condição | Alertas e notificações |
| Criado e gerenciado no Monitoring | Criado no Logging: gerenciado no Monitoring |
Criado na Análise de Observabilidade; gerenciado no Monitoring | Criar e gerenciar políticas de alertas Alertas baseados em SQL |
| Visualizado no Monitoring | Visualizado no Monitoring | Visualizado no Monitoring | Como visualizar políticas de alertas |
| Pode usar qualquer canal de notificação compatível com o Monitoring | Pode usar qualquer canal de notificação compatível com o Monitoring | Pode usar qualquer canal de notificação compatível com o Monitoring | Canais de notificação |
Entradas de registro disponíveis
Esta seção descreve quais entradas de registro podem ser contadas por uma métrica com base em registros e quais podem ser monitoradas por uma política de alertas com base em registros.
Entradas de registro que as métricas com base em registros podem contar
As métricas com base em registros definidas pelo usuário são calculadas com base em todas as entradas de registro recebidas pela API Logging para o projeto do Google Cloud , independentemente de qualquer filtro de inclusão ou filtro de exclusão que possa ser aplicado ao projeto do Google Cloud . Se você criar uma política de alertas com base em uma métrica com base em registros definida pelo usuário, a política vai monitorar dados de todas as entradas de registro.
As métricas com base em registros definidas pelo sistema são calculadas apenas com base nas entradas de registro que foram armazenadas em buckets de registro no projeto doGoogle Cloud . Se um registro tiver sido explicitamente excluído, ele não será incluído nessas métricas. Se você criar uma política de alertas com base em uma métrica com base em registros definida pelo sistema, ela vai monitorar dados apenas das entradas de registro incluídas.
Entradas de registro que as políticas de alertas com base em registros podem monitorar
As políticas de alertas com base em registros são definidas em um projeto e verificam uma entrada de registro quando as seguintes condições são verdadeiras:
- O faturamento está ativado.
- A entrada de registro é originada em um projeto.
Os coletores no projeto em que a entrada de registro é originada ou em um projeto para o qual a entrada de registro é roteada, encaminham a entrada de registro para um bucket de registros.
Por exemplo, suponha que uma entrada de registro seja originada no projeto
A. Se um coletor de registros no projetoAencaminhar a entrada de registro para um bucket de registros, as políticas de alertas com base em registros definidas no projetoAvão verificar a entrada de registro.Como segundo exemplo, suponha que uma entrada de registro seja originada no projeto
Xe que um coletor de registros no projetoXencaminhe a entrada de registro para o projetoY. Se um coletor no projetoYrotear a entrada de registro para um bucket de registros, as políticas de alertas com base em registros definidas no projetoXe no projetoYvão verificar a entrada de registro.
Não é possível usar políticas de alertas baseadas em registros para monitorar entradas de registro originadas em pastas, contas de faturamento ou organizações, nem para monitorar entradas de registro que não estão armazenadas em buckets de registros. Se você criar coletores agregados, eles poderão interceptar uma entrada de registro e impedir que ela seja roteada pelos coletores no projeto em que a entrada de registro se origina.
Entradas de registro que as políticas de alertas baseadas em SQL podem monitorar
As políticas de alertas baseadas em SQL não têm acesso a registros individuais. Em vez disso, essas políticas consultam conjuntos de dados vinculados do BigQuery e monitoram o resultado da consulta. Os conjuntos de dados vinculados do BigQuery dão acesso aos dados nas visualizações de registros.
Cada visualização de registros está em um bucket de registros. Crie o conjunto de dados vinculado do BigQuery para esse bucket de registros depois de fazer upgrade do bucket de registros para usar a Análise de Observabilidade.
Para mais informações sobre políticas de alertas baseadas em SQL, consulte Monitorar os resultados da consulta SQL com uma política de alertas.
Monitorar métricas em vários projetos
É possível monitorar métricas de vários projetos configurando um escopo de métricas. Um escopo de métricas lista todos os projetos e contas que ele monitora. Um projeto de escopo hospeda as métricas de escopo. O projeto de escopo armazena as políticas de alertas e outras configurações que você cria para as métricas de escopo. O projeto de escopo de um escopo de métricas é aquele escolhido pelo seletor de projetos do console Google Cloud .
As políticas de alertas com base em métricas com base em registros, assim como as políticas de alertas com base em outras métricas, funcionam em todos os projetos no escopo de métricas do projeto de escopo.
O escopo de métricas não é relevante para políticas de alertas baseadas em entradas de registro, como políticas baseadas em registros e em SQL.
Para mais informações sobre escopos de métricas, incluindo escopos de métricas de vários projetos, e sobre projetos de escopo, consulte:
Alertas e notificações
Quando a condição de uma política de alertas é atendida, o Monitoring abre um alerta e envia notificações para os canais de notificação da política de alertas. Para ver os detalhes do alerta, clique em Ver alerta na mensagem de notificação ou navegue diretamente para a página Alertas no Monitoring.
Alertas para políticas de alertas com base em métricas
As políticas de alertas baseadas em métricas com base em registros criam alertas e notificações como todas as outras políticas de alertas baseadas em métricas no Monitoring, conforme descrito em Comportamento de alertas. Para mais informações sobre como gerenciar alertas para políticas de alertas com base em métricas, consulte Alertas para políticas de alertas com base em métricas.
Alertas para políticas de alertas com base em registros
O conteúdo desta seção se aplica somente a políticas de alertas com base em registros. Essas políticas monitoram entradas de registro individuais. Ela não se aplica a políticas de alertas que monitoram dados de métricas, incluindo métricas com base em registros, ou consulta SQL SQL.
Quando o Cloud Logging grava a entrada de registro em um bucket de registros, cada política de alertas com base em registros faz a verificação da entrada. Se uma entrada de registro corresponder ao filtro da política de alertas, o Cloud Logging extrai rótulos e encaminha os dados para o Cloud Monitoring.
Ao receber dados do Cloud Logging, o Cloud Monitoring usa as seguintes regras para determinar quais ações realizar:
Se não houver alertas abertos para a política de alertas, o Monitoring vai abrir um novo alerta e enviar uma notificação.
Quando os rótulos extraídos estão disponíveis, as informações de identificação do alerta incluem esses rótulos.
Se houver um alerta fechado cujos valores de rótulo extraídos correspondam aos valores de rótulo extraídos da entrada de registro atual, o Monitoring vai reabrir o alerta fechado ou abrir um novo. O Monitoring determina qual ação tomar com base na limpeza do alerta fechado, o que pode levar até três minutos.
Se houver um alerta aberto com valores de rótulo que correspondam aos valores de rótulo extraídos da entrada de registro atual, o sistema vai enviar outra notificação ou não vai fazer nada. O comportamento do sistema depende de a política de alertas ter excedido um limite de alerta ou notificação.
Para cada política de alertas com base em registros, os seguintes limites se aplicam:
No máximo 20 alertas por dia por política de alertas com base em registros.
Quando esse limite é atingido, a notificação inclui uma declaração semelhante a esta: "O máximo de 20 alertas diários foi atingido. Os alertas para esta política serão retomados nas próximas 24 horas."
O limite diário é redefinido em um horário aleatório. Esse intervalo de redefinição não é configurável pelo usuário.
No máximo, dois novos alertas por minuto por política de alertas com base em registros.
Quando uma política de alertas com base em registros extrai valores de rótulo, esse limite pode impedir que você receba as notificações esperadas. Por exemplo, suponha que uma política de alertas com base em registros extraia um rótulo que tenha cinco valores possíveis. Em qualquer intervalo de um minuto, o sistema pode abrir no máximo dois alertas.
O intervalo mínimo entre notificações repetidas de um alerta aberto é de 5 minutos. É possível configurar esse intervalo ao criar ou editar a política de alertas.
Os alertas são fechados automaticamente quando o período especificado pela duração do fechamento automático expira, sem uma repetição da causa do alerta. Por padrão, a duração do fechamento automático é de 7 dias. Devido a eventos recorrentes, o alerta pode permanecer aberto por mais tempo do que a duração do fechamento automático.
Para mais informações sobre como gerenciar alertas para políticas de alertas com base em registros, consulte Gerenciar alertas para políticas de alertas com base em registros.
Alertas para políticas de alertas baseadas em SQL
Para políticas de alertas baseadas em SQL, o Cloud Monitoring cria um alerta na primeira vez que o resultado da consulta SQL atende à condição especificada na política. Cada política de alertas tem apenas um alerta aberto. Enquanto o alerta estiver aberto, se a condição for atendida novamente, o Monitoring não criará outros alertas nem enviará mais notificações. O Monitoring encerra os alertas baseados em SQL após sete dias, a menos que você configure um período de encerramento de alerta mais curto ou encerre o alerta por conta própria.
Para mais informações sobre como gerenciar alertas para políticas de alertas baseadas em SQL, consulte Gerenciar alertas para políticas de alertas baseadas em SQL.
Como criar e gerenciar políticas de alertas
Você cria, modifica e exclui políticas de alertas com base em métricas com base em registros no Cloud Monitoring, como qualquer outra política de alertas com base em métricas. Para mais informações, consulte Como gerenciar políticas.
É possível criar políticas de alertas com base em registros usando a Análise de registros ou a API Cloud Monitoring. É possível modificar e excluir políticas de alertas com base em registros no Monitoring ou com a API Cloud Monitoring. Para mais informações, consulte Como gerenciar políticas de alertas com base em registros.
É possível criar políticas de alertas baseadas em SQL usando a Análise de Observabilidade ou a API Cloud Monitoring. É possível modificar e excluir políticas de alertas baseadas em SQL no Monitoring ou usando a API Cloud Monitoring. Para mais informações, consulte Monitorar os resultados da consulta SQL com uma política de alertas.
Como visualizar políticas de alertas
A página Políticas no Monitoring lista todas as políticas de alerta no seu projeto Google Cloud . Essa lista inclui políticas que usam métricas com base em registros e políticas de alertas com base em registros.
-
No console do Google Cloud , acesse a página notifications Alertas:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
- Selecione Ver todas as políticas.
As políticas de alertas com base em registros aparecem na lista com o valor Logs na coluna Tipo. As políticas de alertas baseadas em métricas, incluindo as métricas com base em registros, aparecem na lista com o valor Metrics na coluna Tipo.
As políticas de alertas baseadas em SQL aparecem na lista com o valor SQL na coluna Tipos.
Veja um trecho de uma lista de políticas na captura de tela a seguir:
Canais de notificação
É possível enviar notificações de qualquer tipo de política de alertas para qualquer um dos canais de notificação compatíveis com o Monitoring. É necessário configurar esses canais antes de usá-los em políticas de alerta.
Para saber mais, consulte Como gerenciar canais de notificação.
Requisitos de autorização
O uso de métricas ou políticas de alertas com base em registros exige autorização para o Cloud Logging e o Cloud Monitoring.
Para métricas com base em registros definidas pelo usuário, consulte Permissões para métricas com base em registros.
Para políticas de alertas com base em registros, consulte Permissões para políticas de alertas com base em registros.
Para políticas de alertas baseadas em SQL, consulte Permissões para políticas de alertas baseadas em SQL.
Limites
Esta seção lista os limites para métricas com base em registros e para políticas de alertas. Os limites das políticas de alertas dependem do tipo de dados que a política monitora.
Limites para métricas com base em registros
Há limites para o número e a estrutura das métricas com base em registros definidas pelo usuário. Para mais informações sobre esses limites, consulte limites para métricas com base em registros.
Limites para políticas de alertas
As duas primeiras colunas da tabela a seguir listam uma categoria e um valor limite. A terceira coluna lista os tipos de políticas a que o limite se aplica:
- Métrica:aplica-se a políticas de alertas que monitoram dados de métricas, incluindo métricas com base em registros.
- LBA:se aplica a políticas de alertas que monitoram entradas de registro. Essas políticas são chamadas de políticas de alertas com base em registros.
- SQL:aplica-se a políticas de alertas que monitoram o resultado de uma consulta SQL.
- Todas:aplica-se a todas as políticas de alertas.
| Categoria | Valor | Tipo de política |
|---|---|---|
| Políticas de alertas (soma de métricas e registros) por métricas de escopo 1 | 2.000 | Métrica, LBA |
| Condições por política de alertas com base em métricas | 6 | Métrica |
| Condições por política de alertas baseada em SQL (Acesso antecipado) |
1 | SQL |
| Tempo máximo de execução de consulta para uma política de alertas baseada em SQL (Acesso antecipado) |
5 minutos | SQL |
| Período máximo avaliado por uma condição de ausência de métrica 2 |
1 dia | Métrica |
| O período máximo avaliado por uma condição de limite de métrica é de2 |
25 horas | Métrica |
| Período máximo que uma condição do PromQL avalia |
2 anos | Métrica |
| Comprimento máximo do filtro usado em uma condição de limite de métrica |
2.048 caracteres Unicode | Métrica |
| Número máximo de séries temporais monitoradas por uma condição de previsão |
64 | Métrica |
| Janela mínima de previsão | 1 hora (3.600 segundos) | Métrica |
| Janela máxima de previsão | 2,5 dias (216.000 segundos) | Métrica |
| Canais de notificação por política de alertas | 16 | Todos |
| Número máximo de novos alertas por política de alertas com base em registros |
20 alertas por dia | LBA |
| Número máximo de notificações3 por política de alertas com base em registros |
20 notificações por dia | LBA |
| Taxa máxima de novos alertas por política de alertas com base em registros |
2 novos alertas por minuto | LBA |
| Intervalo mínimo entre notificações de um alerta aberto4 por política de alertas com base em registros |
5 minutos | LBA |
| Número máximo de políticas de alertas acionadas simultaneamente por projeto |
80.000 | Todos |
| Número máximo de alertas abertos simultaneamente por política de alertas |
1.000 | Todos |
| Período após o qual um alerta sem novos dados é encerrado automaticamente |
7 dias | Métrica, SQL |
| Duração máxima de um alerta se ele não for fechado manualmente | 7 dias | LBA |
| Retenção de alertas fechados | 13 meses | Não relevante |
| Retenção de alertas abertos | Indefinido | Não relevante |
| Canais de notificação por escopo de métricas | 4.000 | Não relevante |
| Número máximo de políticas de alertas por suspensão | 16 | Todos |
| Retenção de uma soneca | 13 meses | Não relevante |
2O período máximo avaliado por uma condição é a soma do período de alinhamento e dos valores da janela de duração. Por exemplo, se o período de alinhamento for definido como 15 horas e a janela de duração for definida como 15 horas, serão necessárias 30 horas de dados para avaliar a condição.
3O Monitoring gera notificações para um alerta aberto quando o tempo mínimo entre as notificações se esgota e uma entrada de registro corresponde aos rótulos do alerta. Se uma política de alertas baseada em registros for adiada quando o Monitoring gerar uma notificação, a notificação será descartada e não será enviada aos canais de notificação da política. Caso contrário, o Monitoring envia a notificação para os canais de notificação da política de alertas. Todas as notificações geradas pelo Monitoring contam para o limite de 20 notificações por dia da política de alertas.
4Se a consulta da sua política de alertas com base em registros extrair rótulos, cada combinação de valores de rótulo extraídos vai representar uma linha do tempo de alerta. Portanto, você pode receber várias notificações em cinco minutos.
Preços
Para saber mais sobre os preços do Cloud Logging, consulte a página Preços do Google Cloud Observability.