Alertas de Google Cloud Monitoring por llamada con webhook

Cloud Monitoring envía correos, SMS y push, pero no llama. Lleva tus políticas de alertas de GCP a un webhook de llamada: configuración, campos y filtros.

Actualizado

Índice

Google Cloud Monitoring no puede llamar a tu teléfono. Sus canales de notificación son correo, SMS, la app móvil de Google Cloud, Slack, Google Chat, PagerDuty, Pub/Sub y webhooks, y la propia documentación de Google advierte que el SMS no es del todo fiable y que puede no estar disponible en tu región. Si quieres que una política de alertas suene como una llamada entrante, el camino más corto es un canal de webhook que apunte a un canal de llamada de Echobell, con dos líneas de plantilla y una condición.

Esta guía cubre el canal, el webhook, los campos que Cloud Monitoring envía realmente en el payload, cómo hacer que los incidentes "open" suenen y los "closed" no, y los ajustes de la política de alertas que deciden cada cuánto suena tu teléfono.

Por qué los canales integrados no bastan a las 3 de la mañana

  • El correo espera a que lo mires.
  • El SMS, en palabras de Google, no es un tipo de canal totalmente fiable, y puede que no se ofrezca en tu país. Además, No molestar lo silencia como a cualquier otro mensaje.
  • La app móvil envía un push corriente. Aparece en la pantalla bloqueada; no sigue sonando.
  • PagerDuty sí puede llamarte, pero es una plataforma de guardia completa, con su propia configuración y su propio contrato.

Un canal de webhook, en cambio, llega a cualquier cosa con un endpoint HTTPS público, y Cloud Monitoring le envía un documento JSON estructurado por cada incidente. Es todo lo que Echobell necesita.

Qué necesitas

  • Un proyecto de Google Cloud con al menos una política de alertas (o una verificación de tiempo de actividad sobre la que quieras alertar)
  • Permiso para editar canales de notificación (roles/monitoring.notificationChannelEditor o Monitoring Editor)
  • Echobell instalado (App Store / Google Play)
  • Diez minutos

Nada de tu proyecto tiene que aceptar tráfico entrante. Cloud Monitoring hace la petición saliente.

Paso 1 — Crea un canal que suene

En Echobell, crea un canal y pon su tipo de notificación en Llamada. Un canal de llamada se comporta como una llamada entrante en lugar de como un push, así que ocupa la pantalla y suena. Con el modo Concentración de iOS o No molestar activado, solo suena si tus ajustes de Concentración dejan pasar las llamadas.

Abre la Configuración avanzada del canal y activa Plantilla personalizada. Cloud Monitoring lo envuelve todo en un objeto incident, así que las plantillas leen campos anidados:

Título: {{incident.state}}: {{incident.policy_name}}
Cuerpo: {{incident.summary}}

Configura la plantilla de enlace para que tocar la notificación abra el incidente en la consola de Google Cloud:

{{incident.url}}

Añade una condición para que solo suenen los incidentes recién abiertos:

incident.state == "open"

Copia la URL del webhook del canal desde la vista de detalle:

https://hook.echobell.one/t/<channel-token>

Paso 2 — Añade un canal de notificación de webhook en Google Cloud

  1. Abre Monitoring → Alerting y haz clic en Edit notification channels
  2. En Webhooks, haz clic en Add new
  3. Endpoint URL: la URL de tu canal de Echobell del paso 1
  4. Display name: Echobell (call)
  5. Deja desactivado Use HTTP Basic Auth
  6. Haz clic en Test connection y luego en Save

Deja Basic Auth desactivado a propósito. El handshake de Basic Auth de Google espera que el endpoint responda a la primera petición con un 401 y una cabecera WWW-Authenticate; Echobell, en cambio, se autentica con el token secreto de la URL, así que trata esa URL como una contraseña.

Si gestionas los canales con Terraform, el mismo canal queda así:

resource "google_monitoring_notification_channel" "echobell_call" {
  display_name = "Echobell (call)"
  type         = "webhook_tokenauth"

  labels = {
    url = "https://hook.echobell.one/t/<channel-token>"
  }
}

