Cómo funciona Honk
Tu tienda, tus formularios, tu casa y tus servidores le cuentan a Honk lo que pasa. Honk guarda cada mensaje, junta las repeticiones, solo te avisa de lo que no puede esperar y deja el resto en una bandeja de entrada que puedes leer cuando quieras.
De la solicitud a la notificación
- Solicitud Tu código envía JSON a
/v1/messagescon la clave de ingesta de un proyecto. - Guardado Honk lo guarda en disco y después responde
202. Un reintento con la mismaIdempotency-Keyrecibe el mismo id, no crea un segundo mensaje. - Agrupado Entra en el grupo que corresponde a su proyecto, entorno, origen, canal y
group_key. - Repartido Para cada persona, Honk decide: notificar ahora, guardarlo para el resumen o dejarlo solo en la bandeja de entrada.
- Enviado Las notificaciones salen por el servicio push de Apple y por Web Push. Todo se puede buscar después en la bandeja de entrada.
202 significa que Honk tiene el mensaje, no que alguien lo haya visto. Por eso las apps nunca dicen «entregado»: Apple y los servicios push de los navegadores solo confirman que aceptaron una notificación.
Grupos y episodios
Un grupo reúne los eventos que tratan de lo mismo. Dos eventos van al mismo grupo cuando vienen del mismo proyecto, entorno, origen y canal y comparten group_key. Sin group_key, Honk compara el título y el mensaje exactos, así que solo se agrupan los eventos idénticos.
Un episodio es una racha de un mismo problema dentro de un grupo. Empieza con el primer evento y termina de una de dos maneras: el origen informa de una recuperación con el mismo group_key, o no llega nada durante un tiempo (24 horas por defecto) y el episodio pasa a inactivo. Inactivo no quiere decir resuelto: el siguiente evento abre un episodio nuevo y vuelve a avisar.
Marcar como atendido es una nota para ti: indica que ya te ocupaste del episodio. No significa que el problema esté resuelto, y un episodio nuevo volverá a pedir tu atención.
Cómo elegir una clave de grupo
db/backup- una tarea: todos los fallos de la copia de seguridad nocturna van al mismo grupo
requests/4812- una solicitud de cliente por grupo, para que dos clientes nunca compartan aviso
disk/app-01/var- un disco de un servidor concreto
ci/acme/api/main- una rama de un repositorio en CI
Actividad
Eventos
Qué se notifica
Lo decide el servidor, para cada persona que sigue el proyecto y siempre con las mismas reglas. La IA del iPhone puede reformular una notificación, pero nunca cambia lo que se notifica.
| El primer evento de un episodio | Se notifica al instante. |
|---|---|
| Un nivel más alto que el del último aviso | Se notifica al instante, incluso durante la pausa entre actualizaciones. Los silencios se siguen respetando. |
| Una recuperación | Se notifica al instante, con la hora que indicó el origen. |
| Más eventos iguales | Como mucho, una actualización por pausa (5 minutos por defecto, ajustable de 1 a 120), con el recuento al día. |
| Por debajo de tu umbral de push | Se guarda para el resumen, que sale cada 15 minutos por defecto. Nunca se envía un resumen vacío. |
| Durante tus horas de silencio | Se retiene, y al terminar recibes un solo resumen. Solo pasan los eventos urgentes de una clave autorizada para enviarlos. |
| Silenciado, o una regla lo deja solo en la bandeja de entrada | No se notifica. El evento sigue en la bandeja de entrada, sin leer. |
Los niveles Bocinazo largo y Bocina sin parar llegan siempre con prioridad Alta como mínimo. La prioridad Urgente requiere una clave de ingesta con la opción «Permitir la prioridad “Urgente”» activada.
Una noche con horas de silencio
Las horas de silencio son de cada persona y de cada proyecto, siguen tu zona horaria y se ajustan solas al horario de verano. Así es una noche con horas de silencio de 22:00 a 07:00:
- Empiezan las horas de silencio.
- Dos Bocinazos suaves de una tarea de copia de seguridad. Van al resumen.
- Un Bocinazo largo de la API de facturación. Espera hasta la mañana.
- Una Bocina sin parar urgente, de una clave autorizada para enviar eventos urgentes. Se salta las horas de silencio y abre una Actividad en directo en la pantalla bloqueada.
- El origen informa de la recuperación. La Actividad en directo muestra «Recuperado».
- Terminan las horas de silencio. Una sola notificación resume lo que quedó retenido.
Para saltarse las horas de silencio, un evento necesita tres cosas: que se envíe con prioridad urgent, que su clave de ingesta tenga activada la opción «Permitir la prioridad “Urgente”» y que tus horas de silencio tengan activada la opción «Dejar pasar los mensajes urgentes».
Resúmenes periódicos y resumen diario
Los eventos rutinarios por debajo de tu umbral de push se reúnen en un resumen: una notificación cada 15 minutos por defecto (de 5 minutos a 24 horas, por proyecto y por persona). Nunca se envía un resumen vacío.
El resumen diario es una notificación discreta al día, a la hora que elijas (las 08:00 por defecto). Por ejemplo: «2 incidentes abiertos · 5 nuevas solicitudes de clientes · 120 mensajes desde ayer». Los días en que no llega nada no se envía, y siempre espera a que terminen tus horas de silencio.
martes, 6 de octubre
08:00
Reglas y silencios
Las reglas de un proyecto se aplican en orden a cada evento. Pueden fijarse en el título, el mensaje, el origen, el entorno, el canal, la gravedad, la prioridad, el tipo de evento, la clave de grupo, la categoría o un campo de metadatos, y después mandar el evento al resumen, dejarlo solo en la bandeja de entrada, asignarle una categoría o subir su prioridad.
Los silencios solo te afectan a ti. Silencia un grupo durante una hora desde su notificación, silencia un proyecto entero o usa Silenciar todo en el Centro de control para pausar durante una hora todas las notificaciones del espacio de trabajo. Los eventos silenciados siguen llegando y quedan sin leer.
Espacios de trabajo y proyectos
El espacio de trabajo define quién tiene acceso y cuánto puede usar. El proyecto indica de dónde vienen los eventos.
Un espacio de trabajo reúne a los miembros, sus roles (propietario, administrador o miembro) y el plan. Los límites del plan se cuentan por espacio de trabajo.
Un proyecto es una app, un servidor o un script. Cada proyecto tiene sus propias claves de ingesta, reglas, periodo de conservación (hasta el límite del plan), resumen y pausa entre actualizaciones.
- Todo el mundo empieza con un espacio de trabajo personal en el plan Free.
- Un equipo crea un espacio de trabajo compartido e invita a otras personas.
- Los propietarios y administradores ven todos los proyectos; los miembros, solo aquellos a los que tienen acceso.
- Las horas de silencio, los silencios y los ajustes de push son por persona y por proyecto, así que nunca cambian el teléfono de nadie más.
Si has usado Sentry, el modelo es el mismo: un espacio de trabajo es una organización, un proyecto es un proyecto y una clave de ingesta es un DSN.
- API de facturación 2 claves de ingesta · 4 reglas · 30 días
- Casa 1 clave de ingesta · horas de silencio de 22:00 a 07:00
Lo que Honk no es
- No es un monitor. Honk recibe eventos, pero no comprueba tus servicios. Si un servidor se cae sin avisar, no llega nada, así que añade también un monitor de disponibilidad que informe a Honk.
- No es un sistema de guardias. No hay turnos ni cadenas de escalado, y Honk nunca envía un SMS ni te llama.
- No es un archivo. Los mensajes se eliminan a los 3, 14 o 30 días, según tu plan.