hyperdxio/hyperdx

어떤 프로젝트인가요?

핵심 기능

• 01로그, 트레이스, 메트릭, 세션 리플레이와 오류를 한곳에서 검색하고 연관 지어 살펴볼 수 있습니다.
• 02선택적으로 raw SQL을 사용할 수 있는 속성 검색 구문을 제공하며, 모든 ClickHouse 스키마에서 사용할 수 있습니다.
• 03복잡한 쿼리 언어 없이 대시보드와 알림을 만들 수 있습니다.
• 04로그와 트레이스를 실시간으로 확인할 수 있습니다.
• 05브라우저, Node.js, Python용 SDK를 통한 네이티브 OpenTelemetry 수집을 지원합니다.
• 06HyperDX 데이터를 조회할 수 있는 터미널 UI와 CLI를 제공합니다.

활용 사례

• 세션 리플레이에서 해당 세션의 백엔드 로그와 트레이스로 이동해 프로덕션 오류를 진단합니다.
• 기존 ClickHouse 클러스터에서 셀프 호스팅 옵저버빌리티 스택을 운영합니다.
• HTTP 요청부터 데이터베이스 쿼리까지 애플리케이션 성능을 모니터링합니다.
• CLI를 통해 스크립트나 AI 에이전트에서 텔레메트리를 조회합니다.

빠른 시작

1. 1

   Docker로 올인원 HyperDX 컨테이너를 시작하세요

   docker run -p 8080:8080 -p 4317:4317 -p 4318:4318 docker.hyperdx.io/hyperdx/hyperdx-all-in-one
2. 2

   브라우저에서 http://localhost:8080 을 열어 UI에 액세스하세요

사용 전 알아둘 점

• !테스트에는 최소 4GB RAM과 2코어를 권장합니다.
• !전체 배포에는 ClickHouse, OpenTelemetry Collector, MongoDB가 포함되므로 셀프 호스팅에는 운영 작업이 필요합니다.

토픽

자주 묻는 질문

hyperdx은(는) 무엇인가요?

ClickHouse 기반으로 로그, 트레이스, 메트릭, 세션 리플레이와 오류를 검색하고 시각화하는 오픈소스 옵저버빌리티 플랫폼입니다. HyperDX는 ClickHouse 클러스터에 저장된 로그와 트레이스를 검색하고 시각화해 엔지니어가 프로덕션 문제의 원인을 찾도록 돕는 옵저버빌리티 플랫폼입니다. 기존 ClickHouse 스키마와 함께 사용할 수 있으며, 텔레메트리 수집을 위해 OpenTelemetry를 기반으로 구축되어 표준 OpenTelemetry SDK로 계측된 애플리케이션에 적용할 수 있습니다.

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

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

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

활발히 유지보수 중. hyperdx의 마지막 커밋은 2026년 10월 22일입니다.

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

세션 리플레이에서 해당 세션의 백엔드 로그와 트레이스로 이동해 프로덕션 오류를 진단합니다. 기존 ClickHouse 클러스터에서 셀프 호스팅 옵저버빌리티 스택을 운영합니다. HTTP 요청부터 데이터베이스 쿼리까지 애플리케이션 성능을 모니터링합니다. CLI를 통해 스크립트나 AI 에이전트에서 텔레메트리를 조회합니다.

hyperdx는 어떻게 설치하나요?

Docker로 올인원 HyperDX 컨테이너를 시작하세요: docker run -p 8080:8080 -p 4317:4317 -p 4318:4318 docker.hyperdx.io/hyperdx/hyperdx-all-in-one 브라우저에서 http://localhost:8080 을 열어 UI에 액세스하세요

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

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