Plataforma open source de observabilidade para pesquisar e visualizar logs, traces, métricas, replays de sessão e erros no ClickHouse.
- Estrelas
- 1,763
- Forks
- 93
- Issues abertas
- 28
- Último commit
- ontem
O que é?
Traceway é uma plataforma de observabilidade criada nativamente com OpenTelemetry. Ela reúne logs, traces, métricas, exceções, reprodução de sessões web e Flutter, tracing de LLM/IA e alertas de plantão em um único sistema. As aplicações enviam dados diretamente para o Traceway via OTLP/HTTP, sem exigir um Collector separado nem SDKs específicos de fornecedores para os backends.
É possível hospedar o Traceway por conta própria com docker compose, usando SQLite, DuckDB ou ClickHouse com PostgreSQL como armazenamento, ou incorporá-lo a uma aplicação Go usando SQLite. As exceções recebem fingerprints e são agrupadas em incidentes ordenados por prioridade; falhas em JavaScript minificado, iOS, Android e Flutter são mapeadas de volta aos locais originais do código-fonte usando source maps, dSYMs ou mapeamentos R8 enviados à plataforma.
O projeto também inclui uma CLI somente leitura voltada a agentes e agent skills para Claude Code, Cursor e Codex, com acesso de escrita opcional para agentes. É licenciado sob MIT e inclui acompanhamento de SLO, integrações de alertas e uma visão geral da frota em vários projetos.
Recursos principais
- 01Ingestão nativa via OTLP/HTTP de logs, traces e métricas de qualquer SDK do OpenTelemetry.
- 02Agrupamento de exceções por fingerprint SHA-256, com suporte a source maps para webpack, esbuild e Vite.
- 03Percentis de latência por endpoint, throughput e taxa de erros.
- 04Reprodução de sessões para aplicações web e Flutter.
- 05Acompanhamento de custos, tokens e conversas de LLM por meio de atributos gen_ai.
- 06Escalas de plantão, políticas de escalonamento e alertas via e-mail, Slack, Pushover, Telegram ou SMS.
- 07Objetivos de SLO com orçamentos de erro e alertas de burn rate.
Casos de uso
- Depurar exceções em produção em aplicações web ou mobile com reprodução de sessões e stack traces com símbolos resolvidos.
- Consolidar logs, traces e métricas de microsserviços sem executar um Collector separado.
- Monitorar recursos baseados em LLM quanto a custos, latência e conteúdo das conversas.
- Executar uma stack de observabilidade hospedada por conta própria em um único contêiner com SQLite.
Início rápido
- 1
Clone o repositório
git clone https://github.com/tracewayapp/traceway - 2
Entre no diretório e inicie com Docker Compose
cd traceway && docker compose up -d
Antes de usar
- Para hospedar toda a stack por conta própria, é necessário executar o Docker e bancos de dados externos, a menos que você escolha a imagem de SQLite ou DuckDB.
- O README indica que a criação de perfis é experimental.
Em coleções
Tópicos
Perguntas frequentes
- O que é traceway?
- Plataforma de observabilidade open source e nativa do OpenTelemetry que reúne logs, traces, métricas, exceções, reprodução de sessões e alertas de plantão, com hospedagem própria via Docker. Traceway é uma plataforma de observabilidade criada nativamente com OpenTelemetry. Ela reúne logs, traces, métricas, exceções, reprodução de sessões web e Flutter, tracing de LLM/IA e alertas de plantão em um único sistema. As aplicações enviam dados diretamente para o Traceway via OTLP/HTTP, sem exigir um Collector separado nem SDKs específicos de fornecedores para os backends.
- traceway é gratuito? Qual é a licença?
- traceway é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- traceway ainda é mantido?
- Manutenção ativa. O último commit de traceway foi em 6 de nov. de 2026.
- Para que posso usar traceway?
- Depurar exceções em produção em aplicações web ou mobile com reprodução de sessões e stack traces com símbolos resolvidos. Consolidar logs, traces e métricas de microsserviços sem executar um Collector separado. Monitorar recursos baseados em LLM quanto a custos, latência e conteúdo das conversas. Executar uma stack de observabilidade hospedada por conta própria em um único contêiner com SQLite.
- Como instalar traceway?
- Clone o repositório: git clone https://github.com/tracewayapp/traceway Entre no diretório e inicie com Docker Compose: cd traceway && docker compose up -d
- Onde consigo traceway?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/tracewayapp/traceway
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Plataforma open source de monitoramento full-stack que reúne reprodução de sessões, monitoramento de erros, logs e traces, com hospedagem própria via Docker.
Sistema open source de observabilidade em tempo real e sem agentes, que unifica métricas, logs, alertas, notificações e páginas de status, com análise assistida por IA.
Uma distribuição do OpenTelemetry Collector com pipelines programáveis baseados em expressões para métricas, logs, traces e profiles, desenvolvida com foco na integração com Prometheus.
Backend de observabilidade self-hosted que recebe logs, métricas, traces e perfis, e os disponibiliza por APIs compatíveis com Loki, Prometheus, Tempo e Pyroscope.
Banco de dados open source para observabilidade que armazena métricas, logs e traces em um único mecanismo colunar sobre object storage, consultável com SQL e PromQL.