APM 성능 모니터링 — 시뮬레이터 기준으로 만든 수집·분석 화면

애플리케이션 서버의 성능을 실시간으로 보고 장애 원인을 추적하는 APM(애플리케이션 성능 모니터링)을 사내 시스템으로 만든 사례다. 상용 APM에 대응하는 기능 목록(42개 항목)을 기준으로 수집·분석·화면을 Claude Code로 구현했고, 기능 시험은 에이전트 시뮬레이터가 만든 데이터로 했다.

데이터 흐름은 에이전트 메트릭 수신(1초) → 경보 규칙 평가(1초) → TimescaleDB 배치 저장(5초) → WebSocket 전달(1초)이며, Redis에 30초 동안 버퍼링한다.

개발까지 진행했고 운영에는 적용하지 않았다.

• APM 개발 과제를 진행했고, 구현에는 Claude Code를 활용했다. 개발은 핵심 모니터링 → 분석·진단 → 통계·보고서 → 고급 기능 → 연동·확장의 5단계로 기록돼 있다. 기능 선택·단계 설정·결과 점검을 본인이 했다는 행동 기록은 원자료에 없어 적지 않는다.

• 실시간 대시보드(1초 WebSocket 갱신), X-View 트랜잭션 산점도와 콜트리, 에러·SQL·JVM·DB 분석, 경보(규칙 8개·심각도 3단계), Z-score 이상 탐지·상관 분석·용량 예측, 서비스 토폴로지 화면을 구현했다. 기능 시험 데이터는 가상 WAS 인스턴스의 메트릭을 1초마다 만드는 에이전트 시뮬레이터에서 왔다.
• 내부 통합 시험에서 백엔드 테스트 124건 중 124건, 프론트엔드 단위 테스트 36건 중 36건이 통과했고, Next.js 빌드에서 21개 정적 페이지·라우트 생성이 기록됐다(2026-02-22, macOS 로컬 개발 환경).
• 기능 시험과 별도로, 로컬 개발 환경에서 사내 앱 개발판 2종(고객 Care 백엔드·HUB IAM)에 넣은 앱 내장 수집 코드(요청 인터셉터·HTTP 훅)로 수집 연동을 시험했다. 이 페이지의 화면 캡처는 이 연동 시험 때 찍은 것이다.

• 바이트코드 계측 Java Agent, Node.js Agent 같은 언어별 독립 수집 에이전트는 다음 과제로 남았다. Node.js·.NET·PHP 지원 항목은 시뮬레이션 인스턴스로만 확인했다.
• 그래서 소개자료의 「엔터프라이즈 솔루션」「지원 플랫폼」「사내 개발 → 즉시 적용」 같은 표현은 이 페이지에 쓰지 않는다. 사내 도입·운영 기록은 없다.
• 구현 현황 문서(2026-02-22 점검)의 「기능 42개 항목 100% 구현」은 시뮬레이터 데이터 기준 표기이며, 실제 서비스 트래픽으로 검증한 수치가 아니다.
• AI 기반 이상 원인 설명, 브라우저 E2E 시험, 배포 자동화도 로드맵에만 있다.

• Next.js 16 · React 19 · Zustand · Recharts, Spring Boot 3.2 · Java 17 · MyBatis · Netty(UDP 수집) · WebSocket, TimescaleDB(PostgreSQL 16) · Redis, Docker Compose, JUnit(mvn test) · Vitest