Spring Cloud Sleuth(1)

아래의 내용은 Spring Cloud Sleuth 2.2.8 RELEASE 버전을 한국말로 번역한 내용입니다. https://docs.spring.io/spring-cloud-sleuth/docs/2.2.8.RELEASE/reference/html/

소개

Spring Cloud Sleuth 는 Spring Cloud 를 위한 분산 추적을 구현한 솔루션입니다.

용어

Spring Cloud Sleuth 는 구글에서 개발한 Dapper 의 용어를 빌려 사용합니다.
Span
- 일의 가장 기본적인 단위입니다.
- 예를 들어 RPC에 응답을 보내는 것처럼 RPC 를 보내는 것은 새로운 Span 입니다.
- 스팬은 고유한 64비트 ID 로 식별됩니다.
- 또한 Trace(스팬의 총 묶음)라는 고유한 64비트 아이디가 있습니다.
- 스팬은 설명, 타입 스탬프 이벤트, 키-값 주소, 그리고 스팬 ID, Process ID(주로, IP 주소) 등이 있습니다.
- 스팬은 시작하고 멈출 수 있으며 타이밍 정소를 추적할 수 있습니다. 일단, 스팬을 만들었다면 어느시점에 무조건 멈춰야 합니다.
- Trace 를 시작한 초기 스팬을 root span 이라고 합니다. root span 의 ID 는 trace 의 ID 와 일치합니다.

Trace
- Tree와 같은 구조로 형성된 Span의 세트입니다.
Annotation
- 이벤트를 기록하기 위해 사용됩니다.
- Brave Instrumentation 을 사용하면 우리는 더이상 Zipkin 이 클라이언트와 서버가 누구인지, 요청이 어디서 시작되었는지, 어디서 종료되었는지 이해할 수 있도록 특별한 이벤트를 설정할 필요가 없습니다.
- 그러나 학습목적으로 이러한 이벤트를 표시하여 어떤 종류의 동작이 발생했는지 강조합니다.
  - cs
    - Client Sent
    - Client 가 해당 리퀘스트를 만들었다는 의미입니다.
    - 이 주석은 Span의 시작을 의미합니다.
  - sr
    - Server Received
    - 서버가 request를 받고 처리하기 시작하는 것을 의미합니다.
    - sr-cs = network latency 입니다.
  - ss
    - Server sent
    - 요청에 대한 처리(Client의 요청에 대한 응답을 보내줌)가 완료되었다는 주석입니다.
  - cr
    - Client Received
    - Span 의 끝을 나타냅니다.
    - Client가 서버로 부터 응답을 잘 받았다는것을 나타냅니다.
    - cr-cs = Client 가 Server 로 부터 응답을 받을 수 있는 총 필요한 시간 을 나타냅니다.
  - 아래 이미지는 Span 과 Trace 가 System 에서 어떻게 보이는지에 대한 예시를 나타냅니다. (Zipkin 주석을 포함시킨 형태입니다.)
  - 아래 색깔은 스팬을 나타냅니다. (즉 A-G 까지 보면 스팬이 총 7개라는 것을 알 수 있습니다.)
```
Trace Id = X
Span Id = D
Client Sent
```
    - 위의 예시에서 Trace Id 는 X 이고 Span Id 는 D 이며 cs 이벤트가 발생한 것을 볼 수 있습니다.
    parent-child 형태 관계도로 나타내면 Span 은 위처럼 표시됩니다.