자바 잘 읽는 법

라우렌치우 스필커 지음 | 이일웅 옮김

제이펍 2024년 06월 14일 출간 종이책 : 2024년 05월 09일 출간

작품소개

책소개

실무에서 개발자는 기존 코드를 읽고 이해하는 데 가장 많은 시간을 쓴다. 이 책은 익숙하지 않은 자바 코드를 파악하는 시간을 줄여주는 실용적인 기법들을 소개한다. 프로파일링과 디버깅, 나아가 JVM 애플리케이션이 실제로 어떻게 작동하는지 이해함으로써 디펜던시나 충돌의 근본 원인을 찾고, 예상치 못한 결과를 해석할 수 있다. 디버깅의 기초부터 마이크로서비스 아키텍처에서 문제를 찾기 위한 고급 방법까지, 딱딱하지 않은 그림과 흥미로운 실제 사례와 함께 자바 코드를 ‘잘 읽는 법’을 알려준다.

목차

옮긴이 머리말 x
베타리더 후기 xi
시작하며 xiv
감사의 글 xvi
이 책에 대하여 xviii
표지에 대하여 xxi

PART I 트러블슈팅 기본 테크닉

CHAPTER 1 앱에서 모호한 부분 밝히기 3
1.1 앱을 더 쉽게 이해하는 방법 4
1.2 일반적인 코드 조사 시나리오 8
__1.2.1 예상과 다른 아웃풋의 원인을 밝힌다 9
__1.2.2 특정 기술을 습득한다 14
__1.2.3 속도 저하 이유를 알아낸다 15
__1.2.4 앱 크래시가 발생하는 이유를 이해한다 16
1.3 이 책에서 배울 내용 19
요약 20

CHAPTER 2 디버깅 기법으로 앱 로직 이해하기 21
2.1 코드 분석만으로는 불충분한 경우 23
2.2 디버거를 이용한 코드 조사 26
__2.2.1 실행 스택 트레이스란 무엇이고 어떻게 사용해야 할까? 31
__2.2.2 디버거로 코드 탐색하기 36
2.3 디버거로도 충분하지 않다면 43
요약 45

CHAPTER 3 고급 디버깅 기법으로 문제의 근본 원인 찾기 47
3.1 조건부 브레이크포인트로 조사 시간 최소화 48
3.2 실행을 중단시키지 않고도 브레이크포인트를 사용하는 방법 52
3.3 조사 시나리오를 동적으로 변경하기 55
3.4 조사 케이스를 되감기 58
요약 64

CHAPTER 4 원격 앱 디버깅 65
4.1 원격 디버깅이란? 66
4.2 원격 환경에서 조사하기 69
__4.2.1 시나리오 70
__4.2.2 원격 환경의 문제 조사하기 71
요약 81

CHAPTER 5 로그를 활용하여 앱 동작 감시하기 83
5.1 로그를 이용하여 조사하기 87
__5.1.1 로그에 기록된 예외 식별 88
__5.1.2 예외 스택 트레이스로 어디서 메서드를 호출했는지 식별 89
__5.1.3 멀티스레드 아키텍처에서 커맨드의 실행 시간 측정 91
__5.1.4 멀티스레드 아키텍처에서 커맨드 실행 문제 조사 92
5.2 로깅을 구현하는 방법 94
__5.2.1 로그 메시지 저장 94
__5.2.2 로깅 레벨을 정의하고 로깅 프레임워크를 사용하는 방법 95
__5.2.3 로깅 때문에 발생하는 문제와 예방 조치 102
5.3 로그와 원격 디버깅 107
요약 108

PART II 트러블슈팅 고급 테크닉

CHAPTER 6 프로파일링 기법으로 리소스 사용 문제 파악하기 111
6.1 프로파일러는 어떤 경우에 유용할까? 112
__6.1.1 비정상적인 리소스 사용량 식별 112
__6.1.2 실행되는 코드 찾기 113
__6.1.3 앱 실행 속도가 느려지는 원인을 파악 114
6.2 프로파일러 사용 방법 114
__6.2.1 VisualVM 설치 및 구성 115
__6.2.2 CPU와 메모리 사용량 관찰 117
__6.2.3 메모리 누수 현상 식별 127
요약 132

