Neste documento, descrevemos como usar o Cloud Monitoring para observar tendências nos dados de registro e notificar você quando as condições descritas ocorrerem. Para fornecer dados ao Cloud Monitoring dos seus registros, o Logging oferece suporte aos 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 alerta para monitorar, quase em tempo real, quando uma mensagem aparece nas entradas de registro. Essas políticas de alertas são chamadas de políticas de alertas com base em registros. Para mais informações, consulte Monitorar entradas de registro individuais de mensagens.
Você pode escrever uma consulta SQL na Análise de dados de registros 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 resultados de consulta SQL.
As políticas de alertas baseadas em SQL estão em fase de pré-lançamento público.
O restante deste documento descreve as diferenças entre essas três políticas de alerta e fornece informações sobre autorização, custos e limites.
Visualizar dados de entrada de registro com métricas com base em registros
Quando você quiser monitorar eventos recorrentes nos dados de registro ao longo do tempo, use as métricas com base em registros. As métricas com base em registros geram dados numéricos a partir dos seus dados de registro e são adequadas se você quiser realizar uma destas ações:
- 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 nos 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 mostrar os dados numéricos extraídos.
Como as métricas com base em registros geram dados numéricos dos seus registros, você pode usá-las em políticas de alertas e exibi-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 fornece um conjunto de métricas predefinidas com base em registros, e você pode definir 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 Google Cloud , mas você pode definir métricas com base em registros que coletam dados de entradas de registro roteadas para um bucket de registros específico.
- Para informações sobre como definir e usar métricas com base em registros no nível do 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 registro.
Se você definir suas próprias métricas com base em registros, poderá haver cobranças. Para mais informações sobre custos associados à ingestão de métricas, consulte Métricas faturáveis.
Monitorar entradas de registro individuais para mensagens
Quando você quiser ser notificado sempre que uma mensagem específica ocorrer em uma entrada de registro, use políticas de alertas com base em registros. As políticas de alertas com base em registros são úteis para detectar eventos relacionados à segurança nas entradas de registro, como:
- 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 de origem da entrada de registro ou em um projeto para o qual a entrada é roteada encaminham a entrada 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 alerta 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 projetoXroteie a entrada de registro para o projetoY. Se um coletor no projetoYencaminhar a entrada de registro para um bucket de registros, as políticas de alerta com base em registros definidas no projetoXe no projetoYvão verificar a entrada de registro.
Não é possível usar políticas de alerta com base em registros para monitorar entradas de registro que se originam em pastas, contas de faturamento ou organizações ou para monitorar entradas de registro que não são armazenadas em buckets de registro. 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 é originada.
Para informações sobre como criar políticas de alertas com base em registros, consulte Configurar políticas de alertas com base em registros.
Monitorar os resultados da consulta SQL
É possível configurar políticas de alerta que usam a Análise de registros para executar consultas SQL nos dados de entrada de registro. Esses tipos de políticas de alerta são eficazes quando você quer receber notificações com base em padrões que não podem ser avaliados por políticas de alerta com base 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 as políticas de alertas criadas com base em métricas e 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 outras 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 nas tabelas retornadas por consultas SQL sobre 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 | Usado 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 a entradas de registro incluídas | Calculado com base nas entradas de registro em uma janela deslizante | Registros disponíveis Alertas com base em SQL |
| Operar nas 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 que podem ser acessadas por conjuntos de dados vinculados. Os conjuntos de dados vinculados podem estar em qualquer projeto. | Escopo de métricas Conjuntos de dados vinculados |
| O incidente é criado quando o valor de uma métrica atende a uma condição por um período especificado | O incidente é criado sempre que uma entrada de registro específica corresponde a um filtro | O incidente é criado quando a tabela de resultados da consulta atende a uma condição | Incidentes e notificações |
| Criado e gerenciado no Monitoring | Criado no Logging: gerenciado no Monitoring |
Criado no Log Analytics e gerenciado no Monitoring | Como 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
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 Google Cloud , independentemente dos filtros de inclusão ou filtros de exclusão que possam ser aplicados ao projeto Google Cloud . Se você criar uma política de alertas com base em uma métrica com base em registros definida pelo usuário, ela monitorará dados de todas as entradas de registro.
As métricas com base em registros definidas pelo sistema são calculadas somente com base nas entradas de registro que foram armazenadas em buckets de registro no projetoGoogle 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, a política monitorará dados apenas das entradas de registro incluídas.
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 de origem da entrada de registro ou em um projeto para o qual a entrada é roteada encaminham a entrada 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 alerta 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 projetoXroteie a entrada de registro para o projetoY. Se um coletor no projetoYencaminhar a entrada de registro para um bucket de registros, as políticas de alerta com base em registros definidas no projetoXe no projetoYvão verificar a entrada de registro.
Não é possível usar políticas de alerta com base em registros para monitorar entradas de registro que se originam em pastas, contas de faturamento ou organizações ou para monitorar entradas de registro que não são armazenadas em buckets de registro. 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 é originada.
As políticas de alertas baseadas em SQL consultam as visualizações de registro nos buckets de registros. Esses buckets de registro precisam ser atualizados para usar a Análise de dados de registros e vinculados a um conjunto de dados do BigQuery. 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 ao configurar um escopo de métricas. Um escopo de métricas lista todos os projetos e contas que ele monitora. Um projeto de escopo hospeda o escopo das métricas. O projeto de escopo armazena as políticas de alertas e outras configurações criadas para o escopo das métricas. O projeto de escopo de um escopo de métricas é o projeto selecionado pelo Google Cloud seletor de projetos do console.
As políticas de alertas com base em métricas baseadas em registros, como as políticas de alertas com base em outras métricas, funcionam em todos os projetos no escopo das métricas do projeto de escopo.
O escopo das métricas não é relevante para políticas de alertas com base em entradas de registro, como políticas baseadas em registros e SQL.
Para mais informações sobre escopos de métricas, incluindo escopos de várias projetos, e sobre projetos de escopo, consulte:
Incidentes e notificações
Quando a condição de uma política de alertas é atendida, o Monitoring abre um incidente e envia notificações para os canais de notificação da política de alertas. Para ver os detalhes do incidente, clique em Ver incidente na mensagem de notificação ou navegue diretamente para a página Incidentes no Monitoring.
Incidentes para políticas de alertas com base em métricas
As políticas de alertas baseadas em métricas com base em registros criam incidentes 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 incidentes de políticas de alertas baseadas em métricas, consulte Incidentes de políticas de alertas baseadas em métricas.
Incidentes para políticas de alertas com base em registros
As políticas de alertas com base em registros não são políticas de alertas com base em métricas. Quando uma entrada de registro atende à condição de uma política de alertas com base em registro, o Monitoring cria incidentes e notificações da seguinte maneira:
Na primeira vez que o Cloud Logging grava uma entrada de registro que corresponde à consulta de alerta em um bucket de registros, um incidente é criado e uma notificação é enviada. Se outra entrada de registro correspondente for gravada, um novo incidente será criado somente se o incidente anterior tiver sido fechado. No entanto, pode levar até três minutos para um incidente fechado ser limpo. Se uma entrada de registro correspondente for recebida nos três minutos após o encerramento de um incidente, o sistema poderá reabri-lo em vez de criar um novo incidente.
Ao criar uma política de alertas com base em registros, é possível especificar o tempo mínimo entre as notificações. Por exemplo, você seleciona 10 minutos como o tempo entre as notificações. Se a condição da sua política de alertas com base em registros for atendida duas vezes nesse período, você vai receber apenas uma notificação.
A taxa máxima de incidentes para políticas de alertas com base em registros é 1 incidente a cada 5 minutos. Se a consulta da sua política de alertas baseada em registros extrair valores de rótulo, cada combinação de valores extraídos representará a linha do tempo do incidente. Por exemplo, suponha que uma política de alertas com base em registros extraia os valores de um marcador e que o marcador possa ter dois valores. Com essa configuração, dois incidentes podem ser abertos, um para cada valor de rótulo, nos mesmos 5 minutos.
Há um limite de 20 incidentes por dia para cada política de alertas com base em registros. Se você atingir esse limite, a notificação incluirá uma mensagem informando que você atingiu o limite diário.
Os incidentes são fechados automaticamente quando o período de fechamento automático expira. Por padrão, a duração do fechamento automático é de 7 dias.
A duração do fechamento automático especifica o tempo que precisa decorrer, sem repetição da causa do incidente, antes do fechamento. Por esse motivo, quando um incidente está aberto e a causa dele ocorre novamente, ele pode permanecer aberto por mais tempo do que a duração do fechamento automático.
Para mais informações sobre como gerenciar incidentes para políticas de alertas com base em registros, consulte Gerenciar incidentes para políticas de alertas com base em registros.
Incidentes para políticas de alertas baseadas em SQL
Para políticas de alertas baseadas em SQL, o Cloud Monitoring cria um incidente na primeira vez que o resultado da consulta SQL atender à condição especificada na política. Cada política de alertas tem apenas um incidente aberto. Enquanto o incidente estiver aberto, se a condição for atendida novamente, o Monitoring não vai criar outros incidentes nem enviar notificações adicionais. O monitoramento fecha incidentes baseados em SQL após sete dias, a menos que você configure um período de fechamento de incidentes mais curto ou feche o incidente por conta própria.
Para mais informações sobre como gerenciar incidentes de políticas de alertas baseadas em SQL, consulte Gerenciar incidentes de 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 o Explorador de registros ou a API Cloud Monitoring. Você pode 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 o Log Analytics ou a API Cloud Monitoring. Você modifica e exclui 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 alertas no seu projeto Google Cloud . Esta lista inclui políticas que usam métricas e alertas com base em registros.
-
No console 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 alerta com base em registros aparecem na lista com o valor Logs na coluna Tipo. As políticas de alerta com base em métricas, incluindo 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. Configure esses canais antes de usá-los nas 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 requer autorização para o Cloud Logging e o Cloud Monitoring.
Para métricas com base em registros definidas pelo usuário, consulte Permissões de 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.
Custos e limites
Se você definir as próprias métricas com base em registros, as seguintes condições serão aplicadas:
- 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.
- É possível que você seja cobrado por métricas com base em registros definidas pelo usuário. Para mais informações sobre custos associados à ingestão de métricas, consulte Métricas sujeitas a cobrança.
- As políticas de alerta baseadas em SQL são executadas em uma reserva do BigQuery no projeto Google Cloud . Você pode ter cobranças por ter uma reserva do BigQuery. Para mais informações sobre os custos associados às reservas do BigQuery, consulte Preços do BigQuery.
Não há cobranças associadas ao uso de políticas de alertas com base em métricas com base em registros.
Os seguintes limites do Monitoring relacionados a políticas de alertas se aplicam:
| Categoria | Valor | Tipo de política1 |
|---|---|---|
| Políticas de alertas (soma da métrica e do registro) por escopo de métricas 2 | 500 | Métrica, Registro |
| 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 (prévia pública) | 1 | SQL |
| Tempo máximo de execução de consulta para uma política de alertas baseada em SQL (visualização pública) | 5 minutos | SQL |
| Período máximo que uma condição de ausência de métrica avalia3 |
1 dia | Métrica |
| Período máximo em que uma condição de limite de métrica é avaliada3 |
23 horas e 30 minutos | 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 |
| Taxa máxima de incidentes4 para alertas com base em registros |
1 incidente a cada 5 minutos | Registro |
| Número máximo de incidentes para alertas com base em registros |
20 incidentes por dia para cada política de alertas com base em registros | Registro |
| Número máximo de notificações por incidente5 para alertas baseados em registros |
20 notificações por dia por incidente | Registro |
| Número máximo de políticas de alerta acionadas simultaneamente por projeto |
80.000 | Todos |
| Número máximo de incidentes abertos simultaneamente por política de alertas |
1.000 | Todos |
| Período após o qual um incidente sem dados novos é fechado automaticamente |
7 dias | Métrica, SQL |
| Duração máxima de um incidente, se ele não for fechado manualmente | 7 dias | Registro |
| Retenção de incidentes fechados | 13 meses | Não relevante |
| Retenção de incidentes abertos | Indefinida | 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 alerta por adiamento | 16 | Todos |
| Retenção de uma soneca | 13 meses | Não relevante |
2Apigee e Apigee híbrida } estão profundamente integrados ao Cloud Monitoring. O limite de alerta para todos os níveis de assinatura da Apigee (Standard, Enterprise e Enterprise Plus) é o mesmo que para o Cloud Monitoring: 500 por escopo de métricas .
3O período máximo que uma condição avalia é a soma dos períodos de alinhamento e 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.
4Se a consulta da sua política de alertas baseada em registros extrair valores de rótulo, cada combinação de valores extraídos representará a linha do tempo do incidente. Por exemplo, suponha que uma política de alertas com base em registros extraia os valores de um marcador e que o marcador possa ter dois valores. Com essa configuração, dois incidentes podem ser criados, um para cada valor de rótulo, nos mesmos 5 minutos.
5Para alertas com base em registro, o Monitoring envia uma nova notificação para um incidente aberto quando uma entrada de registro que corresponde ao filtro é recebida e pelo menos cinco minutos se passaram desde a notificação mais recente. No máximo, 20 notificações por dia e por incidente são enviadas. Cada notificação é enviada para todos os canais de notificação configurados para a política de alertas.