스프링 클라우드 슬루스 공식 레퍼런스를 한글로 번역한 문서입니다.

버전은 3.1.11 기준입니다.

---

Adrian Cole, Spencer Gibb, Marcin Grzejszczak, Dave Syer, Jay Bryant

---

!!!! 중요 !!!!

Spring Cloud Sleuth 3.1은 마지막 마이너 버전이다. 최신 커밋은 3.1.x 브랜치에서 확인할 수 있다.

Spring Cloud Sleuth는 Spring Boot 3.x부터 동작하지 않는다. Spring Cloud Sleuth가 지원하는 마지막 스프링 부트 메이저 버전은 2.x다.

이 프로젝트의 코어 로직은 Micrometer Tracing 프로젝트로 옮겨졌으며, 여러 가지 계측 기능들은 Micrometer와 각 하위 프로젝트들로 이전할 예정이다 (이제는 단일 레포지토리에서 모든 계측 기능들을 개발하지 않는다).

Spring Cloud Sleuth에서 Micrometer Tracing으로 마이그레이션하는 방법은 Micrometer Tracing 마이그레이션 가이드를 참고하면 된다.

---

목차:

1. Legal
2. Getting Started
   • 2.1. Introducing Spring Cloud Sleuth
     • 2.1.1. Terminology
   • 2.2. Developing Your First Spring Cloud sleuth-based Application
     • 2.2.1. Creating the POM
     • 2.2.2. Adding Classpath Dependencies
     • 2.2.3. Writing the Code
     • 2.2.4. Running the Example
   • 2.3. Next Steps
3. Using Spring Cloud Sleuth
   • 3.1. Span Lifecycle with Spring Cloud Sleuth’s API
     • 3.1.1. Creating and Ending Spans
     • 3.1.2. Continuing Spans
     • 3.1.3. Creating a Span with an explicit Parent
   • 3.2. Naming Spans
     • 3.2.1. @SpanName Annotation
     • 3.2.2. toString() Method
   • 3.3. Managing Spans with Annotations
     • 3.3.1. Creating New Spans
     • 3.3.2. Continuing Spans
     • 3.3.3. Advanced Tag Setting
   • 3.4. What to Read Next
4. Spring Cloud Sleuth Features
   • 4.1. Context Propagation
   • 4.2. Sampling
   • 4.3. Baggage
     • 4.3.1. Baggage versus Tags
   • 4.4. OpenZipkin Brave Tracer Integration
     • 4.4.1. Brave Basics
     • 4.4.2. Brave Sampling
     • 4.4.3. Brave Baggage Java configuration
     • 4.4.4. Brave Customizations
     • 4.4.5. Brave Messaging
     • 4.4.6. Brave Opentracing
   • 4.5. Sending Spans to Zipkin
     • 4.5.1. Custom service name
     • 4.5.2. Host Locator
     • 4.5.3. Customization of Reported Spans
     • 4.5.4. Overriding the auto-configuration of Zipkin
   • 4.6. Log integration
     • 4.6.1. JSON Logback with Logstash
   • 4.7. Self Documenting Spans
   • 4.8. Traces Actuator Endpoint
   • 4.9. What to Read Next
5. “How-to” Guides
   • 5.1. How to Set Up Sleuth with Brave?
   • 5.2. How to Set Up Sleuth with Brave & Zipkin via HTTP?
   • 5.3. How to Set Up Sleuth with Brave & Zipkin via Messaging?
   • 5.4. How to See Spans in an External System?
     • 5.4.1. Your Span Is Not Being Sampled
     • 5.4.2. Missing Dependency
     • 5.4.3. Connection Misconfiguration
   • 5.5. How to Make RestTemplate, WebClient, etc. Work?
   • 5.6. How to Add Headers to the HTTP Server Response?
   • 5.7. How to Customize HTTP Client Spans?
   • 5.8. How to Customize HTTP Server Spans?
   • 5.9. How to See the Application Name in Logs?
   • 5.10. How to Change The Context Propagation Mechanism?
   • 5.11. How to Implement My Own Tracer?
