Configura notificaciones para métricas basadas en registros
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En este documento, se explica cómo configurar notificaciones cuando una métrica basada en registros coincide con los criterios que especificas. Estas instrucciones, que te guían para crear una política de alertas y configurar canales de notificaciones, son para la consola de Google Cloud . También puedes crear políticas de alertas con la API de Cloud Monitoring y con el comando gcloud alpha monitoring policies de Google Cloud CLI.
Las políticas de alertas que supervisan métricas basadas en registros no pueden extraer datos de las entradas de registro. Si deseas que una notificación extraiga datos de una entrada de registro, crea una alerta basada en registros.
Antes de comenzar
Verifica que tu rol de Identity and Access Management incluya los permisos necesarios para crear y ver métricas basadas en registros, y para crear políticas de alertas.
Para obtener más información, consulta Permisos de métricas basadas en registros.
Crea una política de alertas en una métrica de contador
Una política de alertas describe el conjunto de condiciones que deseas supervisar.
Cuando creas una política de alertas, también debes especificar sus condiciones: qué se supervisa y cuándo enviar notificaciones. Las notificaciones incluyen información sobre el incidente y botones que te permiten ver los registros pertinentes y los detalles del incidente:
Para crear una política de alertas que compare el valor de una métrica de contador basada en registros con un umbral, haz lo siguiente:
En la consola de Google Cloud , ve a la página Métricas basadas en registros:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.
Busca la métrica que deseas supervisar, haz clic en more_vertMás y, luego, selecciona Crear alerta a partir de métricas.
Verifica que el campo Seleccionar una métrica muestre un metric.type y un resource.type. Si es necesario, agrega una cláusula resource.type.
Por ejemplo, el siguiente filtro especifica una métrica y un recurso:
metric.type="logging.googleapis.com/byte_count"
AND resource.type="gce_instance"
En el menú Ventana progresiva, te recomendamos que selecciones un valor de al menos 10 minutos. En particular, este valor debe ser lo suficientemente grande como para garantizar que se cuenten varias entradas de registro que coincidan con tu filtro.
Por ejemplo, si una métrica basada en registros cuenta las entradas de registro de "latido", que se esperan cada N minutos, establece el valor del menú Ventana móvil en 2N minutos o 10 minutos, el que sea mayor.
Haz clic en Siguiente y selecciona Umbral.
Ingresa un Valor del umbral y, de manera opcional, configura los campos Activador de alertas y Posición del umbral.
Opcional: Actualiza el Período de nueva prueba y usa los campos de Opciones avanzadas para configurar cómo la política de alertas controla los datos faltantes. Por lo general, el parámetro de configuración predeterminado es adecuado.
Haz clic en Siguiente, luego en Canales de notificaciones y, luego, selecciona los canales de notificaciones que deseas usar para la política de alertas.
Opcional: En la sección Documentación, ingresa la información que quieras incluir en las notificaciones. Por lo general, la información incluye cómo responder a la notificación.
No incluyas la extracción de etiquetas de las entradas de registro en tu documentación.
Las políticas de alertas que supervisan una métrica basada en registros no pueden extraer datos de las entradas de registro.
En el campo Asigna un nombre a la política de alertas, ingresa un nombre para la política de alertas.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-05 (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)."]]
