Tu primer proyecto
Esta guía va desde un proyecto vacío hasta ver el primer error de tu aplicación en Collector. Lleva unos minutos.
1. Crea el proyecto
Crear proyectos es tarea de administradores y propietarios. Si eres miembro, pide a uno que lo cree, o salta al paso 2 si ya existe.
- En tu organización, abre el selector de proyecto en la barra superior y elige Nuevo proyecto. También puedes hacerlo desde la pestaña Proyectos.
- Escribe un Nombre: el de tu aplicación, como la reconoce tu equipo ("Tienda web", "API de pagos"). La dirección del proyecto sale del nombre una sola vez y no cambia aunque lo renombres después.
- Elige Crear proyecto.
Collector te lleva a la pestaña Puesta en marcha del proyecto nuevo.
Desde la terminal da lo mismo:
collector projects create "Tienda web" # imprime el DSN del proyecto nuevo
2. Sigue la puesta en marcha
Puesta en marcha dice: Tres pasos y tu aplicación reporta sus errores aquí. Arriba hay una pestaña por lenguaje: Elixir, Node, JavaScript (el navegador) y Otro (cualquier lenguaje, por HTTP). Abre la de tu aplicación. Si tu proyecto tiene un servidor y una página web, sigue las dos.
Los tres pasos son siempre los mismos:
- Instala el paquete del SDK.
- Dale el DSN a tu aplicación desplegada. El DSN está en la misma pantalla, en Tu DSN. No es un secreto: solo sirve para mandar errores a este proyecto, así que puede ir en el código del navegador.
- Despliega.
Para JavaScript y Node, la pantalla te pregunta tu framework y tu bundler, y el código que muestra se adapta a lo que elijas. Debajo de los tres pasos hay opciones que valen la pena pero no hacen falta para empezar: ver el código original en lugar del compilado, saber qué usuario tuvo el error, medir la velocidad, mandar registros. Copiar instrucciones copia todo, listo para pegárselo a tu agente de IA.
Cada SDK tiene su página con todos los detalles: Elixir, Navegador, Node.
3. Manda un evento de prueba
No hace falta esperar a que algo falle. Compruébalo: envía un evento de prueba muestra cómo para tu lenguaje:
- Elixir:
MIX_ENV=prod mix collector.test, oCollector.test_event()dentro de una release. - Node y navegador:
await Collector.test()en tu aplicación, después deinit. En el navegador, condebug: true, también puedes ejecutar__collector.test()desde la consola. - Cualquier lenguaje, o sin instalar nada:
collector test, conCOLLECTOR_DSNdefinido.
Mientras tanto, la pantalla muestra Esperando el primer evento…. En cuanto llega, cambia sola, sin recargar, y ofrece Ver sus problemas.
4. Mira el problema
En la pestaña Problemas está el error de prueba. Ábrelo para ver lo que verás con cada error real: el stack trace con tu código, el entorno y la versión, y lo que pasó antes. Ver Un problema.
Desde ahora, cada error nuevo te llega por correo. Si no quieres los correos de este proyecto, puedes silenciarlo solo para ti.
Lo que sigue
- Invita a tu equipo.
- Si tu código del navegador está minificado, sube los mapas de código fuente en cada build.
- Instala la CLI para manejar Collector desde la terminal.