# Agrega Collector a esta aplicación

Collector informa los errores, los registros y la velocidad de esta aplicación. Sigue estos pasos en orden; pregúntale a la persona cuando algo dependa de su decisión.

## 1. Instala la CLI

```sh
brew install chrom-ar/tap/collector
# o
curl -fsSL https://packages.chrom.ar/collector/install.sh | sh
```

## 2. Inicia sesión

Abre el navegador para que la persona lo apruebe:

```sh
collector login
```

## 3. Elige el proyecto

Usa el proyecto de esta aplicación o crea uno. Luego obtén su DSN:

```sh
collector projects list
# o
collector projects create "<name>"

collector use <org>/<project>
collector dsn
```

## 4. Agrégalo a la aplicación

Identifica el lenguaje de la aplicación y sigue solo su sección.

### Elixir

#### Instalación

Agrega la dependencia y luego ejecuta mix deps.get:

```elixir
{:collector, ">= 0.3.0"}
```

Define el DSN en el entorno de la aplicación desplegada, no en desarrollo ni en pruebas:

```sh
COLLECTOR_DSN="$(collector dsn)"
```

#### Errores

Las caídas se informan solas. Agrega el pedido a cada error, y a quién le pasó, por id:

```elixir
plug Collector.Plug  # endpoint.ex
Collector.set_user(user.id)
```

#### Registros

Crea una clave de servidor y defínela junto al DSN (versión 0.5.0 o posterior):

```sh
collector server-keys create "prod"
COLLECTOR_SERVER_KEY=clts_…
```

```elixir
config :collector,
  logs: [level: :info, skip_paths: ["/health"], trusted_proxies: ["10.0.0.0/8"]]
```

#### Mapas de código fuente

**No lo omitas: sin esto, los errores no muestran el código de la aplicación.** Va en el paso de CI que despliega, para que cada versión suba lo suyo.

La versión compilada no incluye el código fuente. Empaquétalo antes de compilar:

```sh
MIX_ENV=prod mix collector.package_source
MIX_ENV=prod mix release
```

### Node

#### Instalación

Instala el paquete e inicialízalo antes de que arranque el servidor:

```sh
npm install "@chrom-ar/collector-node@>=0.1.0"
```

```javascript
import * as Collector from "@chrom-ar/collector-node";

Collector.init();

const app = express();

// … tus rutas …
app.use(Collector.expressErrorHandler());
```

Define el DSN en el entorno de la aplicación desplegada:

```sh
COLLECTOR_DSN="$(collector dsn)"
```

#### Errores

Los errores sin capturar se informan solos. Indica a quién le pasaron, por id:

```javascript
Collector.setUser({ id: user.id });
```

#### Registros

Crea una clave de servidor, defínela junto al DSN y pasa logs al init de arriba:

```sh
collector server-keys create "prod"
COLLECTOR_SERVER_KEY=clts_…
```

```javascript
Collector.init({
  logs: { level: "info", skipPaths: ["/health"], trustedProxies: ["10.0.0.0/8"] },
});
```

#### Mapas de código fuente

**No lo omitas: sin esto, los errores no muestran el código de la aplicación.** Va en el paso de CI que despliega, para que cada versión suba lo suyo.

La única excepción: un servidor que ejecuta su código tal cual, sin empaquetador ni TypeScript.

Crea una credencial de subida y guárdala en los secretos de la integración continua como COLLECTOR_UPLOAD_TOKEN. Luego, en la integración continua:

```sh
collector upload-tokens create "CI"
```

```sh
export GIT_SHA=$(git rev-parse HEAD)
npm run build
curl -fsSL https://packages.chrom.ar/collector/install.sh | sh
collector upload dist --url-prefix /dist --release "$GIT_SHA"
```

### JavaScript en el navegador

#### Instalación

Instala el paquete e inicialízalo antes que nada (el DSN puede ir en código del navegador). Esto es para Vite; para otros empaquetadores, mira la página de configuración.

```sh
npm install "@chrom-ar/collector@>=0.4.0"
```

```javascript
import * as Collector from "@chrom-ar/collector";
import { rum } from "@chrom-ar/collector/rum";

Collector.init({
  dsn: "<collector dsn>",
  environment: "production",
  release: __COLLECTOR_RELEASE__,
  rum: rum({ sampleRate: 1 }), // todas las pestañas
});
```

#### Errores

Los errores y rechazos sin capturar se informan solos. Informa lo que atrapen los límites de error (error boundaries) con Collector.captureException(error).

#### Velocidad

La opción rum de arriba mide las Web Vitals (versión 0.4.0 o posterior). Baja sampleRate en sitios con mucho tráfico.

#### Mapas de código fuente

**No lo omitas: sin esto, los errores no muestran el código de la aplicación.** Va en el paso de CI que despliega, para que cada versión suba lo suyo.

Agrega a la configuración de Vite, sin quitar lo que ya tiene:

```javascript
// vite.config: agrégalo a defineConfig({ … })
define: { __COLLECTOR_RELEASE__: JSON.stringify(process.env.GIT_SHA) },
build: { sourcemap: "hidden" },

// src/vite-env.d.ts (TypeScript)
declare const __COLLECTOR_RELEASE__: string | undefined;
```

Crea una credencial de subida y guárdala en los secretos de la integración continua como COLLECTOR_UPLOAD_TOKEN. Luego, en la integración continua:

```sh
collector upload-tokens create "CI"
```

```sh
export GIT_SHA=$(git rev-parse HEAD)
npm run build
curl -fsSL https://packages.chrom.ar/collector/install.sh | sh
collector upload ./dist --release "$GIT_SHA" --delete
```

### Cualquier otro lenguaje

#### Instalación

Todavía no hay paquete: envía los eventos por HTTP, como indica el protocolo: https://docs.clt.chrom.ar/docs/tecnico/protocolo/

## 5. Comprueba que funciona

Envía un evento de prueba y mira cómo llega:

```sh
collector test --dsn "$(collector dsn)"
collector issues list
```

Después, haz que la aplicación desplegada lance un error y comprueba que muestra el código de la aplicación, no líneas minificadas:

```sh
collector issues list
collector issues show <id>
```