No metas el token en el control de versiones: léelo de una variable o de Secret Manager en lugar de hacer commit de la URL.

Paso 3 — Asocia el canal a las políticas que merecen una llamada

Abre una política de alertas, ve a Notifications and name y añade Echobell (call) en Notification channels. Una política puede notificar a varios canales a la vez, así que mantén al lado tu canal de correo o de Slack.

Sé exigente aquí. Este es el filtro de verdad: un canal asociado solo a "la API de producción está caída" y "la base de datos se ha quedado sin disco" suena tan pocas veces que seguirás contestando. Deja "CPU por encima del 70 % durante cinco minutos" en el correo.

Dos ajustes de esa misma página determinan lo que llega a tu teléfono:

  • Notify on incident closure. Si está activado, Cloud Monitoring también envía una notificación cuando el incidente se cierra. La condición incident.state == "open" del paso 1 evita que esa suene; el paso 6 muestra cómo recibirla en silencio.
  • Incident autoclose duration. Si la métrica deja de enviar datos, los incidentes abiertos se cierran pasado este periodo. Déjalo en el valor por defecto salvo que tengas un motivo para cambiarlo.

Paso 4 — Conoce el aspecto real del payload

Cloud Monitoring envía por defecto la versión 1.2 del esquema. Recortado a los campos que probablemente uses, un incidente abierto tiene este aspecto:

{
  "version": "1.2",
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "my-project",
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.opqiw61fsv7p?project=my-project",
    "state": "open",
    "renotify": false,
    "started_at": 1794713564,
    "ended_at": null,
    "policy_name": "Prod API 5xx rate",
    "condition_name": "5xx ratio above 5%",
    "resource_display_name": "prod-api",
    "threshold_value": "0.05",
    "observed_value": "0.183",
    "severity": "Critical",
    "policy_user_labels": {
      "team": "payments"
    },
    "documentation": {
      "content": "Check the latest deploy first. Runbook: https://wiki.example.com/api-5xx",
      "mime_type": "text/markdown"
    },
    "summary": "5xx ratio for prod-api with metric labels {response_code_class=500} is above the threshold of 0.050 with a value of 0.183."
  }
}

Cosas que conviene saber antes de editar una plantilla:

  • Todo vive bajo incident. {{policy_name}} se renderiza vacío; {{incident.policy_name}}, no.
  • state vale open o closed. De ese único campo dependen la condición y la plantilla del título.
  • summary es texto generado. Google no garantiza un formato estable, así que muéstralo, pero no lo compares en una condición.
  • Puede faltar algún campo. Google indica que algunos campos no aparecen o llegan como null según la política y el estado del incidente. En Echobell, un campo ausente se renderiza como cadena vacía, así que la plantilla sigue funcionando; simplemente no bases una condición en un campo que tus políticas no rellenan.
  • documentation.content es tuyo. Lo que escribas en el cuadro Documentation de la política llega aquí. Una instrucción de una línea ("Revisa primero el último despliegue") es más útil en un teléfono que suena que el resumen generado.
  • La gravedad la marca la política. Es el nivel que hayas configurado en la política. Envíate un incidente de prueba y comprueba el valor exacto antes de filtrar por él.

Un cuerpo que empieza con tus propias palabras y recurre al resumen como respaldo:

{{incident.documentation.content}}
{{incident.summary}}

Paso 5 — Decide qué suena y con qué frecuencia

Casi todo el filtrado ya ocurrió al elegir qué políticas reciben el canal. La condición del canal de Echobell se encarga del resto.

ObjetivoCondición
Sonar solo cuando se abre un incidenteincident.state == "open"
Sonar una vez, no con cada recordatorioincident.state == "open" && !incident.renotify
Sonar solo con las políticas de un equipoincident.state == "open" && incident.policy_user_labels.team == "payments"
Sonar solo de madrugada (00:00–07:00 UTC)incident.state == "open" && hour < 7

