Neste documento, descrevemos como usar o Cloud Monitoring para observar tend�ncias nos registros e notificar voc� quando as condi��es descritas ocorrerem. Para fornecer dados ao Cloud Monitoring dos registros, o Logging oferece o seguinte:
- M�tricas com base em registros, que podem ser usadas da seguinte maneira:
- Para criar pol�ticas de alertas que avisem voc� sobre altera��es ao longo do tempo.
- Para criar gr�ficos que mostrem mudan�as ao longo do tempo.
- Pol�ticas de alertas com base em registros, que notificam voc� sempre que um evento espec�fico aparecem em um registro.
Quando quiser monitorar seus registros ao longo do tempo, use gr�ficos ou pol�ticas de alertas com base em m�tricas com base em registros.
Quando voc� quiser receber uma notifica��o quase em tempo real de que uma mensagem apareceu nos registros, use uma pol�tica de alertas com base em registros.
O restante deste documento descreve como escolher entre m�tricas com base em registros e pol�ticas de alertas com base em registros, discute as diferen�as entre eles e fornece informa��es sobre autoriza��o, custos e limites.
M�tricas com base em registros
Quando voc� quiser monitorar eventos recorrentes nos registros 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 registros. As m�tricas com base em registros ser�o adequadas se voc� quiser realizar uma destas a��es:
- Contar as ocorr�ncias de uma mensagem, como um aviso ou erro, nos registros e receber 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 registros, e receba uma notifica��o se eles mudarem de maneira inaceit�vel.
- Crie gr�ficos para exibir os dados num�ricos extra�dos dos registros.
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 registros. As métricas com base em registros definidas pelo usuário calculam valores dos registros incluídos e excluídos.
Por padrão, as métricas com base em registros definidas pelo usuário coletam dados de todos os registros recebidos pelo Roteador de registros no seu projeto do Google Cloud, mas você pode definir métricas com base em registros que coletam dados de registros roteados para um bucket de registro 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 os custos associados ingestão de métricas, consulte Métricas sujeitas a cobrança.
Alertas com base em registros
Quando você quiser ser notificado sempre que uma mensagem específica ocorrer em um registro, use políticas de alertas baseadas em registro. As pol�ticas de alertas com base em registros s�o �teis para detectar eventos relacionados � seguran�a nos registros, como estes:
- 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.
Para informa��es sobre como criar pol�ticas de alertas com base em registros, consulte Como usar as pol�ticas de alertas com base em registros pol�ticas de alertas.
� poss�vel configurar uma pol�tica de alertas com base em m�tricas para simular uma e a pol�tica de alertas. Para isso, defina uma m�trica com base em registros e use a em uma pol�tica de alertas com base em m�tricas com limite de um. Com essas pol�ticas, voc� tem um comportamento sem a necessidade de criar uma m�trica com base em registros e configurar uma pol�tica de alertas com base em m�tricas.
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.
Tabela de resumo
A tabela a seguir resume as t�cnicas de alerta e fornece links para outras informa��es neste documento:
| Incidentes de m�tricas com base em registros | Pol�ticas de alertas com base em registros | Mais informa��es |
|---|---|---|
| Com base nas m�tricas derivadas de entradas de registro | Com base em strings em entradas de registro individuais | M�tricas com base em registros e Alertas com base em registros |
| Usado para notificar voc� sobre tend�ncias ao longo do tempo | Usado para notificar voc� quando uma mensagem espec�fica aparece em um registro | M�tricas com base em registros e Alertas com base em registros |
Calculado com base em
|
Corresponder apenas a registros inclu�dos | Registros dispon�veis |
| Opere nas m�tricas de todos os projetos no escopo de m�tricas do projeto de escopo | Operar em registros somente no projeto do escopo | Como fazer alertas em v�rios projetos |
| Acionado quando o valor de uma m�trica atende a uma condi��o por um per�odo especificado | Acionado sempre que uma entrada de registro espec�fica corresponde a um filtro | Incidentes e notifica��es |
| Criado e gerenciado no Monitoring | Criado no Logging: gerenciado no Monitoring |
Como criar e gerenciar pol�ticas de alerta |
| 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 | Canais de notifica��o |
Registros dispon�veis
As m�tricas com base em registros definidas pelo usu�rio s�o calculadas com base em todos os registros recebidos pela API Logging no projeto do Google Cloud, independentemente dos filtros de inclus�o ou filtros de exclus�o que podem ser aplicados 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, ela monitorar� dados de todos os registros.
As m�tricas com base em registros definidas pelo sistema s�o calculadas apenas com base nos registros. que foram armazenadas em buckets projeto do Google Cloud. Se um registro foi explicitamente exclu�do exclu�do, 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 dos registros inclu�dos.
As pol�ticas de alertas com base em registros operam apenas nos registros inclu�dos. N�o � poss�vel usar pol�ticas de alertas com base em registros para notificar voc� sobre mensagens em registros exclu�dos.
As m�tricas e pol�ticas de alertas com base em registros operam na escopo do projeto do Google Cloud, n�o em buckets individuais.
Como fazer alertas 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 para um o escopo de m�tricas � o projeto escolhido pelo seletor de projetos do console do Google Cloud.
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.
As pol�ticas de alertas com base em registros n�o operam em escopos de m�tricas. os registros projetos que n�o fazem parte de um escopo de m�tricas. Pol�tica de alertas com base em registros avalia apenas os registros originados no projeto atual ou que s�o encaminhados para o projeto atual.
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.
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.
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 registro, um incidente � criado e uma notifica��o � enviada. Se outra entrada de registro correspondente for gravada, criados somente se o incidente anterior foi encerrado. 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 notifica��es para pol�ticas de alertas com base em registros � 1 notifica��o a cada 5 minutos para cada pol�tica de alertas com base em registros. No entanto, se a consulta da sua pol�tica de alertas com base em registros extrair valores de r�tulo, cada combina��o de valores extra�dos representar� a pr�pria linha do tempo de notifica��o. Por exemplo, suponha que uma pol�tica de alerta com base em registros extraia os valores de um r�tulo. Suponha que o r�tulo possa ter dois valores. Com essa configura��o, voc� pode receber duas notifica��es, uma para valor de cada r�tulo, no mesmo 5 minutos.
H� um limite de 20 notifica��es 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 ap�s sete dias, a menos que voc� configure um per�odo mais curto ou feche os incidentes manualmente.
Para mais informa��es sobre como gerenciar esses incidentes, consulte Como gerenciar incidentes para pol�ticas de alertas com base em registros.
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. Para mais informa��es, consulte Como gerenciar pol�ticas de alertas com base em registros.
Como visualizar pol�ticas de alertas
A p�gina Pol�ticas no Monitoring lista todos os e pol�ticas de alertas no seu projeto do Google Cloud. Esta lista inclui pol�ticas que usam m�tricas e 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 Monitoramento.
- Selecione Ver todas as pol�ticas.
As pol�ticas de alertas com base em registros aparecem na lista com o valor Logs no
Coluna Type. Pol�ticas de alertas com base em m�tricas, incluindo com base em registros
ser�o exibidas na lista com o valor Metrics na coluna Tipo.
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 pol�ticas de alertas com base em m�tricas e registros qualquer um dos canais de notifica��o compat�veis com o Monitoring. Voc� precisa configurar esses canais antes de poder us�-los em pol�ticas de alertas.
Para saber mais, consulte Como gerenciar canais de notifica��o.
Requisitos de autoriza��o
O uso de m�tricas com base em registros 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.
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.
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 | 6 | M�trica |
| 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 | M�trica, Registro |
| Taxa m�xima de notifica��es4 | 1 notifica��o a cada 5 minutos para cada pol�tica de alertas com base em registros | Registro |
| N�mero m�ximo de notifica��es | 20 notifica��es por dia para cada pol�tica de alertas com base em registros | Registro |
| N�mero m�ximo de incidentes abertos simultaneamente por pol�tica de alertas |
1.000 | M�trica |
| Per�odo ap�s o qual um incidente sem dados novos � fechado automaticamente |
7 dias | M�trica |
| 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 soneca | 16 | M�trica, Registro |
| Reten��o de um adiamento | 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 pol�tica de alertas com base em registros extrair valores de r�tulo, e cada combina��o de valores extra�dos representa seu pr�prio cronograma de notifica��o. Por exemplo, imagine que um modelo a pol�tica de alertas extrai os valores de um r�tulo. Suponha que o r�tulo possa ter dois valores. Com essa configura��o, voc� pode receber duas notifica��es, uma para cada valor de r�tulo, nos mesmos 5 minutos.