🔍 앱은 정상 작동하지만 내부에서 무슨 일이 일어나는지 모르시나요?

Source: Dev.to

애플리케이션이 느리게 응답하는데 정확히 어디가 문제인지 모른 적 있나요?
컨트롤러는 응답하지만 서비스가 얼마나 걸렸는지 모를 때?
데이터베이스가 느린 건지 로직이 원인인지?
모든 것이 로컬에서는 잘 동작하지만 내부적으로 무슨 일이 일어나고 있는지 이해하지 못할 때?

바로 여기서 현대적인 관측성(observability)이 등장합니다.

이 글에서는 실용적이고 깊이 있게 다음을 이해하게 됩니다:

• 관측성이 실제로 무엇인지
• 분산 트레이스가 어떻게 동작하는지
• OpenTelemetry가 내부적으로 무엇을 하는지
• Collector가 어떤 용도로 쓰이는지
• Jaeger가 전체를 어떻게 시각화하는지
• Spring Boot 애플리케이션을 자동으로 계측하는 방법

모두 전통적이고 간단한 실제 애플리케이션에 적용됩니다.
그리고 가장 좋은 점: 이 저장소에서 직접 실행해 볼 수 있다는 것!

👉

🧠 1. 관측성

관측성은 세 가지 핵심 기둥에 기반합니다:

• Logs → 무슨 일이 일어났는지
• Metrics → 얼마나 일어났는지
• Traces → 어떻게 일어났는지

트레이스는 애플리케이션 내 요청의 전체 경로를 재구성할 수 있게 해줍니다. 앱이 작다고 해서 트레이스가 필요 없지는 않습니다; 내부 동작을 이해하려면 트레이스가 필요합니다.

🔎 2. 트레이스란?

트레이스는 요청의 전체 흐름을 나타냅니다:

클라이언트 → 컨트롤러 → 서비스 → 레포지토리 → 데이터베이스

각 부분은 Span 입니다. 트레이스에는 다음이 포함됩니다:

• Trace ID
• Span ID
• 부모‑자식 관계
• 속성(attribute)
• 이벤트(event)
• 지속 시간(duration)

🏗 3. 구현된 아키텍처

Spring Boot
   ↓
OpenTelemetry Java Agent
   ↓
OTLP
   ↓
OpenTelemetry Collector
   ↓
Jaeger
   ↓
Jaeger UI

🐳 4. 인프라스트럭처

Docker Compose를 사용해 다음을 띄웁니다:

• Jaeger All‑in‑One
• OpenTelemetry Collector

Jaeger UI는 다음에서 확인할 수 있습니다:

⚙️ 5. Collector 설정

Collector는:

• OTLP 수신
• 데이터 처리(resource + batch)
• Jaeger로 내보내기

resource 프로세서는 다음을 추가합니다:

• service.name
• deployment.environment

☕ 6. 애플리케이션

애플리케이션에는 다음이 포함됩니다:

• REST 컨트롤러
• 서비스
• JPA 레포지토리
• 인메모리 H2 데이터베이스

엔드포인트:

• POST /user
• GET /user

🎯 7. 자동 계측

환경 변수:

export OTEL_PROTOCOL="grpc"
export OTEL_EXPORTER_OTLP_ENDPOINT="http://127.0.0.1:4318"
export OTEL_METRICS_EXPORTER=none

실행 방법:

java -javaagent:opentelemetry-javaagent.jar -jar demo-0.0.1-SNAPSHOT.jar

👀 8. 내부 흐름

1. HTTP 요청이 가로채집니다.
2. 루트 스팬이 생성됩니다.
3. 컨트롤러, 서비스, JDBC가 계측됩니다.
4. OTLP를 통해 내보내집니다.
5. Collector가 처리합니다.
6. Jaeger가 시각화합니다.

🚀 9. 혜택

• 병목 현상 감지
• 정확한 지연 시간 파악
• 실제 실행 흐름 이해
• 표준 관측성 확보
• 벤더 종속성(vendor lock‑in) 방지

이 모든 것이 간단한 애플리케이션에서도 가능합니다. 20개의 마이크로서비스가 없어도 관측성이 필요합니다.

🏁 결론

관측성은 복잡한 아키텍처에만 필요한 것이 아닙니다. 전통적인 애플리케이션이라도 내부에서 무슨 일이 일어나고 있는지 이해하면 큰 이점을 얻을 수 있습니다. OpenTelemetry와 Jaeger를 사용하면 “무슨 일이 일어나고 있는지 모른다”는 상태에서 몇 분 안에 애플리케이션 전체를 완전히 가시화할 수 있습니다.

한 번 내부 흐름을 이해하면 다시는 돌아가고 싶지 않을 겁니다.

지금 바로 시험해 보고 싶다면:

👉