OpenTelemetry란 무엇인가요?
OpenTelemetry(OTel)는 분산 시스템(예: 마이크로서비스 아키텍처)에서 텔레메트리 데이터를 수집, 처리 및 내보내기 위한 벤더 중립적 표준을 제공하는 오픈 소스 프로젝트입니다. 이처럼 간소화된 범용 옵저버빌리티 접근 방식을 통해 개발자는 소프트웨어의 성능과 동작을 더 쉽게 분석하고, 애플리케이션의 문제를 더욱 손쉽게 진단하고 디버깅할 수 있습니다. OTel은 다음 데이터를 수집합니다:
- 트레이스 – “문제가 어디에 있나요?”
- 메트릭 – “문제가 있나요?”
- 로그 – “문제가 무엇인가?”
OTel은 프로그래밍 언어나 제품이 아닙니다. 이 오픈 소스 프로젝트는 2019년에 시작되었으며, 현재 Cloud Native Computing Foundation(CNCF)에서 유지 관리하고 있습니다.
이 동영상을 보고 시작하는 방법을 알아보세요:
OTel이 생성하는 데이터 유형
트레이스
트레이스는 단일 요청 처리와 같은 작업 중에 발생하는 이벤트를 기록합니다. 트레이스는 일련의 스팬으로 나뉘며, 각 스팬은 작업의 한 단위를 나타냅니다.
예를 들어, 웹 요청에 대한 트레이스에는 세 개의 스팬이 포함될 수 있습니다:
- 요청 수락
- 데이터베이스 쿼리
- 응답 전송
트레이스는 여러 서비스에 걸친 데이터 흐름을 시간순으로 정렬된 일련의 구간으로 나누어 다음 사항을 쉽게 이해할 수 있도록 도와줍니다:
- 각 구간에서 수행된 모든 단계
- 청크가 실행된 순서
- 각 단계에 걸린 시간
- 각 단계에 대한 메타데이터
OTel이 트레이스를 생성하면 다음 단계는 분석을 위해 트레이싱 백엔드나 도구로 내보내는 것입니다. OTel은 Jaeger, Zipkin, AWS X‑Ray와 같은 널리 사용되는 백엔드를 위한 익스포터를 제공합니다. 이러한 서비스는 트레이스 데이터를 분석하고 시각화하는 도구를 제공합니다.
메트릭
OTel에서 메트릭은 운영 체제 동작의 특정 측면을 측정한 값으로, 시간에 따라 키-값 쌍(메트릭 레이블이라고 함)으로 수집됩니다. 이러한 키-값 쌍은 시간에 따른 측정값에 대한 맥락을 제공합니다. 예를 들어, 웹 서비스의 응답 시간 메트릭에는 HTTP 상태 코드, 엔드포인트, HTTP 메서드에 대한 레이블이 포함될 수 있습니다. 또한 모든 메트릭에는 시간순으로 정렬할 수 있도록 타임스탬프가 부여됩니다.
로그
로그는 특정 서비스에서 어떤 일이 일어나고 있는지 파악하는 가장 오래되고 일반적인 방법입니다. 로그는 일반적으로 텍스트 형태로 생성되며, 유용한 정보를 얻으려면 파싱해야 합니다. OTel의 로그 지원은 아직 실험 단계입니다.
솔루션 아키텍트들이 OTel과 다른 관측 가능성 도구의 기능을 비교하면서 발견한 내용을 자세히 알아보려면 블로그의 최신 앱 참조 아키텍처에 OpenTelemetry 통합하기 – 진행 상황 보고서 글을 참고하세요.
OTel 계측
OTel은 널리 사용되는 다양한 프로그래밍 언어, 라이브러리 및 프레임워크와 통합됩니다. 언어에 따라 지원 범위에는 차이가 있습니다. 예를 들어, JavaScript 계측 라이브러리는 트레이싱과 메트릭 모두에 대해 자체적으로 “안정적”이라고 명시한 구현을 제공하며, 로그 지원도 가장 안정적인 수준에 속합니다. 또한 서비스 로직에 계측 전용 코드를 추가하지 않고도 트레이스를 수신할 수 있는 자동 계측 옵션을 제공합니다. 반면, Go와 같은 언어는 메트릭과 로그 지원의 성숙도가 상대적으로 낮고 자동 계측 기능이 없습니다.
텔레메트리 목표
텔레메트리 계측을 설정할 때는 “모든 데이터를 전송하고 유용한 인사이트를 얻기를 기대하는 것”보다 더 명확한 계측 목표를 세우는 것이 좋습니다. 실제로 데이터를 확인하기 전까지는 무엇이 가능한지 완전히 파악할 수 없지만, 최소한의 요구 사항을 정해 두면 서비스를 원활하게 운영하고 유지 관리하는 데 도움이 됩니다.
여기에는 다음과 같은 기술적 고려 사항이 포함될 수 있습니다:
- 서비스에 부하가 걸려 확장이 필요한 시점을 알고 싶습니다.
- 내 서비스가 자주 재시작되는지 알고 싶습니다.
하지만 다음과 같이 제품 및 사용자 경험과 관련된 문제일 수도 있습니다:
- 사용자가 시스템에서 새 메시지를 5초 이내에 볼 수 있기를 원합니다.
- 메시지가 전송된 후 1분 이내에 알림이 발송되기를 원합니다.
예를 들어, 튜토리얼 OpenTelemetry 트레이싱으로 마이크로서비스 이해하기에서는 다음을 핵심 목표로 정의할 수 있습니다:
- 새로운 메시지 흐름을 완료하기 위해 요청이 거치는 모든 단계를 이해합니다.
- 사용자 흐름이 성공적으로 완료되었는지 확인합니다.
- 사용자 흐름이 처음부터 끝까지 5초 이내에 실행된다는 확신을 가질 수 있어야 합니다(“정상적인” 상황에서).
- 알림 서비스가 (메신저 서비스에서 전송한) 이벤트를 적시에 처리하고 있는지 파악합니다.
OTel 구현
OTel은 개발자가 일관되고 표준화된 방식으로 애플리케이션을 계측할 수 있도록 통합된 애플리케이션 프로그래밍 인터페이스(API), 소프트웨어 개발 키트(SDK), 계측 라이브러리 세트를 제공합니다.
OTel이 생성하는 데이터 형식은 업계 표준으로 인정받고 있어 다양한 텔레메트리 집계 및 시각화 솔루션에서 지원됩니다. 이 튜토리얼에서 사용한 Jaeger와 같은 온프레미스 솔루션을 선택하거나, SumoLogic 또는 SigNoz와 같은 서비스형 소프트웨어(SaaS) 솔루션을 선택할 수 있습니다.
세 가지 유형의 텔레메트리를 모두 관리하려면 OTel 외에는 여러 도구를 조합해서 사용하는 방법밖에 없습니다. 이는 마이크로서비스 아키텍처와 인프라 운영에 내재된 복잡성에 더해 복잡성을 한층 더 높입니다.
OTel에서 API란 무엇인가요?
API는 소프트웨어 구성 요소가 서로 상호 작용하는 데 사용하는 메서드, 함수 및 프로토콜을 정의합니다. OTel API는 개발자가 애플리케이션을 계측하고 텔레메트리 데이터를 수집하는 데 사용할 수 있는 표준 메서드 및 프로토콜 집합을 정의합니다.
OTel에서 SDK란 무엇인가요?
SDK는 표준이나 애플리케이션의 개발 주체가 제공하는 소프트웨어 개발 도구로, 개발자가 해당 표준을 준수하거나 해당 앱과 상호 작용하는 애플리케이션을 더 쉽게 만들 수 있도록 지원합니다. SDK에는 일반적으로 라이브러리, 코드 샘플, 문서와 함께 테스트, 디버깅, 성능 튜닝을 위한 도구가 포함됩니다. OTel은 트레이싱, 메트릭, 리소스 관리를 위한 SDK를 제공합니다.
