🚀 바이트코드의 지배자 (Bytecode Master)

JVM의 심장부를 관통하는 바이트코드 조작 엔진: Java Agent와 ByteBuddy를 이용한 런타임 최적화 탐구

📌 프로젝트 개요

JVM의 심장부인 바이트코드를 직접 조작하여 애플리케이션의 동작을 제어하고 최적화하는 '극한의 자바' 탐구 프로젝트입니다.

🛠️ 개발 환경

• JDK: Microsoft OpenJDK 17 (Run on Java 25)
• Library: ByteBuddy 1.14.12 (with byte-buddy-agent)
• Build: Gradle 9.0 (Kotlin DSL)

---

📅 개발 일지 (Changelog)

[2026-03-18] JDBC SQL 정밀 추적 및 Node.js 기반 중앙 수집 체계 구축

• Interception & Communication: ByteBuddy를 이용한 JDBC 실행 SQL 및 파라미터 추출 로직을 고도화하고, Java 11 HttpClient를 통해 수집된 데이터를 Node.js 서버로 비동기 전송하는 실시간 파이프라인 완성.
• Architecture & Config: Express 기반의 수집 서버(Collector)를 신규 구축하고, 에이전트와 숙주 앱을 포함한 프로젝트 전체를 모노레포(Monorepo) 구조로 재편하여 실무형 형상 관리 체계를 확립함.

[2026-03-07] 비동기 논블로킹(Non-blocking) 데이터 전송 큐 구현 및 Zero-overhead 달성

• Architecture: 에이전트의 데이터 처리가 타겟 애플리케이션의 메인 스레드(Tomcat) 성능에 영향을 주지 않도록 LinkedBlockingQueue 기반의 생산자-소비자(Producer-Consumer) 패턴 적용.
• Feature: 별도의 데몬 스레드(APM-DataSender-Thread)를 생성하여 수집된 성능 지표를 백그라운드에서 비동기로 처리. 상용 APM과 동일한 수준의 성능 최적화 달성.

[2026-03-05] JDBC PreparedStatement 바이트코드 조작 및 SQL 쿼리 추적 구현

• Feature: 외부 라이브러리(H2 JDBC Driver)의 JdbcPreparedStatement 클래스를 ByteBuddy로 동적 변환하여 DB 접근 계층 모니터링 성공.
• Improvement: 쿼리 실행 시간(ms) 측정 및 바인딩된 파라미터가 포함된 실제 SQL 쿼리 추출 기능 구현.
• Architecture: Controller 계층부터 DB Access 계층까지 동일한 TraceID를 유지하여 완벽한 End-to-End 분산 추적(Distributed Tracing) 파이프라인 완성.

[2026-02-25] ThreadLocal 기반 Trace ID(분산 추적) 기능 구현 완료

• Feature: ThreadLocal을 활용한 TraceContext 구현으로 멀티 스레드 환경에서 요청별 고유 ID 격리 성공.
• Feature: 신규 애노테이션 @Trace 도입. 요청 진입점에서 8자리 짧은 UUID를 발급하여 전체 실행 흐름 추적.
• Improvement: 모든 Advice(Timer, LogData, CatchError) 출력 포맷에 [TraceID: %s] 접두사 추가.
• Fix: 각 요청 종료 시 ThreadLocal.remove()를 강제 호출하여 웹 서버(Tomcat)의 스레드 풀 환경에서 발생할 수 있는 메모리 누수 및 ID 오염 방지.

[2026-02-25] Spring Boot 실전 연동 및 통합 테스트 완료

• Feature: 독립된 Spring Boot 환경(Tomcat)에 에이전트를 -javaagent 옵션으로 주입하여 완벽한 격리 환경 모니터링 성공.
• Fix: ByteBuddy의 ElementMatchers 스캔 범위를 TargetApp 단일 클래스에서 패키지 전체(com.extreme.java)로 확장하여 Controller 스캔 문제 해결.
• Docs: 테스트용 타겟 애플리케이션(spring-target-app) 프로젝트 내재화 및 실행 가이드 작성.

[2026-02-24] Dynamic Attach & Advice 인라인 주입 완성

• Feature: 실행 중인 JVM(Java 25)을 끄지 않고 외부에서 에이전트를 동적으로 주입하는 DynamicAttacher 구현.
• Arch: Java 25의 엄격한 스택 검증을 통과하기 위해 MethodDelegation 대신 Advice (Inlining) 방식 도입.
• Sol: net.bytebuddy.experimental 옵션을 코드 레벨에서 강제 활성화하여 최신 JDK 호환성 문제 해결.

[2026-02-20] 예외 추적 기능 구현

• Feature: @CatchError 애노테이션을 통해 메서드 실행 중 발생하는 예외(Exception)를 감지하고, 에러 타입 및 메시지를 자동 로깅하는 기능 추가.
• Arch: ExceptionInterceptor를 구현하여 기존 비즈니스 로직의 흐름을 방해하지 않고(비침습적) 예외를 추적 및 재발생(Re-throw)시키도록 설계.

[2026-02-18] 데이터 추적 기능 구현

• Feature: @LogData 애노테이션을 통해 메서드 파라미터 및 반환값(Return Value) 추적 기능 추가.
• Arch: DataLogInterceptor를 추가하여 성능 측정(@Timer)과 데이터 로깅 로직 분리.

[2026-02-15] 핵심 기능 구현 및 안정화

• Feature: @Timer 애노테이션 기반 메서드 실행 시간 측정 기능 구현.
• Refactor: 에이전트 리스너 최적화를 통한 로그 가독성 개선 (비즈니스 로직 집중).
• Infra: .gitignore 재설정 및 인덱스 초기화를 통한 저장소 구조 정화 완료.

[2026-02-15] 프로젝트 초기화

• Setup: Java Agent 기본 골격(premain) 및 ByteBuddy 라이브러리 연동.
• Base: 커스텀 애노테이션(@interface) 정의 및 Gradle 빌드 환경 구성.

---

💡 핵심 기술 결정 (Key Decisions)

• Zero-Downtime Monitoring: agentmain을 활용하여 무중단 상태에서 실시간 모니터링 기능을 On/Off 할 수 있는 아키텍처 확립.
• Advice over Interceptor: 런타임 클래스 재정의(Retransformation) 시 클래스 뼈대 변경 금지 규칙(disableClassFormatChanges)을 준수하기 위해 Advice 기술 사용.
• Multi-Interceptor: 하나의 에이전트에서 @Timer, @LogData 등 목적에 따라 다수의 인터셉터를 체이닝하여 적용.
• Annotation-Driven: 코드 수정 없이 애노테이션 부착만으로 모니터링 대상을 유연하게 선택.
• Runtime Manipulation: 소스 코드 수정 없이 JVM 로드 시점에 바이트코드를 조작하여 기능 주입.