6. Spring Cloud Sleuth customization
   • 6.1. Apache Kafka
   • 6.2. Asynchronous Communication
     • 6.2.1. @Async Annotated methods
     • 6.2.2. @Scheduled Annotated Methods
     • 6.2.3. Executor, ExecutorService, and ScheduledExecutorService
   • 6.3. HTTP Client Integration
     • 6.3.1. Synchronous Rest Template
     • 6.3.2. Asynchronous Rest Template
   • 6.4. HTTP Server Integration
     • 6.4.1. HTTP Filter
     • 6.4.2. Async Servlet support
     • 6.4.3. WebFlux support
     • 6.4.4. Reactor Netty HttpServer
   • 6.5. Messaging
     • 6.5.1. Spring Integration
     • 6.5.2. Spring Cloud Function and Spring Cloud Stream
     • 6.5.3. Spring RabbitMq
     • 6.5.4. Spring Kafka
     • 6.5.5. Spring Kafka Streams
     • 6.5.6. Spring JMS
   • 6.6. OpenFeign
   • 6.7. OpenTracing
   • 6.8. Quartz
   • 6.9. Reactor
   • 6.10. Redis
     • 6.10.1. Redis With Legacy Brave Only Support
   • 6.11. Runnable and Callable
   • 6.12. RPC
     • 6.12.1. Dubbo RPC support
     • 6.12.2. gRPC
   • 6.13. RxJava
   • 6.14. Spring Cloud CircuitBreaker
   • 6.15. Spring Cloud Config Server
   • 6.16. Spring Cloud Deployer
   • 6.17. Spring RSocket
   • 6.18. Spring Batch
   • 6.19. Spring Cloud Task
   • 6.20. Spring Tx
   • 6.21. Spring Security
   • 6.22. R2DBC
   • 6.23. Spring Vault
   • 6.24. Spring Tomcat
   • 6.25. Spring Data Cassandra
   • 6.26. Spring JDBC
   • 6.27. MongoDB
   • 6.28. Spring Session
   • 6.29. Kotlin Coroutines
   • 6.30. Prometheus Exemplars
   • Common application properties
   • 6.31. Spring Cloud Sleuth Spans
     • 6.31.1. Annotation New Or Continue Span
     • 6.31.2. Async Annotation Span
     • 6.31.3. Async Callable Span
     • 6.31.4. Async Runnable Span
     • 6.31.5. Batch Job Span
     • 6.31.6. Batch Step Span
     • 6.31.7. Cassandra Span
     • 6.31.8. Circuit Breaker Function Span
     • 6.31.9. Circuit Breaker Supplier Span
     • 6.31.10. Config Span
     • 6.31.11. Deployer Deploy Span
     • 6.31.12. Deployer Get Log Span
     • 6.31.13. Deployer Scale Span
     • 6.31.14. Deployer Statuses Span
     • 6.31.15. Deployer Status Span
     • 6.31.16. Deployer Undeploy Span
     • 6.31.17. Jdbc Connection Span
     • 6.31.18. Jdbc Query Span
     • 6.31.19. Jdbc Result Set Span
     • 6.31.20. Kafka Consumer Span
     • 6.31.21. Kafka On Message Span
     • 6.31.22. Kafka Producer Span
     • 6.31.23. Messaging Span
     • 6.31.24. Mvc Handler Interceptor Span
     • 6.31.25. Quartz Trigger Span
     • 6.31.26. R2dbc Query Span
     • 6.31.27. Rsocket Requester Span
     • 6.31.28. Rsocket Responder Span
     • 6.31.29. Rx Java Trace Action Span
     • 6.31.30. Scheduled Annotation Span
     • 6.31.31. Security Context Change
     • 6.31.32. Session Create Span
     • 6.31.33. Session Delete Span
     • 6.31.34. Session Find Span
     • 6.31.35. Session Save Span
     • 6.31.36. Task Execution Listener Span
     • 6.31.37. Task Runner Span
     • 6.31.38. Tx Span
     • 6.31.39. Web Filter Span

---

Next :

Legal
스프링 클라우드 슬루스 문서 저작권 소개