tracewayapp/traceway

어떤 프로젝트인가요?

핵심 기능

• 01모든 OpenTelemetry SDK에서 로그, 트레이스, 메트릭을 수집하는 네이티브 OTLP/HTTP 인제스트.
• 02SHA-256 지문을 기준으로 예외를 그룹화하고 webpack, esbuild, Vite용 source map 지원.
• 03엔드포인트별 지연 시간 백분위수, 처리량, 오류율.
• 04웹 애플리케이션 및 Flutter용 세션 리플레이.
• 05gen_ai 속성을 통한 LLM 비용, 토큰, 대화 추적.
• 06이메일, Slack, Pushover, Telegram 또는 SMS를 통한 온콜 로테이션, 에스컬레이션 정책, 페이징.
• 07오류 예산과 소진율 알림을 포함한 SLO 목표.

활용 사례

• 리플레이와 심볼이 변환된 스택 트레이스를 활용해 웹 또는 모바일 앱의 프로덕션 예외를 디버깅.
• 별도의 Collector를 실행하지 않고 마이크로서비스의 로그, 트레이스, 메트릭을 한곳에 통합.
• LLM 기반 기능의 비용, 지연 시간, 대화 내용을 모니터링.
• SQLite를 사용하는 단일 컨테이너에서 자체 호스팅 옵저버빌리티 스택 운영.

빠른 시작

1. 1

   저장소를 클론합니다

   git clone https://github.com/tracewayapp/traceway
2. 2

   디렉터리로 이동해 Docker Compose로 시작합니다

   cd traceway && docker compose up -d

사용 전 알아둘 점

• !SQLite 또는 DuckDB 이미지를 선택하지 않으면 전체 스택을 셀프 호스팅할 때 Docker와 외부 데이터베이스를 실행해야 합니다.
• !README에서는 프로파일링을 실험적 기능으로 표시합니다.

포함된 컬렉션

토픽

자주 묻는 질문

traceway은(는) 무엇인가요?

로그, 트레이스, 메트릭, 예외, 세션 리플레이, 온콜 페이징을 통합한 오픈소스 OpenTelemetry 네이티브 옵저버빌리티 플랫폼으로, Docker로 직접 호스팅할 수 있습니다. Traceway는 OpenTelemetry를 기반으로 구축된 옵저버빌리티 플랫폼입니다. 로그, 트레이스, 메트릭, 예외, 웹 및 Flutter용 세션 리플레이, LLM/AI 트레이싱, 온콜 페이징을 하나의 시스템으로 통합합니다. 애플리케이션은 OTLP/HTTP를 통해 Traceway로 직접 데이터를 전송하므로, 백엔드 연동을 위해 별도의 Collector나 벤더 전용 SDK를 사용할 필요가 없습니다.

traceway은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

traceway은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

traceway은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. traceway의 마지막 커밋은 2026년 11월 6일입니다.

traceway은(는) 어디에 사용할 수 있나요?

리플레이와 심볼이 변환된 스택 트레이스를 활용해 웹 또는 모바일 앱의 프로덕션 예외를 디버깅. 별도의 Collector를 실행하지 않고 마이크로서비스의 로그, 트레이스, 메트릭을 한곳에 통합. LLM 기반 기능의 비용, 지연 시간, 대화 내용을 모니터링. SQLite를 사용하는 단일 컨테이너에서 자체 호스팅 옵저버빌리티 스택 운영.

traceway는 어떻게 설치하나요?

저장소를 클론합니다: git clone https://github.com/tracewayapp/traceway 디렉터리로 이동해 Docker Compose로 시작합니다: cd traceway && docker compose up -d

traceway은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/tracewayapp/traceway