Recordatorios. Una política puede reenviar notificaciones mientras el incidente siga abierto: en la API es alertStrategy.notificationChannelStrategy[].renotifyInterval, entre 30 minutos y 24 horas. Esas repeticiones llegan con renotify: true. Que suenen o no es una decisión tuya: volver a sonar es un escalado tosco pero eficaz para un incidente que nadie ha arreglado, y omitirlas evita que una caída larga suene toda la noche. La segunda fila de la tabla es la que las omite.

Etiquetas de usuario. Las etiquetas de usuario de la política, como team: payments, viajan en policy_user_labels. Una condición sobre ellas permite que un canal asociado a muchas políticas suene con algunas y se quede en silencio con el resto. Filtran, no enrutan: cada URL de webhook activa siempre el mismo canal de Echobell, así que una etiqueta no puede enviar un incidente al canal de otra persona.

Las variables de tiempo de Echobell están en UTC, así que convierte desde tu zona horaria primero. La referencia de condiciones lista todas las variables.

Paso 6 — Dale a los cierres una puerta más silenciosa

Con Notify on incident closure activado, un incidente cerrado es una buena noticia que conviene ver, pero no merece una llamada. Crea un segundo canal de Echobell de tipo Urgente (Time Sensitive) (o normal) con las mismas plantillas y sin condición, añádelo en Google Cloud como un segundo canal de webhook y asocia ambos a la política. La plantilla del título ya se lee como "closed: Prod API 5xx rate".

Canal de EchobellCondiciónTipo de canalComportamiento
gcp-callincident.state == "open"LlamadaSuena como una llamada entrante
gcp-logningunaUrgente o NormalCada apertura, recordatorio y cierre, sin sonar

Pruébalo antes de fiarte

Prueba primero el lado de Echobell. Envía un payload con la forma del de Cloud Monitoring:

curl -X POST https://hook.echobell.one/t/<channel-token> \
  -H 'Content-Type: application/json' \
  -d '{"version":"1.2","incident":{"state":"open","renotify":false,"policy_name":"Manual test","summary":"Testing the Echobell path","url":"https://console.cloud.google.com/monitoring/alerting"}}'

Después prueba el lado de Google. El botón Test connection envía un payload de ejemplo cuyos campos no corresponden a un incidente real, así que puede no cumplir tu condición. Para una prueba de extremo a extremo, crea una política desechable con un umbral que ya superes —por ejemplo, uso de CPU de la VM por encima del 1 %—, asóciale Echobell (call), espera a que salte y luego borra la política.

Si el curl suena y la política real no, el problema está en el lado de Google —el canal no está asociado, la condición aún no se ha cumplido durante su duración o la URL del endpoint se copió mal—, no en el canal de Echobell.

Alertas basadas en logs y verificaciones de tiempo de actividad

  • Las verificaciones de tiempo de actividad no avisan a nadie por sí solas; alimentan una política de alertas. Crea la política desde la propia verificación y asóciale el mismo canal de webhook.
  • Las políticas de alertas basadas en logs solo notifican cuando se abre un incidente —Google no envía notificación de cierre para ellas— y exigen un límite de frecuencia de notificaciones, que acota cada cuánto puede sonarte una línea de log ruidosa. La condición incident.state == "open" sigue funcionando; el canal de cierres, sencillamente, nunca recibe nada de estas políticas.

Límites que importan durante un incidente

  • 1 MiB de cuerpo. Echobell rechaza con HTTP 413 los cuerpos de disparador de más de 1 MiB. Un incidente de Cloud Monitoring ocupa unos pocos kilobytes.
  • 120 peticiones por minuto y token. Por encima, el disparador responde 429 con RATE_LIMIT_EXCEEDED y un Retry-After. Una sola política rara vez se acerca, pero decenas de políticas saltando a la vez durante una caída regional sí pueden: otro motivo para mantener corta la lista del canal de llamada.
  • 1500 bytes de cuerpo de notificación. Los renders más largos se truncan. Mantén breve la documentación de la política, o pon en ella el enlace al runbook en lugar del runbook entero.

