openzipkin/zipkin

어떤 프로젝트인가요?

핵심 기능

• 01서비스, 작업, 태그, 소요 시간으로 트레이스를 검색하거나 trace ID로 바로 조회할 수 있습니다.
• 02오류 경로를 포함해 애플리케이션 간 요청 흐름을 보여 주는 종속성 그래프입니다.
• 03span 전송에 HTTP, Kafka, RabbitMQ, gRPC, ActiveMQ, Apache Pulsar를 지원합니다.
• 04메모리, Cassandra, Elasticsearch, OpenSearch를 선택할 수 있는 플러그형 스토리지입니다.
• 05Zipkin v1 및 v2 JSON 코덱을 포함하는 핵심 Java 라이브러리입니다.

활용 사례

• 마이크로서비스 호출 체인에서 지연 시간이 길어지는 원인이 되는 서비스를 진단합니다.
• 로그의 trace ID를 사용해 실패한 요청을 찾고 여러 서비스에 걸쳐 추적합니다.
• 개발 및 테스트 환경에서 데이터베이스 없이 로컬 Zipkin 서버를 실행합니다.
• 서비스 종속성을 시각화해 더 이상 사용하지 않는 서비스로 향하는 호출을 찾습니다.

빠른 시작

1. 1

   Docker로 Zipkin을 시작합니다

   docker run -d -p 9411:9411 openzipkin/zipkin
2. 2

   브라우저에서 http://localhost:9411/zipkin 에 접속해 Zipkin UI를 엽니다

사용 전 알아둘 점

• !기본 인메모리 스토리지는 영구 저장되지 않으므로 실제 워크로드에 적합하지 않습니다.
• !트레이스 데이터를 전송하기 전에 애플리케이션에 트레이서 또는 계측 라이브러리를 적용해야 합니다.
• !Zipkin 서버에는 JRE 17 이상이 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

zipkin은(는) 무엇인가요?

Zipkin은 서비스 아키텍처 전반의 지연 시간을 파악하고 문제를 해결할 수 있도록 타이밍 데이터를 수집하고 조회하는 분산 추적 시스템입니다. Zipkin은 계측된 애플리케이션에서 타이밍 데이터를 수집하며, trace ID로 트레이스를 조회하거나 서비스 이름, 작업, 태그, 소요 시간으로 검색할 수 있습니다. UI에서는 각 트레이스에서 시간이 어디에 쓰였는지, 작업이 실패했는지 요약해 보여 주고, 애플리케이션 간에 추적된 요청이 얼마나 오갔는지 종속성 다이어그램으로 표시합니다.

zipkin은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

zipkin은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

zipkin은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. zipkin의 마지막 커밋은 2026년 8월 6일입니다.

zipkin은(는) 어디에 사용할 수 있나요?

마이크로서비스 호출 체인에서 지연 시간이 길어지는 원인이 되는 서비스를 진단합니다. 로그의 trace ID를 사용해 실패한 요청을 찾고 여러 서비스에 걸쳐 추적합니다. 개발 및 테스트 환경에서 데이터베이스 없이 로컬 Zipkin 서버를 실행합니다. 서비스 종속성을 시각화해 더 이상 사용하지 않는 서비스로 향하는 호출을 찾습니다.

zipkin는 어떻게 설치하나요?

Docker로 Zipkin을 시작합니다: docker run -d -p 9411:9411 openzipkin/zipkin 브라우저에서 http://localhost:9411/zipkin 에 접속해 Zipkin UI를 엽니다

zipkin은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/openzipkin/zipkin