Observabilidad
Stack
| Componente | Rol | Puerto |
|---|---|---|
| OTel Collector | Recolecta trazas/métricas/logs | 4317 (gRPC), 4318 (HTTP) |
| SigNoz | UI de observabilidad (trazas + métricas) | 3301 |
| ClickHouse | Storage de SigNoz | 9100 |
| Grafana | Dashboards opcionales | 3030 |
Arquitectura
Levantar la infra de observabilidad
pnpm obs:up # compose principal + observabilidad
pnpm obs:down # bajar todo
El stack de observabilidad vive en docker-compose.observability.yml, separado
del compose principal. Es opt-in: si no se levanta, la API funciona igual.
OpenReplay (Cloud)
Grabación de sesiones de usuario en el frontend:
- Tracker inicializado post-login con userId, email, tenant
- Solo se activa si
VITE_OPENREPLAY_PROJECT_KEYestá configurado - Dashboard en openreplay.com