Conceptos base
Esta página define las palabras que usa el resto del manual. Son las mismas que ves en la aplicación.
Organización y proyectos
Una organización es tu empresa o tu equipo dentro de Collector. Tiene un nombre y una dirección propia, /o/<organización>, y adentro están sus proyectos y sus miembros.
Las cuentas se crean por invitación: alguien de la organización te invita por correo y, al aceptar, quedas como miembro. Una organización nueva empieza con un enlace que manda el equipo de Collector; ver Crear tu organización. Puedes pertenecer a varias organizaciones; cambias de una a otra desde la barra superior.
Un proyecto es una aplicación que reporta a Collector: tu tienda, tu API, tu panel interno. Cada proyecto tiene su propia clave, sus problemas, sus registros y su velocidad. Si una misma aplicación tiene frontend y backend, lo usual es un proyecto para cada uno, o uno solo si quieres ver todo junto: Collector distingue lo que viene del navegador de lo que viene del servidor.
Roles
Cada miembro tiene uno de tres roles en la organización:
| Rol | Qué puede hacer |
|---|---|
Miembro (member) | Ver todo: proyectos, problemas, registros, velocidad, miembros. Resolver, ignorar, reabrir y asignar problemas. |
Administrador (admin) | Lo anterior, más invitar gente, cambiar roles y quitar miembros (nunca a un propietario), crear y renombrar proyectos, renovar su DSN y manejar sus credenciales y claves. Ve el registro de auditoría. |
Propietario (owner) | Todo, incluido cambiar o eliminar la organización y eliminar proyectos. Es el único que puede nombrar a otro propietario. |
Cada página de este manual que documenta una pantalla muestra, junto al título, el rol mínimo que la usa.
Eventos y problemas
Un evento es un error que ocurrió una vez: una excepción con su stack trace, o un mensaje que tu aplicación decidió reportar. Lo manda el SDK en el momento en que pasa.
Los eventos iguales se agrupan en un problema. Dos eventos son iguales cuando tienen la misma huella (fingerprint): el tipo de la excepción y las funciones de tu propio código por las que pasó. Si el error ocurre mil veces, ves un problema con mil eventos, no mil problemas. Agrupación explica la regla completa.
Cada problema tiene un estado:
unresolved(Sin resolver): está pasando y nadie lo cerró. Es el estado de todo problema nuevo.resolved(Resuelto): alguien lo arregló. Si vuelve a ocurrir, Collector lo reabre y avisa.ignored(Ignorado): se sabe y no importa. Sus eventos siguen contando, pero no avisa.
Y un nivel, el del evento que lo abrió: fatal, error, warning o info.
Entorno y versión
Cada evento puede traer un entorno (environment: production, staging, …) y una versión (release: el número de versión o el sha de git). Los filtros y los conteos son por entorno, y la versión es lo que une un error minificado con los mapas de código fuente de ese build.
Señales
Además de los errores, los SDK avisan que la aplicación está viva: una señal al arrancar y otra cada hora desde los servidores; desde el navegador, una por día por versión y entorno. Collector muestra la última señal de cada entorno, por separado para servidores y navegadores, y te avisa por correo cuando los servidores de un proyecto se quedan callados. Cada evento también cuenta como señal. Ver Señales.
Velocidad
Con la medición de velocidad activada, el SDK del navegador mide cuánto tardan las páginas para tus visitantes reales. Cada visita a una página trae sus Web Vitals y los pedidos que hizo la página; una visita es todo lo que hizo una pestaña, página tras página. La pestaña Velocidad las junta por página, por pedido y por visita. Ver Velocidad.
Registros
Con los registros activados, tus servidores mandan sus líneas de log, cada solicitud HTTP que atienden y los intentos de inicio de sesión. Sirven para seguir lo que pasa y para detectar ataques: abuso de inicios de sesión, escaneos, volumen inusual. Ver Registros.
Las cuatro credenciales
Collector usa cuatro valores distintos para cuatro trabajos distintos. Confundirlos es el error de configuración más común.
| Credencial | Se ve como | Para qué | ¿Es secreta? |
|---|---|---|---|
| DSN | https://clt_…@app.clt.chrom.ar | Mandar errores, señales y visitas a páginas. Lleva la clave del proyecto y dice dónde está Collector. | No. Va en el código del navegador. |
| Clave de servidor | clts_… | Mandar registros, desde tus servidores o desde OpenTelemetry. | Sí. |
| Credencial de subida | cltu_… | Subir los mapas de código fuente desde tu integración continua. | Sí. |
| Credencial de acceso | cltp_… | Usar la CLI collector, la API o un agente de IA, actuando como tú. | Sí. |
Las tres primeras son del proyecto y las crean propietarios y administradores; ver Claves y credenciales. La credencial de acceso es tuya: la crea collector login o la sección Credenciales de acceso de tu cuenta.