gotcha
Plataforma auto-alojada de observabilidad en Go con binario único, compatible con Sentry SDK y OTLP. Gestiona errores, trazas, métricas, logs y monitorización de uptime sobre PostgreSQL y ClickHouse.
Ficha actualizada 28 sept 2026, 7:43 · upstream 28 sept 2026, 7:26 · release v1.8.1
Qué es gotcha
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Gotcha es una plataforma de observabilidad auto-alojada construida en Go que centraliza el seguimiento de errores, la trazabilidad de rendimiento, métricas, monitoreo de disponibilidad y perfiles. Se distingue por ser un binario único (`gotcha`) con modos configurables vía `--mode`, lo que simplifica el despliegue frente a stacks monolíticos complejos. Utiliza una arquitectura de almacenamiento híbrida: PostgreSQL para estado relacional (usuarios, proyectos, reglas) y ClickHouse para volúmenes altos de telemetría (eventos, trazas, métricas), permitiendo retenciones configurables por señal.
- Reemplazar Sentry.io o Datadog en entornos auto-alojados sin cambiar el SDK del cliente.
- Monitorización de infraestructura propia mediante el agente `gotcha-agent` para métricas de sistema.
- Detección de regresiones de rendimiento y análisis de dependencias externas desde trazas.
- Gestión de incidentes con agrupación automática y escalonamiento de notificaciones por severidad.
- Cumplimiento de SLOs y presupuestos de error con alertas de tasa de quema (burn-rate).
- Auditoría de seguridad mediante filtrado automático de PII (IPs, emails) en los datos ingeridos.
- Compatibilidad nativa con el protocolo de ingestión de Sentry SDK sin modificar el código del cliente.
- Arquitectura binaria única en Go que separa lógica de ingestión, web y uptime mediante flags.
- Almacenamiento dual optimizado: PostgreSQL para metadatos y ClickHouse para análisis de series temporales.
- Protección de privacidad por defecto con redacción automática de PII y protección contra SSRF.
- Soporte completo para OTLP (traces, metrics, logs) e ingesta de perfiles pprof.
- Sistema de alertas escalonado que notifica a más personas según la duración del incidente.
- Requiere Docker y Docker Compose; no ofrece despliegue one-click o binarios precompilados para producción directa.
- La variable `GOTCHA_SECRET_KEY` debe configurarse manualmente con un valor seguro en entornos de producción.
- Las cuotas de ingestión son ilimitadas por defecto en modo `oss`, lo que exige límites manuales si se expone DSN públicamente.
- Dependencia crítica de dos bases de datos externas (PostgreSQL y ClickHouse) para la persistencia de datos.
- La interfaz web utiliza templ; no es una SPA moderna, aunque ofrece dashboards funcionales.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Despliegue recomendado con Docker Compose en puerto 59080. Generar un `GOTCHA_SECRET_KEY` aleatorio fuerte antes de iniciar para evitar vulnerabilidades OAuth. Configurar `GOTCHA_SMTP_HOST` para activar alertas por email. Ajustar retenciones en ClickHouse (`EVENT_RETENTION_DAYS`, etc.) según políticas de cumplimiento. Para nodos remotos, usar el modo `probe` o instalar `gotcha-agent`. Verificar salud con `/readyz` antes de exponer al tráfico.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.