CHAPTER 7 프로파일링 기법으로 숨겨진 이슈 찾기 133
7.1 샘플링으로 실행되는 코드 관찰 134
7.2 프로파일링으로 메서드의 실행 횟수 파악 142
7.3 프로파일러로 앱이 실제로 실행하는 SQL 쿼리 파악 144
__7.3.1 프로파일러로 프레임워크에서 생성되지 않은 SQL 쿼리 식별 144
__7.3.2 프로파일러로 프레임워크에서 생성된 SQL 쿼리 식별 150
__7.3.3 프로파일러로 프로그램에서 생성된 SQL 쿼리 식별 153
요약 157

CHAPTER 8 프로파일링한 데이터에 고급 시각화 도구 적용하기 159
8.1 JDBC 접속 문제 감지 160
8.2 호출 그래프를 보고 앱의 코드 설계 파악 173
8.3 플레임 그래프를 그려 성능 문제 밝히기 175
8.4 NoSQL DB에서의 쿼리 분석 179
요약 180

CHAPTER 9 멀티스레드 아키텍처의 락 문제 조사하기 183
9.1 스레드 락 모니터링 184
9.2 스레드 락 분석 189
9.3 대기 중인 스레드 분석 198
요약 205

CHAPTER 10 스레드 덤프로 데드락 문제 조사하기 207
10.1 스레드 덤프 수집하기 208
__10.1.1 프로파일러로 스레드 덤프 수집 210
__10.1.2 커맨드 라인에서 스레드 덤프 수집 212
10.2 스레드 덤프를 읽는 방법 215
__10.2.1 일반 텍스트 스레드 덤프 216
__10.2.2 도구를 활용하여 스레드 덤프 읽기 222
요약 225

CHAPTER 11 앱 실행 중 메모리 관련 이슈 찾기 227
11.1 샘플링과 프로파일링으로 메모리 이슈 진단 228
11.2 힙 덤프를 수집하여 메모리 누수가 발생하는 곳 찾기 235
__11.2.1 힙 덤프 수집 236
__11.2.2 힙 덤프 읽는 방법 240
__11.2.3 OQL 콘솔에서 힙 덤프 쿼리 245
요약 251

PART III 대규모 시스템의 트러블슈팅

CHAPTER 12 대규모 시스템에 배포된 앱의 동작 조사하기 255
12.1 서비스 간 통신 문제 조사 256
__12.1.1 HTTP 서버 프로브로 HTTP 요청 관찰 257
__12.1.2 HTTP 클라이언트 프로브로 앱이 보낸 HTTP 요청 관찰 259
__12.1.3 소켓의 로 레벨 이벤트 조사 261
12.2 통합 로그 모니터링의 중요성 263
12.3 배포 도구를 조사에 활용하는 법 270
__12.3.1 결함 주입으로 재현하기 곤란한 문제를 비슷하게 모방 272
__12.3.2 미러링 기법을 테스트 및 에러 감지에 활용 273
요약 274

APPENDIX A 이 책에서 사용한 도구 275

APPENDIX B 프로젝트 열기 277

APPENDIX C 기타 참고 도서 279

APPENDIX D 자바 스레드 이해 281
D.1 스레드란 무엇인가? 282
D.2 스레드의 수명 주기 284
D.3 스레드 동기화 286
__D.3.1 동기화 블록 286
__D.3.2 wait(), notify(), notifyAll() 사용 289
__D.3.3 스레드 조인 290
__D.3.4 정해진 시간 동안 스레드 차단 291
__D.3.5 스레드와 블로킹 객체 동기화하기 292
D.4 멀티스레드 아키텍처의 일반적인 문제 293
__D.4.1 경쟁 상태 293
__D.4.2 데드락 294
__D.4.3 리브락 295
__D.4.4 기아 296
D.5 추가 자료 297

APPENDIX E 자바 메모리 관리 체계 299
E.1 JVM이 앱의 메모리를 구성하는 방법 300
E.2 스레드가 로컬 데이터를 저장하는 데 사용하는 스택 302
E.3 앱이 객체 인스턴스를 저장하는 데 사용하는 힙 308
E.4 데이터 유형을 저장하기 위한 메타스페이스 메모리 위치 311

찾아보기 313

책 속으로

