Alertas y canales
Correo, Slack, Discord, Teams, Telegram, webhooks, ntfy, Pushover, PagerDuty y Opsgenie; reglas, escalado y horas de silencio.
- Canales
- Notificaciones en tu computadora o tu teléfono
- En la pantalla de bloqueo de tu iPhone
- Mientras tienes Pingerer abierto
- Reglas: qué sitios y qué eventos
- Qué dice una alerta
- Cuando es tu proveedor, no tú
- Cuando un sitio se cae y vuelve una y otra vez
- Muchas alertas a la vez
- Atender un incidente
- Escalada
- Turnos de guardia
- Horas de silencio
- Qué recibe un webhook
- Firmas de los webhooks
- Tu resumen
Canales
Un canal es un lugar al que llegan las alertas. Añádelos en la página Alertas:
| Canal | Qué necesitas |
|---|---|
| Correo electrónico | Una o más direcciones. Las que no son de miembros de tu equipo reciben antes un enlace de confirmación. |
| Slack | La URL de un webhook entrante. En Slack: Apps › Incoming Webhooks › Add to Slack, elige el canal y copia la Webhook URL. |
| Discord | La URL del webhook de un canal (Ajustes del canal › Integraciones › Webhooks). |
| Microsoft Teams | La URL de un flujo de trabajo de Teams o de un webhook entrante. |
| Telegram | Abre un chat con el bot de Pingerer (o añádelo a tu grupo) y escribe el ID del chat, o @channelname para un canal público en el que el bot sea administrador. |
| Webhook | Tu endpoint HTTPS. Firmamos cada solicitud (más abajo). |
| SMS | Un número de móvil verificado. Consulta Alertas SMS y créditos. |
| ntfy | Un tema al que te hayas suscrito en la app ntfy, en ntfy.sh o en tu propio servidor, y un token de acceso si el tema está protegido. Las caídas se envían con prioridad urgente. |
| Pushover | Tu clave de usuario de Pushover (arriba en pushover.net cuando inicias sesión) y el nombre de un dispositivo si solo la quieres en uno. Las caídas se envían con prioridad alta. |
| PagerDuty | Una clave de integración de Events API V2 (Services › tu servicio › Integrations). Un incidente abre un incidente en PagerDuty y lo resuelve cuando todo vuelve a funcionar. |
| Opsgenie | La clave de una integración de API (Teams › tu equipo › Integrations › API) y si tu Opsgenie está en EE. UU. o en la UE. Un incidente abre una alerta en Opsgenie y la cierra cuando todo vuelve a funcionar. |
| Notificaciones en el móvil y el navegador | No hay nada que configurar, y es gratis. Todas las personas de la cuenta que activen las notificaciones, o las que tú elijas, reciben las alertas como notificaciones en su computadora o su teléfono, y en la app de Pingerer donde hayan iniciado sesión. Cada persona puede desactivar un dispositivo en Tus dispositivos. |
Usa Enviar prueba después de agregar un canal. Si un canal falla cinco veces seguidas, se marca como fallido en la página Alertas para que puedas arreglarlo.
Notificaciones en tu computadora o tu teléfono
Pingerer puede mostrarte una notificación en pantalla cuando algo falla, aunque no tengas Pingerer abierto. Es gratis y no gasta créditos de SMS. Cada persona la activa para sí misma, en cada dispositivo:
- Abre la página Alertas en esa computadora o teléfono y baja hasta Notificaciones en tus dispositivos.
- Haz clic en Activar las notificaciones en este dispositivo y elige Permitir cuando el navegador te lo pregunte.
- Haz clic en Enviar una notificación de prueba para ver una.
Funciona en Chrome, Edge, Firefox y Safari en computadoras y en teléfonos Android. En un iPhone o iPad, primero agrega Pingerer a tu pantalla de inicio: en Safari, toca el botón Compartir, luego Agregar a pantalla de inicio, y abre Pingerer desde ahí. Si bloqueaste las notificaciones sin querer, haz clic en el icono que hay justo a la izquierda de la dirección web, cambia Notificaciones a Permitir y vuelve a cargar la página.
Las notificaciones llegan a todas las personas incluidas en un canal de Notificaciones en el móvil y el navegador. Si tu cuenta aún no tiene uno, se crea cuando la primera persona activa las notificaciones, para caídas, recuperaciones, lentitud y heartbeats perdidos en todos los sitios. Las caídas se quedan en pantalla hasta que las cierras, y al hacer clic en una notificación se abre el incidente.
En la pantalla de bloqueo de tu iPhone
Con la app de Pingerer para iPhone (iOS 17.2 o posterior) y sus notificaciones activadas, un sitio que se cae aparece en tu pantalla de bloqueo y en la Dynamic Island: su dirección, lo que vimos y un contador de cuánto tiempo lleva caído. Cuando vuelve, se pone en verde («De nuevo en línea tras 14 min») y desaparece unos minutos después. Tócalo para abrir el incidente.
Mientras tienes Pingerer abierto
El icono de la pestaña del navegador muestra un punto verde, ámbar o rojo, y una barra recorre la parte superior de la página cuando un sitio se cae o vuelve. Activa Reproducir un sonido suave aquí en Notificaciones en tus dispositivos para oírlo también. Más atajos.
Reglas: qué sitios y qué eventos
Cada canal tiene reglas: todos los sitios (también los que agregues después) o los que elijas, y qué eventos: caído, degradado (lento), SSL o dominio a punto de caducar, cambios de DNS, problemas en la configuración del correo, heartbeats perdidos y salud del sitio (un nuevo problema crítico en la revisión semanal). Los mensajes de recuperación van a los canales a los que se avisó del problema.
Qué dice una alerta
Cada alerta dice qué falló, cómo (por ejemplo, «502 Bad Gateway desde 3 regiones»), cuándo empezó y qué suele significar. El correo de una alerta de caída también trae Pausar 1 hora, para cuando ya estás trabajando en el sitio, y Avisa a tus clientes cuando ese sitio aparece en una de tus páginas de estado publicadas: abre una actualización de estado ya rellenada con los datos de la caída. Cuando un sitio vuelve, el aviso de recuperación indica la causa probable si su proveedor de hosting, su CDN o su creador de sitios web tuvo problemas al mismo tiempo. Abrir y confirmar un incidente envía una sola alerta, no dos; recibes otra cuando se recupera. Cuando un sitio se cae, normalmente lo detectan a la vez sus comprobaciones de disponibilidad, de puerto y de ping: aun así recibes una sola alerta, y otra cuando la última de ellas vuelve a estar en línea.
Cuando es tu proveedor, no tú
Cuando muchos otros sitios de la misma empresa de hosting, CDN o creador de sitios web se caen en el mismo momento que el tuyo, la alerta dice que probablemente es esa empresa, y si eso solo queda claro unos minutos después, recibes un breve aviso de seguimiento. Consulta ¿Es mi proveedor? Clima de internet.
Cuando un sitio se cae y vuelve una y otra vez
Si un monitor se cae 3 veces en 2 horas, dejamos de tratar cada vaivén como un problema nuevo. Su incidente sigue abierto hasta que las comprobaciones pasan durante 30 minutos seguidos, y la cronología explica por qué. Recibes una alerta cuando se cae y otra cuando se ha estabilizado, en lugar de un par cada vez que va y viene.
Muchas alertas a la vez
Después de 30 correos de alerta en una hora, retenemos los siguientes y los enviamos una hora después en un solo correo de resumen por canal, con todas las alertas y los incidentes que siguen abiertos. Los demás canales, como Slack, SMS y las notificaciones, no se ven afectados.
Atender un incidente
Haz clic en Atender en una alerta (o en el incidente) para que tu equipo sepa que alguien se está ocupando. Atenderlo detiene la escalada de ese incidente.
Escalada
Ponle a una regla un tiempo de «escalar después de» para convertirla en una regla de escalada: ese canal solo recibe el aviso si un incidente sigue sin atender pasados esos minutos. Por ejemplo, envía un correo al equipo enseguida y un SMS al dueño si nadie lo ha atendido en 15 minutos.
Turnos de guardia
En el plan De pago, un equipo puede turnarse para estar de guardia. Abre Guardia, crea un turno, ordena a tu equipo según el orden en que se turnan y elige cuándo cambia (por ejemplo, cada semana el lunes a las 9:00, en tu zona horaria). Cada turno muestra quién está de guardia ahora y quién después, y la semana siguiente. Agrega una excepción cuando alguien cubre a otra persona durante un tiempo, como un cambio o unas vacaciones.
Un turno aparece en la página Alertas como un canal llamado «On call: nombre». Márcalo para los sitios que debe cubrir, o elígelo en Escalar a para avisar a quien esté de guardia solo cuando nadie lo reconozca a tiempo. Enviamos un correo a la persona de guardia, y también un SMS si ha agregado y verificado su teléfono en la página Guardias (los SMS usan los créditos de SMS de la cuenta).
Horas de silencio
Configura horas de silencio (por ejemplo, de 22:00 a 7:00) para retener hasta la mañana las alertas menos urgentes, como certificados a punto de caducar o cambios de DNS. Las caídas y los heartbeats perdidos siempre llegan, salvo que hayas indicado que un sitio puede esperar: en su página, en De noche, elige Puede esperar a la mañana para un proyecto personal o un sitio de pruebas, y sus alertas de caída también esperarán a que terminen las horas de silencio. Una alerta retenida cuyo problema se resuelve solo antes de la mañana nunca se envía. También puedes retenerlas todo el fin de semana. Elige tu fin de semana junto a las horas de silencio: sábado y domingo, viernes y sábado, o un solo día. Si no lo cambias, usamos lo habitual en tu zona horaria (viernes y sábado en el Golfo). Los desarrolladores también pueden consultar y cambiar las horas de silencio y el fin de semana con la API.
Qué recibe un webhook
Un canal de webhook recibe un POST en JSON por cada alerta. El encabezado X-Pingerer-Event indica de qué evento se trata:
opened: algo ha fallado. Después lleganconfirmedyescalatedcuando más regiones lo confirman o cuando nadie lo ha atendido a tiempo.recovered: vuelve a funcionar.update: tu sitio sigue caído y, desde que te avisamos, se han caído también muchos otros sitios de la misma empresa de hosting, CDN o creador de sitios web, así que probablemente es cosa suya, no tuya. Recibes como mucho uno por incidente, y solo en los canales a los que se avisó de la caída.test: presionaste Enviar prueba.
{
"event": "update",
"test": false,
"incident": {"id": "inc_2bQ7", "reference": "INC-0042", "kind": "down", "state": "open",
"cause": "Connection timed out", "opened_at": "...", "resolved_at": null, "url": "..."},
"site": {"id": "site_4xT9", "name": "Online shop", "host": "shop.yourbakery.com", "url": "..."},
"monitor": {"id": "mon_8xKq2", "name": "Homepage", "kind": "http", "target": "..."},
"account": {"id": "acct_7Hd2k", "name": "Your Bakery"},
"summary": {"badge": "UPDATE", "subject": "...", "headline": "It's probably Cloudflare, not you", "text": "..."},
"provider_trouble": {"kind": "cdn", "name": "Cloudflare"},
"delivery_id": 81723,
"sent_at": "..."
}
provider_trouble solo aparece cuando el sitio está caído y su proveedor es la causa probable (cómo lo sabemos). kind es hosting, cdn o platform (un creador de sitios web como Shopify o Wix). Nunca dice cuántos otros sitios se cayeron ni de quién son. Los incidentes de la API tienen el mismo campo provider_trouble. La descripción completa está en webhooks, en /openapi.yaml.
Firmas de los webhooks
Las solicitudes de webhook son POST en JSON con un encabezado X-Pingerer-Signature como t=1760000000,v1=5257a8.... Para verificar una, calcula un HMAC-SHA256 de "#{t}.#{body}" con el secreto de tu canal y compáralo con v1; rechaza las solicitudes cuyo t tenga más de unos minutos de antigüedad.
expected = OpenSSL::HMAC.hexdigest("SHA256", secret, "#{t}.#{request.raw_post}")
ActiveSupport::SecurityUtils.secure_compare(expected, v1)
Tu resumen
Además de las alertas, Pingerer puede enviarte un resumen semanal o diario: qué ha pasado, qué necesita tu atención y qué viene, en palabras sencillas, con una nota opcional en lenguaje sencillo al principio. Consulta Tu resumen.
¿Sigues atascado? Escríbenos y te responderá una persona.