Cómo se agrupan los eventos
Collector junta en un mismo problema los eventos que tienen la misma huella (fingerprint) dentro de un proyecto. Entender cómo se calcula la huella explica por qué un error aparece como un problema y no como cien, y qué hacer cuando la agrupación no es la que esperas.
La regla
Si el evento no trae una huella propia, Collector la calcula así:
- Con marcos de tu código: el tipo de la excepción más el módulo y la función de cada marco marcado como tuyo (
in_app). Las líneas, los archivos y los marcos de dependencias no cuentan, así que un despliegue que mueve código de lugar no parte un problema en dos. - Con marcos, pero ninguno tuyo: el tipo y los tres primeros marcos.
- Sin marcos: el tipo, si hay, y el mensaje, con los números, identificadores, UUID, valores hexadecimales, textos entre comillas, PID y cuerpos de structs reemplazados. Así
user 4812 not foundyuser 99 not foundson un mismo problema.
Lo que más importa: qué es tu código
Como la regla 1 se apoya en los marcos in_app, marcar bien qué código es tuyo importa más que cualquier otra cosa. Los SDK lo deciden solos con un criterio razonable, y cada uno deja ajustarlo:
- Elixir: tus propias aplicaciones; la opción
:in_appelige otras. Ver Elixir. - Node: lo que está fuera de
node_modules; la opcióninAppPathslo cambia. Ver Node. - Navegador: los scripts de tu mismo origen; la opción
inAppUrlsagrega otros, como tu CDN. Ver Navegador.
Si ves problemas que deberían ser uno solo, o uno que mezcla errores distintos, lo primero es revisar esto.
Código minificado
En el navegador, el código suele estar minificado: sin mapas de código fuente, la huella se calcula con las funciones minificadas, que cambian en cada build. Con los mapas subidos, los marcos se agrupan por el archivo y la función originales, y un build nuevo no parte el problema.
Los eventos que llegaron antes de subir los mapas de una versión quedan agrupados por el código minificado. Cuando subes los mapas, Collector reagrupa esos eventos; si eso hace coincidir dos problemas, los une. Ver Problemas que se unen.
Elegir la huella a mano
Cuando sabes mejor que la regla cómo agrupar, manda una huella propia con el evento: una lista de textos. Por ejemplo, ["payment-gateway", "timeout"] junta todos los timeouts de la pasarela de pagos en un solo problema, vengan de donde vengan. Cómo se manda depende del SDK; el campo está en El evento.