MapleTechLabs/maple

어떤 프로젝트인가요?

핵심 기능

• 01벤더 에이전트 없이 표준 OTLP로 트레이스, 로그, 메트릭을 수집합니다.
• 02트레이스 워터폴과 서비스 맵에서 각 span과 edge의 요청, 오류, 지연 시간 데이터를 확인할 수 있습니다.
• 03패싯을 지원하는 로그 검색으로 로그를 해당 로그를 생성한 트레이스에 연결합니다.
• 04오류 이슈를 담당자에게 할당하고 해결 처리하거나 알림을 설정할 수 있습니다.
• 05경고 규칙을 통해 PagerDuty, Discord, Telegram, 이메일 또는 웹훅으로 알림을 보냅니다.
• 06느린 요청이나 프런트엔드 오류를 디버깅할 수 있는 브라우저 세션 리플레이를 제공합니다.
• 07호스팅 MCP 서버를 통해 코딩 에이전트가 텔레메트리를 조회할 수 있습니다.

활용 사례

• 하나의 도구에서 트레이스, 로그, 메트릭을 살펴보며 느린 요청이나 장애가 발생한 서비스를 조사합니다.
• ClickHouse 스토리지를 사용해 자체 인프라에서 옵저버빌리티 스택을 자체 호스팅합니다.
• 디버깅 중 Claude Code나 Cursor 같은 코딩 에이전트가 프로덕션 텔레메트리를 읽도록 합니다.
• 배포 전에 단일 바이너리로 로컬에서 OpenTelemetry 계측을 시험해 봅니다.

빠른 시작

1. 1

   Homebrew로 maple CLI 설치하기

   brew install Makisuo/tap/maple
2. 2

   Maple을 로컬에서 시작하기(포트 4318에서 OTLP 수신, 내장 ClickHouse, 대시보드)

   maple start

사용 전 알아둘 점

• !README에는 오픈 소스 라이선스가 명확히 명시되어 있지 않으며, 감지된 라이선스는 NOASSERTION입니다.
• !전체 스택을 셀프 호스팅하는 과정은 복잡하며 Cloudflare, Clerk, Infisical 및 Postgres 설정에 의존합니다.
• !소스에서 개발하려면 Bun 1.3 이상과 여러 환경 변수가 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

maple은(는) 무엇인가요?

OpenTelemetry와 ClickHouse 기반의 트레이스, 로그, 메트릭 오픈소스 옵저버빌리티 플랫폼입니다. Maple은 OpenTelemetry 프로토콜(OTLP)을 통해 트레이스, 로그, 메트릭을 수집하고 ClickHouse에 저장하는 옵저버빌리티 플랫폼입니다. 독점 에이전트나 벤더 SDK 없이도 모든 OTLP exporter나 collector에서 데이터를 전송할 수 있습니다. 트레이스 워터폴, 로그 검색, 메트릭 탐색기, 대시보드에서 같은 필터와 시간 범위를 공유합니다.

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

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

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

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

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

하나의 도구에서 트레이스, 로그, 메트릭을 살펴보며 느린 요청이나 장애가 발생한 서비스를 조사합니다. ClickHouse 스토리지를 사용해 자체 인프라에서 옵저버빌리티 스택을 자체 호스팅합니다. 디버깅 중 Claude Code나 Cursor 같은 코딩 에이전트가 프로덕션 텔레메트리를 읽도록 합니다. 배포 전에 단일 바이너리로 로컬에서 OpenTelemetry 계측을 시험해 봅니다.

maple는 어떻게 설치하나요?

Homebrew로 maple CLI 설치하기: brew install Makisuo/tap/maple Maple을 로컬에서 시작하기(포트 4318에서 OTLP 수신, 내장 ClickHouse, 대시보드): maple start

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

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