Seguimiento de excepciones

El seguimiento de excepciones es el corazón de Quiet Guard: cada error lanzado por su aplicación se captura, se agrupa y se sigue a lo largo de todo su ciclo de vida. Se llega abriendo un proyecto en el panel /app, pestaña Incidencias.

Cómo funciona la ingesta

Su cliente envía (POST) un payload de excepción a /api/v1/ingest, autenticado con la clave de proyecto. El servidor lo valida, aplica la cuota mensual de su equipo y lo pasa al ingestor. Una llamada correcta devuelve 202 Accepted con el identificador público de la issue. La forma completa del payload está documentada en la referencia de la API de ingesta.

Cada excepción aceptada se convierte en una ocurrencia. Las ocurrencias se agrupan en issues.

Agrupación por huella en issues

En lugar de almacenar miles de errores idénticos como filas separadas, Quiet Guard los agrupa. Se calcula una huella (fingerprint) determinista a partir de:

• el proyecto,
• la clase de la excepción,
• el archivo (ruta normalizada), y
• la línea.

Todas las ocurrencias que comparten una huella se agrupan en una sola issue, con un contador de ocurrencias que ningún envío simultáneo pierde, la fecha en que se vio por primera vez y la de la última.

¿Por qué normalizar la ruta? Las herramientas de despliegue suelen servir la aplicación desde un directorio con marca de tiempo (por ejemplo /releases/20260628/...). La huella elimina ese ruido, conservando la ruta a partir del primer marcador /app/, /src/ o /vendor/, para que el mismo error se agrupe de un despliegue a otro en vez de fragmentarse en cada release.

Ocurrencias

Abra una issue para ver su página de detalle: la clase y el mensaje agrupados, el lugar donde se produce, el número de veces que se ha visto, y la lista de ocurrencias individuales. Cada ocurrencia lleva su propia traza, su contexto de petición, su entorno y su release, capturados en el momento en que se produjo.

Resolver, ignorar, reabrir

Cada issue tiene un estado:

• Abierta: activa, requiere atención (estado por defecto de una issue nueva).
• Resuelta: usted la ha corregido; sale de la lista activa.
• Ignorada: ruido que no quiere tratar; se conserva pero silenciada.

Se pasa de un estado a otro mediante las acciones de la lista de issues y de la página de detalle. Los filtros permiten centrarse, por ejemplo, solo en las issues abiertas.

Reapertura por regresión

Si una issue está resuelta y el mismo error vuelve a producirse, Quiet Guard lo trata como una regresión: la issue vuelve automáticamente al estado abierta en la siguiente ocurrencia, y se dispara una alerta issue.reopened hacia los canales de notificación suscritos. No hace falta vigilar las issues resueltas: si vuelven, se le avisará.

Correlación release → commit

Aquí es donde los datos de GitHub rinden. Cuando una ocurrencia lleva una release (un SHA de commit, enviado en context.release) y el proyecto está conectado a GitHub, Quiet Guard asocia esa release con el commit sincronizado exacto. Desde la issue puede saltar directamente al commit que desplegó el código defectuoso, cerrando el círculo entre el error visto en producción y el cambio que lo causó.

Tenga en cuenta: la correlación de release solo se resuelve cuando el valor de release es un SHA de commit hexadecimal y el commit correspondiente ha sido sincronizado desde GitHub.

Flujo de triaje

La pestaña Issues de un proyecto se abre en vista de triaje: el filtro de estado viene preajustado en Abierta y todos los filtros son visibles encima de la tabla. La columna 24 h cuenta las ocurrencias de cada issue durante el último día, detecte la ráfaga en curso, no la issue ruidosa de la semana pasada. Seleccione varias issues para resolverlas o ignorarlas en una sola acción.

Asignar issues

Asigne una issue a un miembro del equipo desde la lista o desde su página. El filtro Asignadas a mí convierte la lista en una pila de trabajo personal, ideal para las agencias que reparten los proyectos entre desarrolladores.

Logs alrededor de un evento

Si su plan incluye los logs de aplicación, la página de una issue muestra los logs registrados en el mismo proyecto y entorno a ±5 minutos de la última ocurrencia, el "porqué" suele esconderse ahí. Cada línea lleva a la entrada completa.

Búsqueda global

Pulse ⌘K / Ctrl+K en cualquier lugar del panel para encontrar una issue por clase de excepción, mensaje o archivo, y un proyecto por nombre. Con el almacenamiento cifrado, los mensajes sellados no son buscables (por diseño): la búsqueda se apoya en los metadatos en claro.

Y a continuación

• Configure las alertas para que el equipo sea avisado de las issues nuevas y reabiertas.
• Añada los logs de aplicación para tener contexto alrededor de cada error.
• Active el almacenamiento cifrado si el contenido de las excepciones debe permanecer privado en reposo.