Este documento descreve como pode usar o Cloud Monitoring para observar tendências nos seus dados de registo e para receber notificações quando ocorrem condições que especificar. Para fornecer ao Cloud Monitoring dados dos seus dados de registo, o Logging suporta as seguintes funcionalidades:
Pode gerar métricas personalizadas a partir das suas entradas de registo. Estas métricas são denominadas métricas baseadas em registos. Também pode criar políticas de alerta baseadas em métricas para receber uma notificação quando uma métrica baseada em registos cumpre uma condição. Para mais informações, consulte o artigo Visualize dados de entradas de registo com métricas baseadas em registos.
Pode usar políticas de alerta para monitorizar, quase em tempo real, quando uma mensagem aparece nas suas entradas de registo. Estas políticas de alerta são denominadas políticas de alerta baseadas em registos. Para mais informações, consulte o artigo Monitorize entradas de registo individuais para mensagens.
Pode escrever uma consulta SQL no Log Analytics e criar uma política de alerta que monitorize os resultados da consulta. Estas políticas de alerta são denominadas políticas de alerta baseadas em SQL. Para mais informações, consulte o artigo Monitorize os resultados das consultas SQL.
As políticas de alerta baseadas em SQL estão em Pré-visualização pública.
O resto deste documento descreve as diferenças entre estas três políticas de alerta e fornece informações sobre autorização, custos e limites.
Visualize dados de entradas de registo com métricas baseadas em registos
Quando quiser monitorizar eventos recorrentes nos dados de registo ao longo do tempo, use métricas baseadas em registos. As métricas baseadas em registos geram dados numéricos a partir dos dados de registo e são adequadas quando quer fazer qualquer uma das seguintes ações:
- Contar as ocorrências de uma mensagem, como um aviso ou um erro, nos dados de registo e receber uma notificação quando o número de ocorrências ultrapassa um limite.
- Observe tendências nos seus dados, como valores de latência nos seus dados de registo, e receba uma notificação quando os valores mudarem de forma inaceitável.
- Crie gráficos para apresentar os dados numéricos extraídos.
Uma vez que as métricas baseadas em registos geram dados numéricos a partir dos dados de registo, pode usar estas métricas em políticas de alerta e apresentá-las em gráficos. Para obter informações sobre como criar políticas de alerta e gráficos para métricas baseadas em registos, consulte o artigo Configure notificações para métricas baseadas em registos.
O Cloud Monitoring oferece um conjunto de métricas predefinidas baseadas em registos, e pode definir as suas próprias métricas. Para ver uma lista das métricas baseadas em registos definidas pelo sistema, clique no seguinte botão add_circle:
Métricas baseadas em registos definidas pelo utilizador
Pode criar métricas baseadas em registos para extrair dados numéricos dos seus dados de registo. As métricas baseadas em registos definidas pelo utilizador calculam valores a partir de entradas de registos incluídas e excluídas.
Por predefinição, as métricas baseadas em registos definidas pelo utilizador recolhem dados de todas as entradas de registo recebidas pelo Log Router no seu projeto Google Cloud , mas pode definir métricas baseadas em registos que recolhem dados de entradas de registo encaminhadas para um contentor de registos específico.
- Para obter informações sobre como definir e usar métricas baseadas em registos ao nível do projeto, consulte o artigo Usar métricas baseadas em registos.
- Para obter informações sobre a definição e a utilização de métricas baseadas em registos ao nível do contentor, consulte o artigo Métricas baseadas em registos em contentores de registos.
Se definir as suas próprias métricas baseadas em registos, pode incorrer em custos. Para mais informações acerca dos custos associados ao carregamento de métricas, consulte o artigo Métricas faturáveis.
Monitorize entradas de registo individuais para mensagens
Quando quiser receber uma notificação sempre que ocorrer uma mensagem específica numa entrada do registo, use políticas de alertas baseadas em registos. As políticas de alerta baseadas em registos são úteis para detetar eventos relacionados com a segurança em entradas de registo, como os seguintes:
- Quer receber uma notificação quando um evento aparece num registo de auditoria; por exemplo, quando um utilizador humano acede à chave de segurança de uma conta de serviço.
- A sua aplicação escreve mensagens de implementação nos registos e quer receber uma notificação quando uma alteração de implementação é registada.
As políticas de alerta baseadas em registos são úteis para eventos que espera que sejam raros e importantes. Não quer saber sobre uma tendência ou um padrão; quer saber que algo ocorreu.
As políticas de alerta baseadas em registos são definidas num projeto e analisam uma entrada de registo quando as seguintes condições são verdadeiras:
- A faturação está ativada.
- A entrada do registo tem origem num projeto.
Os destinos no projeto onde a entrada do registo tem origem ou num projeto para o qual a entrada do registo é encaminhada, encaminham a entrada do registo para um contentor de registos.
Por exemplo, suponha que uma entrada do registo tem origem no projeto
A. Se um destino de registo no projetoAencaminhar a entrada de registo para um contentor de registos, as políticas de alerta baseadas em registos definidas no projetoAanalisam a entrada de registo.Como segundo exemplo, suponha que uma entrada de registo tem origem no projeto
Xe que um destino de registo no projetoXencaminha a entrada de registo para o projetoY. Se um destino no projetoYencaminhar a entrada de registo para um contentor de registos, as políticas de alerta baseadas em registos definidas no projetoXe no projetoYanalisam a entrada de registo.
Não pode usar políticas de alerta baseadas em registos para monitorizar entradas de registo originadas em pastas, contas de faturação ou organizações, nem para monitorizar entradas de registo que não estejam armazenadas em contentores de registos. Se criar sinks agregados, estes sinks podem intercetar uma entrada de registo e impedir que seja encaminhada pelos sinks no projeto onde a entrada de registo tem origem.
Para obter informações sobre como criar políticas de alerta baseadas em registos, consulte o artigo Configure políticas de alerta baseadas em registos.
Monitorize os resultados das consultas SQL
Pode configurar políticas de alerta que usam o Log Analytics para executar consultas SQL nos dados de entradas de registo. Estes tipos de políticas de alerta são eficazes quando quer receber notificações com base em padrões que não podem ser avaliados por políticas de alerta baseadas em registos, como padrões complexos em entradas de registos ou agregações de dados de registos. Para mais informações, consulte o artigo Monitorize os resultados das consultas SQL com uma política de alertas.
Comparação das opções de alerta
Esta secção compara as políticas de alerta criadas com base em métricas baseadas em registos, políticas de alerta baseadas em registos e políticas de alerta baseadas em SQL.
Tabela de resumo
A tabela seguinte resume as técnicas de alerta e fornece links para informações adicionais:
| Políticas de alerta baseadas em métricas | Políticas de alerta baseadas em registos | Políticas de alerta baseadas em SQL | Mais informações |
|---|---|---|---|
| Com base em métricas derivadas de entradas de registo | Com base em strings em entradas de registo individuais | Com base em tabelas devolvidas por consultas SQL sobre entradas de registo | Métricas baseadas em registos Alertas baseados em registos Alertas baseados em SQL |
| Usado para lhe enviar notificações de tendências ao longo do tempo | Usado para lhe enviar uma notificação quando uma mensagem específica aparece num registo | Usado para enviar-lhe uma notificação sobre um padrão numa janela de entradas do registo | Métricas baseadas em registos Alertas baseados em registos Alertas baseados em SQL |
Calculado a partir de
|
Corresponde apenas às entradas do registo incluídas | Calculado a partir de entradas de registo numa janela deslizante | Entradas de registo disponíveis Alertas baseados em SQL |
| Operar em métricas de todos os projetos no âmbito das métricas do projeto de âmbito | Operar em entradas de registo que cumpram as seguintes condições:
|
Operar em vistas de registos acessíveis através de conjuntos de dados associados. Os conjuntos de dados associados podem estar em qualquer projeto. | Âmbito das métricas Conjuntos de dados associados |
| O incidente é criado quando o valor de uma métrica cumpre uma condição durante um período especificado | O incidente é criado sempre que uma entrada do registo específica corresponde a um filtro | O incidente é criado quando a tabela de resultados da consulta cumpre uma condição | Incidentes e notificações |
| Criadas e geridas na monitorização | Criado no Logging; gerido na monitorização |
Criado no Log Analytics; gerido na Monitorização | Criar e gerir políticas de alerta Alertas baseados em SQL |
| Visualizado na monitorização | Visualizado na monitorização | Visualizado na monitorização | Ver políticas de alerta |
| Pode usar qualquer canal de notificação suportado na monitorização | Pode usar qualquer canal de notificação suportado na monitorização | Pode usar qualquer canal de notificação suportado na monitorização | Canais de notificação |
Entradas do registo disponíveis
As métricas baseadas em registos definidas pelo utilizador são calculadas a partir de todas as entradas de registo recebidas pela API Logging para o Google Cloud projeto, independentemente de quaisquer filtros de inclusão ou filtros de exclusão que possam aplicar-se ao Google Cloud projeto. Se criar uma política de alertas com base numa métrica baseada em registos definida pelo utilizador, a política monitoriza os dados de todas as entradas de registo.
As métricas baseadas em registos definidas pelo sistema são calculadas apenas a partir de entradas de registo que foram armazenadas em contentores de registos noGoogle Cloud projeto. Se um registo tiver sido explicitamente excluído, não é incluído nestas métricas. Se criar uma política de alerta baseada numa métrica baseada em registos definida pelo sistema, a política monitoriza os dados apenas das entradas de registo incluídas.
As políticas de alerta baseadas em registos são definidas num projeto e analisam uma entrada de registo quando as seguintes condições são verdadeiras:
- A faturação está ativada.
- A entrada do registo tem origem num projeto.
Os destinos no projeto onde a entrada do registo tem origem ou num projeto para o qual a entrada do registo é encaminhada, encaminham a entrada do registo para um contentor de registos.
Por exemplo, suponha que uma entrada do registo tem origem no projeto
A. Se um destino de registo no projetoAencaminhar a entrada de registo para um contentor de registos, as políticas de alerta baseadas em registos definidas no projetoAanalisam a entrada de registo.Como segundo exemplo, suponha que uma entrada de registo tem origem no projeto
Xe que um destino de registo no projetoXencaminha a entrada de registo para o projetoY. Se um destino no projetoYencaminhar a entrada de registo para um contentor de registos, as políticas de alerta baseadas em registos definidas no projetoXe no projetoYanalisam a entrada de registo.
Não pode usar políticas de alerta baseadas em registos para monitorizar entradas de registo originadas em pastas, contas de faturação ou organizações, nem para monitorizar entradas de registo que não estejam armazenadas em contentores de registos. Se criar sinks agregados, estes sinks podem intercetar uma entrada de registo e impedir que seja encaminhada pelos sinks no projeto onde a entrada de registo tem origem.
As políticas de alerta baseadas em SQL consultam as vistas de registos em contentores de registos. Estes contentores de registos têm de ser atualizados para usar o Log Analytics e, em seguida, associados a um conjunto de dados do BigQuery. Para mais informações sobre políticas de alerta baseadas em SQL, consulte o artigo Monitorize os resultados das suas consultas SQL com uma política de alerta.
Monitorize métricas em vários projetos
Pode monitorizar métricas de vários projetos configurando um âmbito de métricas. Um âmbito de métricas lista todos os projetos e contas que monitoriza. Um projeto de âmbito aloja o âmbito das métricas. O projeto de âmbito armazena as políticas de alerta e outras configurações que cria para o âmbito das métricas. O projeto de âmbito de um âmbito de métricas é o projeto selecionado pelo Google Cloud seletor de projetos da consola.
As políticas de alerta baseadas em métricas baseadas em registos, como as políticas de alerta baseadas noutras métricas, funcionam em todos os projetos no âmbito das métricas do projeto de âmbito.
O âmbito das métricas não é relevante para as políticas de alerta baseadas em entradas de registo, como as políticas baseadas em registos e baseadas em SQL.
Para mais informações sobre os âmbitos das métricas, incluindo os âmbitos das métricas de vários projetos, e sobre a definição do âmbito dos projetos, consulte o seguinte:
Incidentes e notificações
Quando a condição de uma política de alerta é cumprida, o Monitoring abre um incidente e envia notificações para os canais de notificação da política de alerta. Para ver os detalhes do incidente, clique em Ver incidente na mensagem de notificação ou navegue diretamente para a página Incidentes na Monitorização.
Incidentes para políticas de alerta baseadas em métricas
As políticas de alerta baseadas em métricas baseadas em registos criam incidentes e notificações, como todas as outras políticas de alerta baseadas em métricas no Monitoring, conforme descrito em Comportamento dos alertas. Para mais informações sobre a gestão de incidentes para políticas de alerta baseadas em métricas, consulte o artigo Incidentes para políticas de alerta baseadas em métricas.
Incidentes para políticas de alerta baseadas em registos
As políticas de alerta baseadas em registos não são políticas de alerta baseadas em métricas. Quando uma entrada de registo cumpre a condição de uma política de alertas baseada em registos, o Monitoring cria incidentes e notificações da seguinte forma:
Quando o Cloud Logging escreve uma entrada de registo que corresponde à consulta da política de alerta num contentor de registos pela primeira vez, é criado um incidente e é enviada uma notificação. Se for escrita outra entrada de registo correspondente, é criado um novo incidente apenas se o incidente anterior tiver sido fechado. No entanto, a eliminação de um incidente encerrado pode demorar até três minutos. Quando é recebida uma entrada de registo correspondente nos três minutos após o encerramento de um incidente, o sistema pode reabrir esse incidente em vez de criar um novo.
Quando cria uma política de alertas baseada em registos, pode especificar o tempo mínimo entre as notificações. Por exemplo, se selecionar 10 minutos como o tempo entre notificações. Se a condição da sua política de alertas baseada em registos for cumprida duas vezes nesse período, recebe apenas uma notificação.
A taxa máxima de incidentes para políticas de alerta baseadas em registos é de 1 incidente a cada 5 minutos. Se a consulta da sua política de alertas baseada em registos extrair valores de etiquetas, cada combinação de valores extraídos representa a sua própria cronologia de incidentes. Por exemplo, suponha que uma política de alertas baseada em registos extrai os valores de uma etiqueta e que a etiqueta pode ter dois valores. Com esta configuração, podem ser abertos dois incidentes, um para cada valor de etiqueta, no mesmo período de 5 minutos.
Existe um limite de 20 incidentes por dia para cada política de alertas baseada em registos. Se atingir este limite, a notificação inclui uma mensagem a indicar que atingiu o limite para o dia.
Os incidentes são encerrados automaticamente quando a duração do encerramento automático expira. Por predefinição, a duração do encerramento automático é de 7 dias.
A duração do fecho automático especifica o tempo que tem de decorrer, sem repetição da causa do incidente, antes de o incidente ser fechado. Por este motivo, quando um incidente está aberto e a respetiva causa volta a ocorrer, o incidente pode permanecer aberto durante mais tempo do que a duração do fecho automático.
Para mais informações sobre a gestão de incidentes para políticas de alertas baseados em registos, consulte o artigo Faça a gestão de incidentes para políticas de alertas baseados em registos.
Incidentes para políticas de alerta baseadas em SQL
Para políticas de alerta baseadas em SQL, o Cloud Monitoring cria um incidente na primeira vez que o resultado da consulta SQL cumpre a condição especificada na política. Cada política de alerta tem apenas um incidente aberto. Enquanto o incidente estiver aberto, se a condição for novamente cumprida, o Monitoring não cria mais incidentes nem envia notificações adicionais. A monitorização fecha incidentes baseados em SQL após sete dias, a menos que configure um período de encerramento de incidentes mais curto ou encerre o incidente por si.
Para mais informações sobre a gestão de incidentes para políticas de alerta baseadas em SQL, consulte o artigo Faça a gestão de incidentes para políticas de alerta baseadas em SQL.
Criar e gerir políticas de alerta
Cria, modifica e elimina políticas de alerta com base em métricas baseadas em registos no Cloud Monitoring, tal como qualquer outra política de alerta baseada em métricas. Para mais informações, consulte o artigo Gerir políticas.
Pode criar políticas de alerta baseadas em registos através do Explorador de registos ou da API Cloud Monitoring. Modifica e elimina políticas de alertas baseadas em registos na monitorização ou com a API Cloud Monitoring. Para mais informações, consulte o artigo Gerir políticas de alertas baseadas em registos.
Pode criar políticas de alerta baseadas em SQL através do Log Analytics ou da API Cloud Monitoring. Modifica e elimina políticas de alerta baseadas em SQL no Monitoring ou através da API Cloud Monitoring. Para mais informações, consulte o artigo Monitorize os resultados das consultas SQL com uma política de alertas.
Visualizar políticas de alerta
A página Políticas na monitorização lista todas as políticas de alerta no seu Google Cloud projeto. Esta lista inclui políticas que usam métricas baseadas em registos e políticas de alertas baseadas em registos.
-
Na Google Cloud consola, aceda à página notifications Alertas:
Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.
- Selecione Ver todas as políticas.
As políticas de alerta baseadas em registos aparecem na lista com o valor Logs na coluna Tipo. As políticas de alerta baseadas em métricas, incluindo métricas baseadas em registos, aparecem na lista com o valor Metrics na coluna Tipo.
As políticas de alerta baseadas em SQL aparecem na lista com o valor SQL na coluna Tipos.
A captura de ecrã seguinte mostra um excerto de uma lista de políticas:
Canais de notificação
Pode enviar notificações de qualquer tipo de política de alerta para qualquer um dos canais de notificação suportados pela monitorização. Tem de configurar estes canais antes de os poder usar em políticas de alerta.
Para mais informações, consulte o artigo Faça a gestão dos canais de notificação.
Requisitos de autorização
A utilização de métricas baseadas em registos ou políticas de alerta baseadas em registos requer autorização para o Cloud Logging e o Cloud Monitoring.
Para métricas baseadas em registos definidas pelo utilizador, consulte as autorizações para métricas baseadas em registos.
Para políticas de alertas baseadas em registos, consulte o artigo Autorizações para políticas de alertas baseadas em registos.
Para políticas de alerta baseadas em SQL, consulte o artigo Autorizações para políticas de alerta baseadas em SQL.
Custos e limites
Se definir as suas próprias métricas baseadas em registos, aplicam-se as seguintes condições:
- Existem limites quanto ao número e à estrutura das métricas baseadas em registos definidas pelo utilizador. Para mais informações sobre estes limites, consulte os limites para métricas baseadas em registos.
- Pode incorrer em custos para métricas baseadas em registos definidas pelo utilizador. Para mais informações sobre os custos associados ao carregamento de métricas, consulte o artigo Métricas faturáveis.
- As políticas de alerta baseadas em SQL são executadas numa reserva do BigQuery no seu Google Cloud projeto. Pode incorrer em custos por ter uma reserva do BigQuery. Para mais informações acerca dos custos associados às reservas do BigQuery, consulte os preços do BigQuery.
Não existem cobranças associadas à utilização de políticas de alerta baseadas em métricas baseadas em registos.
Aplicam-se os seguintes limites de monitorização relacionados com políticas de alerta:
| Categoria | Valor | Tipo de política1 |
|---|---|---|
| Políticas de alertas (soma da métrica e do registo) por âmbito de métricas 2 | 2000 | Métrica, registo |
| Condições por política de alerta baseada em métricas | 6 | Métrica |
| Condições por política de alerta baseada em SQL (pré-visualização pública) | 1 | SQL |
| Tempo máximo de execução de consultas para uma política de alerta baseada em SQL (pré-visualização pública) | 5 minutos | SQL |
| Período máximo durante o qual uma condição de ausência de métricas é avaliada3 |
1 dia | Métrica |
| Período máximo durante o qual uma condição de limite de métricas é avaliada3 |
23 horas e 30 minutos | Métrica |
| Comprimento máximo do filtro usado numa condição de limite métrico |
2048 carateres Unicode | Métrica |
| Número máximo de séries cronológicas monitorizadas por uma condição de previsão |
64 | Métrica |
| Período de previsão mínimo | 1 hora (3600 segundos) | Métrica |
| Período de previsão máximo | 2,5 dias (216 000 segundos) | Métrica |
| Canais de notificação por política de alerta | 16 | Tudo |
| Taxa máxima de incidentes4 para alertas baseados em registos |
1 incidente a cada 5 minutos | Registo |
| Número máximo de incidentes para alertas baseados em registos |
20 incidentes por dia para cada política de alerta baseada em registos | Registo |
| Número máximo de notificações por incidente5 para alertas baseados em registos |
20 notificações por dia por incidente | Registo |
| Número máximo de políticas de alerta acionadas em simultâneo por projeto |
80 000 | Tudo |
| Número máximo de incidentes abertos em simultâneo por política de alerta |
1000 | Tudo |
| Período após o qual um incidente sem novos dados é fechado automaticamente |
7 dias | Métrica, SQL |
| Duração máxima de um incidente se não for fechado manualmente | 7 dias | Registo |
| Retenção de incidentes fechados | 13 meses | Não aplicável |
| Retenção de incidentes abertos | Indefinido | Não aplicável |
| Canais de notificação por âmbito das métricas | 4000 | Não aplicável |
| Número máximo de políticas de alerta por suspensão | 16 | Tudo |
| Retenção de uma suspensão | 13 meses | Não aplicável |
2Pode pedir para aumentar este limite do predefinido de 2000 políticas por âmbito de métricas até 10 000 políticas por âmbito de métricas.
3O período máximo durante o qual uma condição é avaliada é a soma do período de alinhamento e dos valores da janela de duração. Por exemplo, se o período de alinhamento estiver definido como 15 horas e o período de duração estiver definido como 15 horas, são necessárias 30 horas de dados para avaliar a condição.
4Se a consulta da sua política de alertas baseados em registos extrair valores de etiquetas, cada combinação de valores extraídos representa a sua própria cronologia de incidentes. Por exemplo, suponha que uma política de alertas baseada em registos extrai os valores de uma etiqueta e que a etiqueta pode ter dois valores. Com esta configuração, podem ser criados dois incidentes, um para cada valor de etiqueta, no mesmo período de 5 minutos.
5Para alertas baseados em registos, o Monitoring envia uma nova notificação para um incidente aberto quando é recebida uma entrada de registo que corresponde ao filtro e decorreram, pelo menos, 5 minutos desde a notificação mais recente. São enviadas, no máximo, 20 notificações por dia por incidente. Cada notificação é enviada para todos os canais de notificação configurados para a política de alertas.