SDKs
Un SDK es el paquete que instalas en tu aplicación para que reporte a Collector. Captura los errores solo, anota lo que pasó antes de cada uno, manda las señales y, si lo activas, la velocidad y los registros.
Cuál usar
| Tu aplicación | SDK | Errores | Señales | Velocidad | Registros |
|---|---|---|---|---|---|
| Elixir, Phoenix | collector | sí | sí | — | sí |
| Node: Express, Next.js, cualquier servidor | @chrom-ar/collector-node | sí | sí | — | sí |
| El navegador: React, Vue, Svelte, Angular, sin framework | @chrom-ar/collector | sí | sí | sí | — |
| Cualquier aplicación con OpenTelemetry | ninguno | — | — | — | sí |
| Cualquier otro lenguaje | por HTTP | sí | sí | — | sí |
Si tu proyecto tiene un servidor y una página web, instala los dos: el del servidor y el del navegador. Cada uno manda lo suyo al mismo proyecto, y Collector distingue de dónde vino cada evento.
Lo que todos comparten
- El DSN: todos leen
COLLECTOR_DSN. Sin DSN no mandan nada, así que desarrollo y pruebas quedan en silencio sin configurar nada. Ver Conceptos base. - Entorno y versión:
environmentyrelease. Los problemas se cuentan por entorno, y la versión une los errores con los mapas de código fuente. - El usuario: un identificador, nunca datos personales. Así cada problema dice a cuántos usuarios afectó.
- Qué es tu código: cada SDK decide qué marcos de la pila son tuyos, y eso decide cómo se agrupan los errores.
beforeSend: ve cada evento al final y puede cambiarlo o descartarlo.- Nunca frenan tu aplicación: mandan en segundo plano, reintentan sin duplicar, y bajan el ritmo cuando Collector lo pide.
- Una prueba: cada uno trae su forma de mandar un evento de prueba y ver qué contestó Collector.
collector testhace lo mismo desde la terminal.