irockel/tda

해결하는 문제

TDA(Thread Dump Analyzer)는 Java 개발자가 Java VM의 스레드 덤프와 힙 정보를 구조화된 방식으로 분석할 수 있도록 도와주어 성능 저하, 데드락, 메모리 문제를 진단하는 데 도움을 줍니다. 로그 파일에서 복잡한 원시 스택 트레이스를 수동으로 읽을 필요가 없습니다.

작동 방식

TDA는 텍스트 또는 JSON 기반의 스레드 덤프를 분석하여 직관적인 트리 구조로 정리합니다. 독립형 GUI 애플리케이션, VisualVM 또는 JConsole용 플러그인, 또는 헤드리스 MCP 서버로 사용할 수 있습니다. MCP 모드에서는 check_deadlocks 및 find_long_running과 같은 도구를 제공하여 AI 에이전트가 전체 원시 파일을 읽지 않고도 프로그래밍 방식으로 로그를 분석할 수 있게 합니다.

대상 사용자

생산 환경 문제를 디버깅해야 하는 Java 개발자 및 시스템 관리자. 가상 스레드의 핀닝을 분석하거나, Java 애플리케이션에서 멈춘 스레드를 식별해야 하는 경우(1.4.x부터 21+까지 지원).

주요 기능

• AI 통합: Cursor나 Claude Desktop과 같은 AI 도구를 통해 헤드리스 분석을 가능하게 하는 Model Context Protocol(MCP) 구현.
• 가상 스레드 지원: Java 19 이상에서 사용 가능한 가상 스레드의 핀닝 및 캐리어 스레드 관계를 전용으로 탐지.
• 데드락 탐지: 상세한 모니터 정보와 함께 데드락을 자동으로 식별.
• 다중 모드 배포: 독립형 JAR, VisualVM 플러그인, JConsole 플러그인, 또는 네이티브 macOS 바이너리로 제공.
• 장시간 실행 스레드 탐지: 연속된 덤프를 비교하여 여러 스냅샷에 걸쳐 지속되는 스레드를 찾음.