디버거는 개발자가 원하는 커맨드에서 실행을 잠깐씩 멈춰가며 단계별로 코드를 실행함으로써 소스 코드를 더 쉽게 읽고 이해할 수 있게 도와주는 소프트웨어 프로그램이다. 디버거가 소프트웨어 동작을 조사하는 일반적인 수단(또 개발자가 제일 처음에 배우는 방법)이긴 하지만, 디버깅 기법이 이것만 있는 것은 아니고 또 모든 시나리오에서 이렇게 하는 게 유용한 것도 아니다(디버거의 기본적인 사용법과 고급 기법은 2, 3장에서 설명한다). 이 책 전체를 통틀어 배우게 될 다양한 조사 기법은 그림 1.3과 같다. (6쪽)

모든 조사 기법이 늘 그렇듯이 로그 역시 사용하기 적합한 경우가 있고 그렇지 않은 경우도 있다. 이 절에서는 로그를 사용하면 앱 동작을 더 쉽게 이해할 수 있는 몇 가지 시나리오를 살펴보겠다. 먼저 로그 메시지에 관한 몇 가지 키 포인트를 이야기한 다음, 개발자가 앱의 문제점을 조사할 때 이러한 특성이 어떻게 도움이 되는지 알아본다. (87쪽)

프로파일러로 할 수 있는 가장 간단한 작업은 앱이 시스템 리소스를 사용하는 모습을 관찰하는 것이다. 이렇게만 보아도 앱에서 메모리 누수가 발생하거나 좀비 스레드가 생기는 등의 문제점을 발견할 수 있다. / 실행 중인 앱을 프로파일러로 들여다보면 비정상적인 앱 동작을 쉽게 발견할 수 있다. 가령, 앱 실행이 끝난 뒤에도 계속 실행 상태로 남아 앱의 리소스를 차지한 좀비 스레드는 VisualVM에서 바로 드러난다. 이제 비정상적으로 리소스를 소모하는 앱의 이상 징후를 VisualVM으로 어떻게 찾아내고 관찰하는지 살펴보자. (117쪽)

JDBC 드라이버를 프로파일링하여 앱이 DB에 전송한 쿼리를 가로챈다. 확인 결과(그림 7.14), 제품 테이블과 자기 스스로 셀프 조인(self join)을 하고 있다. 심각한 문제다! 이 예제는 테이블에 레코드가 달랑 10개뿐이라 별로 대수롭지 않아 보일 수도 있지만, 실제 앱이라면 테이블에 엄청나게 많은 레코드가 존재할 텐데, 이렇게 크로스 조인을 하면 엄청난 레이턴시는 피할 수 없고 결국 잘못된 아웃풋(중복된 행)이 표시될 것이다. VisualVM으로 쿼리를 가로채서 들여다보면 어디가 문제인지 바로 알 수 있다. (154쪽)

VisualVM에서 Sampler 탭을 선택한 다음 Memory 버튼을 클릭하면 메모리 사용량 샘플링 세션이 시작된다. 엔드포인트를 호출하고 실행이 완료될 때까지 기다리면 잠시 후 VisualVM 화면에 앱이 할당한 객체가 표시될 것이다. (…) 수많은 인스턴스가 메모리를 꽉 채우는 일은 알겠는데, 후자처럼 소수의 덩치 큰 인스턴스가 메모리 대부분을 차지할 가능성도 있을까? 대용량 동영상 파일을 처리하는 앱을 떠올리면 된다. 한 번에 2~3개의 파일을 로드하지만 동영상 파일은 용량이 워낙 커서 메모리를 가득 채울 수 있다. 이런 경우에는 앱이 전체 파일을 한꺼번에 메모리에 로드하지 않고 한 번에 일부만 로드하는 방식으로 최적화할 여지는 없는지 살펴볼 필요가 있다. (231쪽)

이 앱은 스프링 부트 기반으로 개발되었기 때문에 application.properties 파일에 다음 코드 스니펫과 같이 DSN 값을 sentry.dsn 애트리뷰트에 지정한다. 센트리에서 이 작업은 선택 사항이지만, 가능하면 앱이 실행되는 환경을 지정하는 것이 좋다. 그래야 나중에 이벤트를 필터링해서 관심 있는 이벤트만 추출할 수 있기 때문이다. (267쪽)

출판사 서평

코드 독해력을 높여 JVM 코드를 이해하고 디버깅하고 최적화하는 요령

