Plataforma de observabilidad de código abierto para buscar y visualizar logs, trazas, métricas, reproducciones de sesiones y errores sobre ClickHouse.
- Estrellas
- 1,763
- Forks
- 93
- Issues abiertos
- 28
- Último commit
- ayer
¿Qué es?
Traceway es una plataforma de observabilidad creada de forma nativa sobre OpenTelemetry. Reúne logs, trazas, métricas, excepciones, reproducción de sesiones web y de Flutter, trazabilidad de LLM/IA y alertas de guardia en un solo sistema. Las aplicaciones envían datos directamente a Traceway mediante OTLP/HTTP, por lo que no hace falta un Collector independiente ni un SDK específico de cada proveedor para los backends.
Se puede alojar en infraestructura propia con docker compose y usar SQLite, DuckDB o ClickHouse con PostgreSQL como almacenamiento, o integrarse dentro de una aplicación Go usando SQLite. Las excepciones se identifican mediante fingerprints y se agrupan en incidencias clasificadas por prioridad. Los errores de JavaScript minificado y los fallos de iOS, Android y Flutter se vinculan con sus ubicaciones originales en el código fuente mediante source maps, dSYMs o mappings de R8 cargados previamente.
El proyecto también incluye una CLI de solo lectura orientada a agentes y skills para Claude Code, Cursor y Codex, con acceso de escritura opcional para los agentes. Tiene licencia MIT e incluye seguimiento de SLO, integraciones de alertas y una vista general de la flota en todos los proyectos.
Funciones clave
- 01Recepción nativa mediante OTLP/HTTP de logs, trazas y métricas desde cualquier SDK de OpenTelemetry.
- 02Agrupación de excepciones mediante fingerprints SHA-256 y compatibilidad con source maps de webpack, esbuild y Vite.
- 03Percentiles de latencia, volumen de solicitudes y tasa de errores por endpoint.
- 04Reproducción de sesiones para aplicaciones web y Flutter.
- 05Seguimiento del costo, los tokens y las conversaciones de LLM mediante atributos gen_ai.
- 06Turnos de guardia, políticas de escalado y alertas por email, Slack, Pushover, Telegram o SMS.
- 07Objetivos de SLO con presupuestos de error y alertas por tasa de consumo.
Casos de uso
- Depurar excepciones en producción en una aplicación web o móvil mediante la reproducción de sesiones y trazas de pila con símbolos resueltos.
- Centralizar logs, trazas y métricas de microservicios sin ejecutar un Collector independiente.
- Supervisar funciones basadas en LLM para controlar costos, latencia y contenido de las conversaciones.
- Ejecutar una pila de observabilidad alojada en infraestructura propia en un solo contenedor con SQLite.
Inicio rápido
- 1
Clona el repositorio
git clone https://github.com/tracewayapp/traceway - 2
Entra en el directorio e inicia el proyecto con Docker Compose
cd traceway && docker compose up -d
Antes de usarlo
- Para alojar por tu cuenta toda la pila, debes ejecutar Docker y bases de datos externas, a menos que elijas la imagen de SQLite o DuckDB.
- El README indica que la creación de perfiles es experimental.
En colecciones
Temas
Preguntas frecuentes
- ¿Qué es traceway?
- Plataforma de observabilidad open source nativa de OpenTelemetry que combina logs, trazas, métricas, excepciones, reproducción de sesiones y alertas de guardia, alojable con Docker. Traceway es una plataforma de observabilidad creada de forma nativa sobre OpenTelemetry. Reúne logs, trazas, métricas, excepciones, reproducción de sesiones web y de Flutter, trazabilidad de LLM/IA y alertas de guardia en un solo sistema. Las aplicaciones envían datos directamente a Traceway mediante OTLP/HTTP, por lo que no hace falta un Collector independiente ni un SDK específico de cada proveedor para los backends.
- ¿traceway es gratuito? ¿Qué licencia tiene?
- traceway es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿traceway sigue mantenido?
- Mantenimiento activo. El último commit de traceway fue el 6 nov 2026.
- ¿Para qué puedo usar traceway?
- Depurar excepciones en producción en una aplicación web o móvil mediante la reproducción de sesiones y trazas de pila con símbolos resueltos. Centralizar logs, trazas y métricas de microservicios sin ejecutar un Collector independiente. Supervisar funciones basadas en LLM para controlar costos, latencia y contenido de las conversaciones. Ejecutar una pila de observabilidad alojada en infraestructura propia en un solo contenedor con SQLite.
- ¿Cómo se instala traceway?
- Clona el repositorio: git clone https://github.com/tracewayapp/traceway Entra en el directorio e inicia el proyecto con Docker Compose: cd traceway && docker compose up -d
- ¿Dónde consigo traceway?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/tracewayapp/traceway
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Plataforma open source de monitorización full stack que combina reproducción de sesiones, monitorización de errores, logs y trazas, y que se puede alojar en servidores propios con Docker.
Sistema de observabilidad de código abierto, sin agentes y en tiempo real, que unifica métricas, logs, alertas, notificaciones y páginas de estado, con análisis asistido por IA.
Una distribución de OpenTelemetry Collector con pipelines programables basados en expresiones para métricas, logs, trazas y perfiles, diseñada para integrarse con Prometheus.
Backend de observabilidad autogestionado que recibe logs, métricas, trazas y perfiles, y los ofrece mediante APIs compatibles con Loki, Prometheus, Tempo y Pyroscope.
Una base de datos de observabilidad de código abierto que almacena métricas, logs y trazas en un único motor columnar sobre almacenamiento de objetos, consultable con SQL y PromQL.