Saltar al contenido principal

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ónSDKErroresSeñalesVelocidadRegistros
Elixir, Phoenixcollectorsísí—sí
Node: Express, Next.js, cualquier servidor@chrom-ar/collector-nodesísí—sí
El navegador: React, Vue, Svelte, Angular, sin framework@chrom-ar/collectorsísísí—
Cualquier aplicación con OpenTelemetryninguno———sí
Cualquier otro lenguajepor HTTPsí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: environment y release. 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 test hace lo mismo desde la terminal.