Skip to content

ApiLens v0.1.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 03 Jun 16:27
v0.1.0
b6cf016

ApiLens v0.1.0 — 첫 공개 릴리스 | First public release

Spring Boot 운영자를 위한 가벼운 호출 추적 도구입니다. 코드 수정 없이 -javaagent: 한 줄로
부착하여 controller → service → repository → SQL 흐름과 각 단계의 payload를 한 화면에서 봅니다.

A lightweight call-tracing tool for Spring Boot operators. Attach with one -javaagent: flag — no
code change — and see the controller → service → repository → SQL flow with per-step payloads on a
single screen.

이 릴리스는 실제 운영 시스템 dogfooding(60,000+ trace)을 거쳐 호스트 영향 P0 이슈를 잡은 뒤
출시되었습니다. Dogfooded against a live production system before release.

다운로드 | Downloads

파일 용도
apilens-server-0.1.0.jar ApiLens server (UI 임베드). java -jar 로 실행
apilens-agent-0.1.0.jar 사용자 앱에 -javaagent: 로 부착

빠른 시작 | Quick Start

# 1. server 실행 (포트 8765)
java -jar apilens-server-0.1.0.jar

# 2. 브라우저에서 Setup wizard
open http://localhost:8765

# 3. 자기 앱에 agent 부착 후 재기동
java -javaagent:/path/to/apilens-agent-0.1.0.jar \
     -Dapilens.server=http://localhost:8765 \
     -Dapilens.service.name=my-app \
     -jar my-app.jar

주요 기능 | Highlights

  • 무중단 부착 — 코드 수정 0줄, ByteBuddy premain, 모든 의존성 relocate로 호스트 클래스 충돌 0
  • 노드 그래프 추적 — controller → service → repository → SQL을 mind-map으로 시각화
  • MyBatis Mapper 자동 추적 — @Mapper 인터페이스 호출 캡처
  • JDBC 파라미터/결과셋 캡처 — SQL의 ? 자리에 실제 값 표시 (kill switch 제공)
  • server-side PII 마스킹 — 주민번호·카드번호·password/token 기본 룰 자동 적용
  • Setup wizard — 브라우저에서 옵션 선택 → 부착용 JVM 옵션 한 줄 생성
  • 단일 jar 배포 — server + UI가 하나의 jar

⚠️ 업그레이드 안내 | Upgrade note

사전 dogfooding으로 0.1.0-SNAPSHOT 빌드를 배포한 환경(예: NAS 원격)은 즉시 0.1.0으로
재배포하기를 권장합니다. wizard 옵션 키 변경과 호스트 데이터 무결성 fix가 포함되어 있습니다.

If you deployed a 0.1.0-SNAPSHOT build during pre-release dogfooding, redeploy to 0.1.0
immediately — this release contains wizard option-key corrections and host data-integrity fixes.

v0.1 한계 | Limitations

  • 단일 서비스 추적 (MSA 분산 trace는 v0.3 예정)
  • 동기 호출만 (@Async / WebFlux는 v0.2)
  • 메서드 파라미터 이름이 arg0·arg1… 인덱스로 표시 (-parameters 컴파일 옵션으로 실제 이름 표시 가능)
  • JDBC 파라미터의 키 이름 기반 마스킹 한계 — 민감 컬럼 우려 시 apilens.jdbc.capture-params=false
  • 인증·권한 없음 (운영망 내부, 신뢰된 네트워크 사용 가정)

전체 변경 내역은 CHANGELOG를 참조하세요. See the full changelog for details.

License: Apache 2.0 · 무료 오픈소스 (donation only)

Assets 4
Loading