Alertas de Sentry en tu teléfono: notificaciones push para errores, sin código

Sentry detecta la excepción en el momento en que ocurre. Luego te envía un correo o publica en un canal de Slack que también recibe mensajes de despliegues, recordatorios de la reunión diaria y unos cientos de cosas más. Si el error ocurre a las 2 a. m. o mientras no estás frente al portátil, te enteras cuando lo hace un usuario.
Las alertas de Sentry pueden hacerlo mejor, pero Sentry no tiene una aplicación push propia para las alertas. Lo que sí tiene es un webhook que se dispara cuando una regla de alerta coincide. Apúntalo a Pocket Alert y cada alerta se convierte en una notificación push en tu teléfono, con el título del error, el origen y un botón que abre la incidencia. Sin servidor y sin código.
Lo que necesitas
- Una organización de Sentry en la que puedas crear integraciones y alertas.
- Una cuenta de Pocket Alert con la aplicación instalada en tu teléfono iPhone o Android. El plan gratuito incluye un webhook, que es todo lo que necesita esta configuración.
- Una clave de API desde Claves de API si quieres el botón «Open in Sentry» (más abajo lo explicamos).
Cómo envía Sentry las alertas a un webhook
Sentry tiene dos formas de enviar una alerta mediante POST a una URL, y envían JSON distinto:
- Integración interna (recomendada por Sentry). Creas una integración privada con una URL de webhook y activas su interruptor Alert Action. Entonces aparece como acción en tus alertas. Las alertas de incidencias llegan con la cabecera
Sentry-Hook-Resource: event_alerty el error bajodata.event; las alertas de incidencias de los Metric Monitors llegan comometric_alertcon un título ya preparado endata.description_title. - Webhooks (Legacy). Un plugin por proyecto en la configuración del proyecto. Sigue funcionando, pero la propia página de configuración indica que Sentry recomienda encarecidamente usar una integración interna. Su payload es plano:
project_name,culprit,level,url,triggering_rulesy eleventoriginal.
Esta guía usa la integración interna y al final incluye una plantilla para el webhook legacy.
Paso 1: Crea el webhook de Pocket Alert
Pocket Alert nombra cada push de webhook como Webhook <name>, así que ponle Sentry y el título en la pantalla de bloqueo será «Webhook Sentry». El cuerpo sale de una plantilla que extrae campos del JSON de Sentry con marcadores %path%.
La forma más rápida es una sola llamada a la API, porque la plantilla del botón de acción solo se puede definir por API. Crea el webhook con la plantilla del mensaje, un nivel predeterminado y un botón «Open in Sentry», y después muestra la URL de recepción:
jq -n \
--arg msg $'%data.event.title%%data.description_title%\n%data.event.culprit%%data.description_text%\nRule: %data.triggered_rule%' \
--arg act '[{"type":"view","label":"Open in Sentry","value":"%data.event.web_url%%data.web_url%"}]' \
'{name: "Sentry", message: $msg, default_level: 1, actions: $act}' |
curl -sS https://api.pocketalert.app/v1/webhooks \
-H "Token: YOUR_API_KEY" \
-H 'Content-Type: application/json' \
--data-binary @- |
jq -r '"Receive URL: https://p4a.me/wh/" + .url'
La plantilla parece rara a propósito. Una integración de Sentry tiene una sola URL de webhook, y tanto las alertas de incidencias como las de métricas llegan a ella. Un marcador cuya ruta no existe en el payload se muestra como cadena vacía, así que %data.event.title%%data.description_title% muestra el título del error en una alerta de incidencia y el título de la alerta en una de métrica. El mismo truco da al botón el enlace correcto en ambos casos. En una alerta de incidencia, Rule: muestra el nombre de la regla; en una alerta de métrica, esa línea queda vacía.
Si prefieres hacerlo con clics, crea el webhook en la consola de Webhooks: nombre Sentry, Default priority High, y pega la plantilla del mensaje:
%data.event.title%%data.description_title%
%data.event.culprit%%data.description_text%
Rule: %data.triggered_rule%
Recibirás las mismas notificaciones, solo que sin el botón. Copia la URL de recepción que muestra la consola (https://p4a.me/wh/...).
Paso 2: Crea la integración interna en Sentry
- En Sentry ve a Settings > Developer Settings, crea una integración nueva y elige Internal Integration.
- Ponle un nombre como «Pocket Alert».
- Pega la URL de recepción en Webhook URL.
- Activa Alert Action. Este interruptor es el que añade la integración al creador de alertas.
- Guarda. Las integraciones internas se instalan solas en tu organización; no hay paso de OAuth.
Deja sin marcar las demás suscripciones de webhook (issue, error, comment). Pocket Alert convierte cada petición que recibe en un push, y esos recursos llegarían como notificaciones con líneas casi vacías.
Paso 3: Envía alertas a esa integración
El creador de alertas actual de Sentry está en Monitors > Alerts > Create Alert:
- Source: los proyectos que te interesan, o monitores concretos.
- Environment: elige
production, para que el ruido de staging no llegue a tu teléfono. - When: «A new issue is created» es la opción clásica. Conviene añadir «An issue escalates» y «A resolved issue regresses».
- Then: Send a notification via an integration, y selecciona la integración «Pocket Alert».
- Throttling: pon algo como 30 minutos, para que una incidencia activa no envíe un push por cada evento.
Antes de guardar, haz clic en Send Test Notification en el bloque If/Then. Una notificación titulada «Webhook Sentry» debería llegar a tu teléfono en uno o dos segundos.
Lo que llega a tu teléfono
En una alerta de incidencia, el payload de Sentry lleva el error bajo data.event. Estos son los campos que usa la plantilla, según el payload event_alert documentado por Sentry:
| Campo | Ejemplo | Uso |
|---|---|---|
data.event.title | ReferenceError: heck is not defined | Primera línea del push |
data.event.culprit | dónde se lanzó el error | Segunda línea |
data.triggered_rule | Very Important Alert! | Qué alerta se activó |
data.event.web_url | https://sentry.io/organizations/…/issues/…/events/…/ | Botón «Open in Sentry» |
data.event.level | error | Opcional, ver abajo |
Una alerta de métrica no tiene data.event. Su action es critical, warning o resolved, y data.description_title ya incluye el estado, por ejemplo «Resolved: Too many errors», con data.description_text debajo («1000 events in the last 10 minutes»). El botón usa data.web_url.
¿Quieres el nivel de Sentry en el texto? Añade Level: %data.event.level% a la plantilla. Es solo texto; la siguiente sección explica por qué no cambia lo fuerte que suena el push.
Niveles: qué decide realmente lo fuerte que suena el push
Pocket Alert tiene cinco niveles: silencioso, bajo, predeterminado, alto y crítico. En los webhooks, el nivel se elige en este orden: un campo level de primer nivel en el JSON entrante, después el nivel predeterminado del webhook y, por último, el nivel predeterminado de la aplicación.
Sentry no se asigna a eso por sí mismo, y una plantilla no puede traducir valores:
- El payload de la integración interna no tiene
levelde primer nivel. El nivel de Sentry está endata.event.level, así que Pocket Alert usa el nivel predeterminado del webhook. Por eso el webhook de arriba se crea condefault_level: 1(alto), que en iPhone se muestra como una notificación sensible al tiempo que atraviesa Concentración. - El webhook legacy sí envía un
levelde primer nivel, pero con los valores de Sentry:fatal,error,warning,info,debug. Ninguno es un nivel de Pocket Alert, así que se ignora y se aplica el nivel predeterminado. La alerta se entrega igualmente.
Si un error fatal en producción debe despertarte mientras todo lo demás sigue en alto, sepáralo en el lado de Sentry. Con un plan de pago, crea un segundo webhook de Pocket Alert llamado «Sentry critical» con default_level: 2, y una segunda integración interna que apunte a él. Luego usa dos bloques If/Then en la misma alerta:
- Bloque 1: If none de: Event level equals
fatal. Then notifica a la integración «Pocket Alert». - Bloque 2: If all de: Event level equals
fatal. Then notifica a «Pocket Alert critical».
Las alertas críticas atraviesan No molestar tanto en iOS como en Android (ver niveles de prioridad). Es una función de pago: en el plan gratuito, la crítica se entrega como alta.
El webhook legacy, si ya lo usas
Los proyectos que tienen Webhooks (Legacy) activado en Project Settings > Legacy Integrations pueden apuntarlo al mismo tipo de webhook de Pocket Alert. El payload es distinto, así que usa esta plantilla:
%project_name%: %event.title%
%culprit%
Rule: %triggering_rules.0%
Y esta plantilla de botón para la llamada a la API de arriba:
[{ "type": "view", "label": "Open in Sentry", "value": "%url%" }]
Usa %event.title% en lugar del %message% de primer nivel. En el payload legacy, message es el mensaje de registro del evento, que está vacío en una excepción normal. El plugin legacy solo envía cuando una alerta tiene la acción que notifica a las integraciones legacy del proyecto, y su página de configuración tiene un botón Send Test Event.
Límites con honestidad
- Un solo título para todo. Pocket Alert titula los pushes de webhook como
Webhook <name>; el error va en el cuerpo. Si necesitas el error como título del push, pon una pequeña función entre Sentry y la API de mensajes. - Sin verificación de firma. Las integraciones internas firman las peticiones con
Sentry-Hook-Signature, y Pocket Alert no la verifica. La URL de recepción aleatoria es el secreto, así que no la publiques. Si se filtra, elimina el webhook y crea uno nuevo. - Solo JSON. Los dos mecanismos de Sentry envían JSON, así que aquí no hay problema, pero un remitente que envíe datos de formulario será rechazado.
- Límites diarios. El plan gratuito entrega 50 mensajes al día. Con el throttling activado y alertas solo de producción es más que suficiente; una alerta de «cada evento capturado» los agotará.
Si no llega nada
- Abre el historial del webhook. Cada petición a tu webhook de Pocket Alert se registra con cabeceras, cuerpo, el mensaje renderizado y el estado. Si la petición aparece, el problema está en la plantilla; si no aparece, Sentry nunca la envió.
- Revisa el interruptor Alert Action. Sin él, la integración no aparece en Send a notification via an integration.
- Revisa el historial de la alerta. La página de detalles de la alerta en Sentry muestra las ejecuciones recientes. Filtros como el entorno o el nivel del evento suelen excluir el evento que esperabas.
- Líneas vacías en el push significan que una ruta no coincide con el payload. Compárala con el cuerpo en el historial del webhook; los nombres de campo distinguen mayúsculas de minúsculas.
- Sin botón significa que la ruta de la URL salió vacía; un botón no válido se descarta, pero el mensaje sigue entregándose.
Preguntas frecuentes
¿Tengo que escribir código?
No. Sentry envía el webhook y Pocket Alert lo convierte en un push. El único comando de esta guía es la llamada opcional a la API que añade el botón «Open in Sentry».
¿Puedo separar producción y staging?
Sí. Filtra la alerta por entorno, o crea una alerta por entorno que apunte a integraciones y webhooks distintos, cada uno a su propia aplicación de Pocket Alert para poder silenciar staging por separado.
¿Funciona con Sentry autoalojado?
La integración interna y la acción de alerta forman parte de Sentry, así que una instalación autoalojada lo bastante reciente para tenerlas puede enviar a Pocket Alert de la misma forma, siempre que pueda llegar a p4a.me por internet.
¿Y Rollbar, Bugsnag y otros rastreadores de errores?
El mismo enfoque sirve para cualquier herramienta que envíe JSON por POST a una URL; solo cambian las rutas de la plantilla. Consulta alertas de seguimiento de errores para ver el panorama general, la herramienta de webhook y la sintaxis de plantillas para entender cómo funcionan.
¿Es gratis?
El plan gratuito de Pocket Alert incluye un webhook, un dispositivo y 50 mensajes al día, lo que basta para alertas de errores de producción en una aplicación pequeña.
Crea una cuenta gratuita, pega la URL en Sentry y el próximo error de producción llegará primero a ti.