Configurar notificações para métricas com base em registros
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Este documento explica como configurar notificações quando uma
métrica com base em registros corresponde aos critérios especificados. Estas instruções, que mostram como criar uma política de alertas e configurar canais de notificação, são para o console do Google Cloud . Também é possível criar
políticas de alertas usando a
API Cloud Monitoring
e o comando da Google Cloud CLI
gcloud alpha monitoring policies.
As políticas de alertas que monitoram métricas com base em registros não podem extrair dados de entradas de registro. Se você quiser que uma notificação extraia dados de uma entrada de registro, crie um alerta com base em registros.
Antes de começar
Verifique se seu papel do Identity and Access Management inclui as permissões necessárias para
criar e visualizar métricas com base em registros e criar políticas de alertas.
Para mais detalhes, consulte
Permissões de métricas com base em registros.
Configure os canais de notificação que você quer usar para receber notificações. Para informações sobre essas etapas, consulte
Criar e gerenciar canais de notificação.
Criar uma política de alertas em uma métrica de contagem
Com uma política de alertas, é possível descrever um conjunto de condições que você queira monitorar.
Ao criar uma política de alertas, você também precisa especificar as condições: o que é monitorado e quando enviar notificações. As notificações
incluem informações sobre o incidente e botões que permitem
visualizar registros relevantes e detalhes do incidente:
Para criar uma política de alertas que compare o valor de uma métrica de contador com base em registros a um limite, faça o seguinte:
No console Google Cloud , acesse a página Métricas com base em registros:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Logging.
Encontre a métrica que você quer monitorar,
clique em more_vertMais
e selecione Criar alerta com base na métrica.
Verifique se o campo Selecionar uma métrica lista um
metric.type e um resource.type. Se necessário,
adicione uma cláusula resource.type.
Por exemplo, o filtro a seguir especifica uma métrica e um recurso:
metric.type="logging.googleapis.com/byte_count"
AND resource.type="gce_instance"
No menu Janela contínua, recomendamos que você selecione um valor de pelo menos 10 minutos. Em particular, esse valor precisa ser grande o suficiente para garantir que várias entradas de registro que correspondam ao seu filtro sejam contadas.
Por exemplo, se uma métrica baseada em registros contar entradas de registro de "pulsação",
que são esperadas a cada N minutos, defina o valor do menu
Janela rotativa como 2N minutos ou 10 minutos,
o que for maior.
Clique em Próxima e selecione Limite.
Insira um Valor do limite e, opcionalmente, configure os campos
Gatilho do alerta e Posição do limite.
Opcional: atualize a Janela de novo teste e use os campos Opções avançadas para configurar como a política de alertas lida com dados ausentes. Em geral, a configuração padrão é adequada.
Clique em Próxima, em Canais de notificação e selecione os canais que você quer usar para a política de alertas.
Opcional: na seção Documentação, insira as informações que
você quer incluir nas notificações. Normalmente, as informações incluem
instruções sobre como responder à notificação.
Não inclua a extração de rótulos de entradas de registro na sua documentação.
As políticas de alertas que monitoram uma métrica com base em registros não podem extrair dados de entradas de registro.
No campo Nomear a política de alertas,
digite um nome para a política.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-11 UTC."],[],[],null,["# Configure notifications for log-based metrics\n\nThis document explains how to configure notifications when a\nlog-based metric matches criteria that you specify. These instructions,\nwhich guide you through creating an alerting policy and configuring\nnotification channels, are for the Google Cloud console. You can also create\nalerting policies by using the\n[Cloud Monitoring API](/monitoring/alerts/using-alerting-api)\nand by using the Google Cloud CLI command\n[`gcloud alpha monitoring policies`](/sdk/gcloud/reference/alpha/monitoring/policies).\n\nAlerting policies that monitor log-based metrics can't extract data from\nlog entries. If you want a notification to extract data from a log entry,\nthen [create a log-based alert](/logging/docs/alerting/log-based-alerts).\n\nBefore you begin\n----------------\n\n1. Verify that your Identity and Access Management role includes the permissions required to\n create and view log-based metrics, and to create alerting policies.\n For details, see\n [Log-based metric permissions](/logging/docs/access-control#metrics-permissions).\n\n2. Verify that you are familiar with log-based metrics. For more information,\n see [Overview of log-based metrics](/logging/docs/logs-based-metrics).\n\n3. Configure the notification channels that you want to use to receive any\n notifications. For information about these steps, see\n [Create and manage notification channels](/monitoring/support/notification-options).\n\nCreate an alerting policy on a counter metric\n---------------------------------------------\n\nAn alerting policy describes a set of conditions that you want to monitor.\nWhen you create an alerting policy, you must also specify its conditions: what\nis monitored and when to send notifications. Notifications\ninclude information about the incident, and they include buttons that let\nyou view relevant logs and incident details:\n\nTo create an alerting policy that compares the value of a\nlog-based counter metric to a threshold, do the following:\n\n1. In the Google Cloud console, go to the **Log-based Metrics** page:\n\n [Go to **Log-based Metrics**](https://console.cloud.google.com/logs/metrics)\n\n \u003cbr /\u003e\n\n If you use the search bar to find this page, then select the result whose subheading is\n **Logging**.\n2. Find the metric that you want to monitor,\n click *more_vert* **More** ,\n and then select **Create alert from metric**.\n\n3. Verify that the **Select a metric** field lists a\n `metric.type` and a `resource.type`. If necessary,\n add a `resource.type` clause.\n\n For example, the following filter specifics a metric and a resource: \n\n metric.type=\"logging.googleapis.com/byte_count\"\n AND resource.type=\"gce_instance\"\n\n4. In the **Rolling window** menu, we recommend that you select a value that\n is at least 10 minutes. In particular, this value should\n be large enough to make sure that multiple log entries that match your\n filter are counted.\n\n For example, if a log-based metric counts \"heartbeat\" log entries,\n which are expected every `N` minutes, then set the value of the\n **Rolling window** menu to `2N` minutes or 10 minutes,\n whichever is larger.\n | **Note:** Log-based metric data can have gaps and those gaps can result in false notifications. Increasing the value of the **Rolling window** menu can reduce the risk of false notifications. For more information, see [Troubleshoot: Metric is missing logs data](/logging/docs/logs-based-metrics/troubleshooting#slow-startup).\n5. Click **Next** , select **Threshold**.\n\n6. Enter a **Threshold value** , and optionally, configure the\n **Alert trigger** and **Threshold position** fields.\n\n7. Optional: Update the **Retest window** and use the\n **Advanced Options** fields to configure how the alerting policy\n handles missing data. Typically, the default setting is appropriate.\n\n8. Click **Next** , click **Notification channels**, and then select the\n notification channels that you want to use for the alerting policy.\n\n9. Optional: In the **Documentation** section, enter any information that\n you want included in notifications. Typically, the information includes\n information about how to respond to the notification.\n\n Don't include label extraction from log entries in your documentation.\n Alerting policies that monitor a log-based metric can't extract data from\n log entries.\n10. In the **Name the alert policy** field,\n enter a name for the alerting policy.\n\n11. Click **Create policy**.\n\nTroubleshooting\n---------------\n\nIf you encounter issues, then see\n[Troubleshoot log-based metrics](/logging/docs/logs-based-metrics/troubleshooting).\n\nWhat's next\n-----------\n\n- For more information about alerting policies, see the following documents:\n\n - [Introduction to alerting](/monitoring/alerts)\n - [Managing alerting policies](/monitoring/alerts/using-alerting-api)\n- To chart your log-based metric, see\n [View your log-based metrics](/logging/docs/logs-based-metrics/view_your_log_based_metrics).\n\n- For information about how to monitor Cloud Logging and Cloud Monitoring\n usage and receive notifications you when you approach the threshold for\n billing, see [Monitor and optimize Google Cloud Observability costs](/stackdriver/docs/observability/pricing-optimize-and-monitor)."]]
