컴포넌트
오픈텔레메트리(OpenTelemetry)는 현재 다음과 같은 주요 컴포넌트로 구성된다.
오픈텔레메트리는 텔레메트리 데이터 생성 및 전송에 필요한 특정 벤더 전용 SDK와 도구를 대체할 수 있다.
명세
명세는 모든 구현체가 따라야 하는 언어 간 공통 요구 사항과 기대 사항을 설명한다. 용어 정의뿐 아니라 다음 사항도 정의한다.
- API: 트레이싱, 메트릭, 로깅 데이터를 생성하고 서로 연관 짓기 위한 데이터 타입과 연산을 정의한다.
- SDK: 언어별 API 구현체의 요구 사항을 정의한다. 설정, 데이터 처리 및 내보내기에 관한 개념도 정의한다.
- 데이터: 오픈텔레메트리 프로토콜(OTLP)과 텔레메트리 백엔드가 지원할 수 있는 벤더 중립적인 시맨틱 컨벤션(semantic conventions)을 정의한다.
자세한 내용은 명세를 참고한다.
컬렉터
오픈텔레메트리 컬렉터는 텔레메트리 데이터를 수신하고, 처리하고, 내보낼 수 있는 벤더 중립적인 프록시다. 다양한 형식(예: OTLP, Jaeger, Prometheus 및 여러 상용·독점 도구)의 텔레메트리 데이터를 수신하고, 하나 이상의 백엔드로 전송하는 기능을 지원한다. 데이터를 내보내기 전에 처리하고 필터링하는 기능도 지원한다.
자세한 내용은 컬렉터를 참고한다.
언어별 API 및 SDK 구현체
오픈텔레메트리는 선택한 언어에서 오픈텔레메트리 API를 사용하여 텔레메트리 데이터를 생성하고, 원하는 백엔드로 내보낼 수 있는 언어별 SDK도 제공한다. 이러한 SDK를 통해 널리 사용되는 라이브러리와 프레임워크의 계측 라이브러리를 추가하고, 애플리케이션의 수동 계측과 연계할 수 있다.
자세한 내용은 계측을 참고한다.
계측 라이브러리
오픈텔레메트리는 지원하는 언어에서 널리 사용되는 라이브러리와 프레임워크로부터 관련 텔레메트리 데이터를 생성하는 다양한 컴포넌트를 지원한다. 예를 들어, HTTP 라이브러리의 수신 및 발신 HTTP 요청에 대한 데이터를 생성한다.
오픈텔레메트리가 지향하는 목표는 널리 사용되는 모든 라이브러리가 기본적으로 관측 가능하여 별도의 의존성이 필요하지 않은 상태를 지향한다.
자세한 내용은 라이브러리 계측을 참고한다.
익스포터
Send telemetry to the OpenTelemetry Collector to make sure it’s exported correctly. Using the Collector in production environments is a best practice. To visualize your telemetry, export it to a backend such as Jaeger, Zipkin, Prometheus, or a vendor-specific backend.
The registry contains the list of language specific exporters.
Among exporters, OpenTelemetry Protocol (OTLP) exporters are designed with the OpenTelemetry data model in mind, emitting OTel data without any loss of information. Furthermore, many tools that operate on telemetry data support OTLP (such as Prometheus, Jaeger, and most vendors), providing you with a high degree of flexibility when you need it. To learn more about OTLP, see OTLP Specification.
제로 코드 계측
적용 가능한 환경인 경우, 오픈텔레메트리의 언어별 구현체는 소스 코드를 수정하지 않고 애플리케이션을 계측하는 방법을 제공한다. 기반 메커니즘은 언어마다 다르지만, 제로 코드 계측은 애플리케이션에 오픈텔레메트리 API와 SDK 기능을 추가한다. 또한 계측 라이브러리와 익스포터 의존성을 추가할 수도 있다.
자세한 내용은 제로 코드 계측을 참고한다.
리소스 감지기
리소스는 텔레메트리를 생성하는 엔티티를 리소스 속성으로 나타낸다. 예를 들어, 쿠버네티스의 컨테이너에서 실행되며 텔레메트리를 생성하는 프로세스에는 파드 이름과 네임스페이스가 있고, 디플로이먼트 이름도 있을 수 있다. 이러한 속성을 모두 리소스에 포함할 수 있다.
오픈텔레메트리의 언어별 구현체는 OTEL_RESOURCE_ATTRIBUTES 환경 변수를 통한
리소스 감지와 프로세스 런타임, 서비스, 호스트, 운영 체제 등 여러 일반적인
엔티티에 대한 리소스 감지 기능을 제공한다.
자세한 내용은 리소스를 참고한다.
서비스 간 전파자
전파는 서비스와 프로세스 간의 데이터를 전달하는 메커니즘이다. 전파는 트레이싱에만 국한되지 않지만, 프로세스와 네트워크 경계를 넘어 임의로 분산된 서비스 전반에서 트레이스가 시스템의 인과 관계 정보를 구성할 수 있도록 한다.
대부분의 사용 사례에서 컨텍스트 전파는 계측 라이브러리를 통해 이루어진다. 필요한 경우 전파자를 직접 사용하여 스팬의 컨텍스트와 배기지처럼 여러 서비스에 걸쳐 공유되는 횡단 관심사를 직렬화하고 역직렬화할 수 있다.
샘플러
샘플링은 시스템에서 생성되는 트레이스의 양을 제한하는 과정이다. 오픈텔레메트리의 각 언어별 구현체는 여러 헤드 샘플러를 제공한다.
자세한 내용은 샘플링을 참고한다.
쿠버네티스 오퍼레이터
오픈텔레메트리 오퍼레이터는 쿠버네티스 오퍼레이터의 구현체다. 이 오퍼레이터는 오픈텔레메트리 컬렉터와 오픈텔레메트리를 사용한 워크로드의 자동 계측을 관리한다.
자세한 내용은 쿠버네티스 오퍼레이터를 참고한다.
서비스형 함수 지원 구성 요소
오픈텔레메트리는 여러 클라우드 벤더가 제공하는 서비스형 함수(Function as a Service)를 모니터링하는 다양한 방법을 지원한다. 오픈텔레메트리 커뮤니티는 현재 애플리케이션을 자동으로 계측할 수 있는 사전 빌드된 Lambda 계층뿐 아니라, 애플리케이션을 수동 또는 자동으로 계측할 때 사용할 수 있는 독립형 컬렉터 Lambda 계층도 제공한다.
자세한 내용은 서비스형 함수를 참고한다.
피드백
이 페이지가 도움이 되었나요?
Thank you. Your feedback is appreciated!
Please let us know how we can improve this page. Your feedback is appreciated!