Lo que este montaje no te da

  • Sin confirmación. Responder la llamada no confirma ni cierra el incidente en Google Cloud.
  • Sin escalado ni rotación. Se llama a todos los suscritos al canal; a nadie después.
  • Sin deduplicación más allá del incidente. Una condición intermitente abre un incidente nuevo cada vez, y cada uno suena. Arréglalo en la política con una ventana de duración más larga.

Si eso es inaceptable, lo que necesitas es una plataforma de guardia completa. Si lo que necesitas es "llámame cuando salte la política de producción", esto son dos pantallas de la consola.

Resolución de problemas

El incidente se abrió pero no llegó nada. Abre el incidente en Monitoring → Alerting y comprueba que la política incluye el canal de webhook. Asegúrate de que la URL del endpoint es la URL completa de Echobell, con el token incluido.

La notificación llegó pero no sonó. El tipo de canal no es Llamada, o los ajustes de Concentración de tu teléfono no dejan pasar las llamadas. Revisa el canal y tu configuración de Concentración.

La notificación está en blanco. La plantilla lee campos de nivel superior. Antepón incident.: {{incident.policy_name}}, no {{policy_name}}.

Vuelve a sonar cada media hora. La política tiene un intervalo de renotificación. Quítalo o añade !incident.renotify a la condición.

Suena cuando el incidente se cierra. A la condición le falta incident.state == "open", o está en el canal equivocado.

Preguntas frecuentes

¿Puede Google Cloud Monitoring llamar a un número de teléfono de forma nativa?

No. Los canales de notificación son correo, SMS, la app móvil de Google Cloud, Slack, Google Chat, PagerDuty, Pub/Sub y webhooks. Una llamada de voz necesita un servicio externo: una plataforma de guardia o un webhook de llamada como Echobell.

¿Necesito Pub/Sub o una Cloud Function?

No. Cloud Monitoring envía el incidente a la URL del webhook por sí mismo. Pub/Sub es lo que Google recomienda para endpoints que no son públicos; el endpoint de Echobell es público, así que el canal de webhook basta.

¿Una alerta de Cloud Monitoring atraviesa No molestar?

Solo si llega como alerta tipo llamada. Un canal de Echobell de tipo llamada se comporta como una llamada entrante, que el modo Concentración y No molestar de iOS dejan pasar cuando tus ajustes de Concentración permiten las llamadas. Un SMS o un push normal, no. Activa también Reintentar llamada fallida: con «Permitir llamadas repetidas» activado en tus ajustes de Concentración, una segunda llamada en menos de tres minutos puede sonar.

¿Debo usar la opción Basic Auth del webhook?

No. Echobell se autentica con el token de la URL. El flujo de Basic Auth de Google espera primero un desafío 401, que Echobell no envía.

¿Puedo llamar a personas distintas según la política?

Sí. Crea un canal de Echobell por audiencia, añade la URL de cada canal a Google Cloud como su propio canal de webhook y asocia cada uno a las políticas de las que se ocupa esa audiencia. Una URL de webhook activa siempre el mismo canal de Echobell, así que una condición con policy_user_labels puede silenciar políticas en ese canal, pero no pasarlas a otro. No hay confirmación, así que se llama a todos los suscritos con "llamada".

¿Y si tengo varios proyectos?

Un canal de notificación pertenece a un solo proyecto. Crea el canal de webhook en cada proyecto —la misma URL de Echobell sirve en todos— o alerta desde un proyecto de alcance que supervise a los demás.

Cierre

El camino son cuatro piezas: un canal de llamada con la condición incident.state == "open", un canal de notificación de webhook que apunte a él, una lista corta de políticas que merezcan una llamada y una prueba real antes de fiarte. Todo lo demás trata de mantener esa lista lo bastante corta como para que dentro de un mes una llamada siga significando algo.

Descarga Echobell para iPhone o consíguelo en Google Play, y luego apunta a él tu política de alertas más importante.

Artículos relacionados