Saltar al contenido principal

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í:

  1. 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.
  2. Con marcos, pero ninguno tuyo: el tipo y los tres primeros marcos.
  3. 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 found y user 99 not found son 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_app elige otras. Ver Elixir.
  • Node: lo que está fuera de node_modules; la opción inAppPaths lo cambia. Ver Node.
  • Navegador: los scripts de tu mismo origen; la opción inAppUrls agrega 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.