커리어가 쌓일수록 코드를 작성하는 시간보다 코드를 읽는 시간이 훨씬 더 길어진다. 그 긴 시간을 효율적으로 쓰기 위한 코드 조사 기법을 다루는 게 바로 이 책이다. 디버깅이나 로깅의 기초부터 고급 프로파일링 기법과 JVM 애플리케이션의 작동 원리까지, 개발자 친화적인 시나리오 중심으로 트러블슈팅을 설명한다는 점이 큰 장점이다.

1부는 코드베이스를 파악하기 위한 조사 기법의 기초를 다룬다. 2~4장에서는 디버깅을 중심으로 간단히 브레이크포인트를 찍는 것부터 원격 디버깅까지 설명하고, 5장은 로그를 이용해 코드 구현과 관련된 필수 세부 정보를 조사하는 방법을 살펴본다.

2부는 프레임워크가 큰 비중을 차지하는 오늘날 개발에서 프로파일링이 얼마나 유용할 수 있는지 잘 보여준다. , VisualVM과 JProfiler 같은 프로파일러 도구를 이용한 6장에서는 CPU와 메모리 사용량을 분석하는 방법을 다루고, 7장에서는 레이턴시 문제를 조사하는 방법을 다룬다. 8, 9장에서는 멀티스레드 아키텍처를 자세히 파헤치고, 10장에서는 스레드 덤프를, 11장에서는 힙 덤프를 생성하여 메모리 문제를 진단하는 방법을 살펴본다.

3부 12장은 단일 앱이 아닌 여러 앱으로 이루어진 대규모 엔터프라이즈 시스템에서 문제를 조사하는 방법을 설명한다. 각 앱이 서로 ‘소통’하는 방식, 앱이 배포된 환경이 미치는 영향, 구현 시 고려 사항 등을 살펴본다. 끝으로 부록에서는 자바 개발자들에게 실질적인 도움이 되는 자바 스레드와 메모리 관리 체계를 정말로 자세히 설명한다.

JVM 애플리케이션이 실제로 어떻게 작동하는지 이해하면 문제의 근본 원인을 찾을 수 있다. 디버깅과 로깅을 올바르게 익힐 수 있는 것은 물론, 마이크로서비스 아키텍처에서 문제를 찾기 위한 고급 기법까지 포괄적으로 다루는, 흔치 않은 책이다.

주요 내용
● 처음 본 코드가 어떤 기능을 하는지 파악하기
● 코드 로직 문제 노출하기
● 힙 덤프를 평가하여 메모리 누수 찾기
● CPU 사용량을 모니터링하여 실행 최적화하기
● 스레드 덤프를 사용하여 교착 상태 찾고 해결하기
● 서비스 지향/마이크로서비스 시스템 이해하기
● 로깅을 제대로 사용하여 자바 앱 실행을 깊이 이해하기
● 자바 디버거를 효율적으로 사용하기

작가정보

저자(글) 라우렌치우 스필커

(Laurențiu Spilcă)
엔다바(Endava)의 개발 리드로서 유럽, 미국, 아시아 등 여러 지역에서 다수의 프로젝트를 리드하고 컨설팅하는 일을 맡고 있다. 2007년부터 소프트웨어 개발 분야에 종사했다. 고품질의 소프트웨어를 제공하는 것뿐만 아니라 지식을 공유하고 타인의 기술 향상을 돕는 일도 중요하다고 믿고, 이러한 신념을 바탕으로 자바 기술 관련 강좌를 기획하며 각종 프레젠테이션과 워크숍을 진행하고 있다. 다른 저서로는 《스프링 시큐리티 인 액션》(위키북스, 2022)과 《Spring Start Here》(Manning, 2021)가 있다.

번역 이일웅

20년 가까이 국내외 엔터프라이즈 현장에서 자바 전문 풀스택 개발자, 소프트웨어 아키텍트로 프로젝트에 참여해왔다. 어느덧 50대를 바라보는 중년 아재가 되었지만 아직도 기술이 궁금한 엔지니어다. 20여 종의 IT 전문서를 번역하며 동료, 후배 개발자들과 지식과 경험을 나누는 일에도 힘쓰고 있다. 집에서는 세 여인의 분에 넘치는 사랑을 받고 사는, 세상에서 제일 행복한 딸바보 아빠다.