요청 시작
URL·payload·retry 여부와 전체 대기 시간을 기록한다.
느린 요청은 경계별 시간 조각으로 추적한다
같은 correlation id로 ingress부터 dependency와 응답까지 이어야 전체 지연을 실제 병목 구간으로 분해할 수 있다.
진입 경계
access log에서 요청 크기와 도착 시각을 확인한다.
검증 경계
guard·pipe·interceptor 시간을 같은 trace에 남긴다.
업무 실행
controller·service와 event-loop·CPU 구간을 잰다.
외부 대기
DB pool·query와 외부 API 왕복을 span으로 나눈다.
요청 종료
status·exception과 반환 시각으로 전체 시간을 닫는다.
전체 요청 시간 = 각 경계에서 소비한 시간의 합띠가 긴 구간부터 원인을 좁힌다
Ingress진입·전달
Nest boundary검증·변환
Handler업무·runtime
Dependencypool·query·외부 API
Return직렬화·응답
| 긴 구간 | 함께 볼 신호 | 다음 조치 |
|---|---|---|
| Ingress | 요청 크기·access log | payload 제한과 프록시 설정 확인 |
| Handler / Runtime | event-loop delay·CPU flame | 동기 코드와 큰 JSON·crypto 경로 제거 |
| Dependency | pool wait·query span·외부 API | index·batching·timeout 기준 조정 |