OpenTelemetry란? 텔레메트리 수집과 전송 방식
OpenTelemetry API, SDK, Collector, OTLP가 트레이스, 메트릭, 로그를 처리하는 방식과 구성 요소별 성숙도, Guance 연동 방법을 설명합니다.
응답 시간이 길어졌다는 사실은 메트릭으로 알 수 있습니다. 요청이 어느 구간에서 오래 걸렸는지는 트레이스로 좁혀 보고, 그 구간에서 무슨 일이 있었는지는 로그를 확인합니다. 서비스마다 다른 언어와 프레임워크를 쓴다면 이 데이터를 같은 분석 환경으로 보내는 일부터 정리해야 합니다.
OpenTelemetry(OTel)는 텔레메트리를 생성하고 수집해 내보내는 CNCF 오픈소스 프레임워크입니다. OpenTracing과 OpenCensus가 통합되면서 시작됐습니다. API, SDK, Collector와 OTLP를 사용하면 기존 계측을 활용해 호환되는 백엔드로 데이터를 보낼 수 있습니다.
OpenTelemetry 핵심 정리
- OTel은 텔레메트리의 생성, 수집, 전송을 맡습니다. 장기 저장과 조회, 분석은 백엔드가 담당합니다.
- 주요 구성 요소는 명세와 시맨틱 규약, 언어별 API와 SDK, Collector, OTLP입니다.
- 트레이스, 메트릭, 로그에 대한 OTLP 전송 명세는 안정화됐습니다. SDK, 자동 계측 라이브러리, Collector 구성 요소의 성숙도는 별도로 확인해야 합니다.
- 서비스 하나의 신호부터 보내면 범위를 늘리기 전에 전송 경로를 확인하기 쉽습니다.
텔레메트리란?
텔레메트리는 시스템이 작동하면서 내보내는 데이터입니다. 로그는 개별 이벤트를 기록하고, 메트릭은 측정값의 변화를 보여 주며, 트레이스는 요청을 처리하는 과정을 따라갑니다. 각 신호가 어떤 질문에 답하는지는 로그, 메트릭, 트레이스의 차이와 연결 방법에서 볼 수 있습니다. 프로파일을 보면 CPU 시간 같은 리소스가 어느 코드 경로에 쓰였는지 알 수 있습니다. 수집 형식이나 전송 방식이 특정 백엔드에 묶여 있으면 플랫폼을 옮길 때 계측이나 수집 설정까지 바꿔야 할 수 있습니다.
OpenTelemetry가 해결하는 문제
- 백엔드 종속을 줄입니다. 새 백엔드가 같은 신호를 받을 수 있다면 기존 계측을 계속 쓸 수 있습니다. 전환 전에는 내보내기 설정, 지원 신호, 필드 매핑을 확인합니다. 대시보드와 알림 규칙은 백엔드 쪽 설정입니다.
- 언어가 다른 서비스의 데이터를 맞춥니다. Java, Go, Python, Node.js 서비스에 공통 데이터 모델을 적용할 수 있습니다. 실제 필드는 계측 방식과 적용한 시맨틱 규약 버전에 따라 달라집니다.
- 같은 계측을 여러 번 구현하는 일을 줄입니다. 지원하는 프레임워크와 라이브러리의 일반적인 작업은 자동 계측으로 수집할 수 있습니다. 범위에 포함되지 않는 비즈니스 작업에는 API로 스팬을 추가합니다.
- 서비스를 넘나드는 요청을 추적합니다. 서비스 간에 컨텍스트를 전파하면 관련 스팬을 하나의 트레이스로 연결할 수 있습니다. 조회할 수 있는 범위는 샘플링, 내보내기, 보존 정책에도 좌우됩니다.
OpenTelemetry의 주요 구성 요소
명세와 시맨틱 규약
명세는 데이터 모델과 API 동작을 정합니다. 시맨틱 규약(영어)은 HTTP 스팬의 http.request.method, 서비스 리소스의 service.name처럼 공통으로 쓰는 속성의 이름과 의미를 정합니다. 여러 서비스에서 같은 쿼리를 쓰기 전에 실제로 어떤 필드가 나오는지 확인합니다.
API와 SDK
라이브러리는 API를 사용해 스팬을 만들거나 측정값을 기록합니다. 애플리케이션에서는 그 데이터를 처리하고 내보낼 SDK(영어)를 설정합니다. SDK는 트레이스 샘플링, 메트릭 집계, 리소스 정보 연결도 담당합니다. 애플리케이션 로그를 보내려면 사용하는 로깅 프레임워크에 맞는 브리지 등을 따로 설정합니다.
Collector
OpenTelemetry Collector(영어)는 특정 벤더에 종속되지 않는 전송 파이프라인입니다. receiver가 데이터를 받고, 필요한 경우 processor가 필터링하거나 속성을 바꾸며, exporter가 설정된 목적지로 보냅니다. 형식 변환, 큐, 재시도는 구성 요소와 설정에 따라 달라집니다. 장애가 길어져 큐가 차거나 재시도 시간이 끝나면 일부 데이터가 유실될 수 있습니다.
OTLP
OTLP는 텔레메트리를 인코딩하고 전송하는 방법을 정합니다. gRPC는 Protobuf를 사용하며, HTTP에서도 바이너리 Protobuf를 쓸 수 있습니다. JSON 인코딩은 송신 측과 수신 측이 모두 지원해야 합니다. 표준 기본 포트는 gRPC 4317, HTTP 4318입니다. HTTP의 기본 경로는 /v1/traces처럼 신호별로 나뉩니다. 설정에는 실제 수신 서비스의 포트와 경로를 사용합니다. 프로토콜의 세부 사항은 OTLP 가이드(중국어 간체)에 정리돼 있습니다.
어디까지 안정화됐을까?
OTLP 명세(영어)에서 트레이스, 메트릭, 로그 전송은 Stable이고 Profiles는 Development입니다. 이 상태는 프로토콜을 기준으로 합니다. 언어 SDK나 자동 계측 라이브러리, Collector의 receiver와 exporter는 다른 단계일 수 있습니다. 언어별 API와 SDK 상태표(영어)와 배포할 Collector 구성 요소의 문서를 각각 확인합니다.
도입할 때 자주 막히는 지점
- 구성 요소가 많습니다. 첫 스팬을 보기 전에 Collector 설정부터 깊이 들어가면 어느 구간이 막혔는지 찾기 어렵습니다. 지원되는 자동 계측으로 서비스 하나의 트레이스를 먼저 확인합니다.
- 지원 수준이 고르지 않습니다. 예제에서 잘 동작하는 신호라도 내 서비스의 런타임이나 라이브러리에서는 지원 범위가 다를 수 있습니다. 배포할 버전을 기준으로 확인합니다.
- 분석 백엔드는 별도로 선택합니다. 수집과 전송 인터페이스는 공통으로 쓸 수 있습니다. 저장, 검색, 알림은 Guance 같은 백엔드가 맡습니다.
분석 백엔드로 텔레메트리 보내기
Guance에서 분석하려면 애플리케이션이나 Collector가 DataKit의 OpenTelemetry 입력(영어)으로 OTLP 데이터를 보내도록 설정합니다. 입력과 필요한 신호의 exporter를 활성화한 뒤 송신 측에서 실제 수신 주소에 연결할 수 있는지 확인합니다. gRPC 설정 예시의 127.0.0.1:4317은 같은 네트워크 네임스페이스에서만 접근할 수 있습니다.
HTTP에서는 http/protobuf를 사용합니다. DataKit 기본 HTTP 포트는 9529이며, 기본 경로는 /otel/v1/traces, /otel/v1/metrics, /otel/v1/logs입니다. 신호별 엔드포인트에는 전체 URL을 지정합니다. 명세를 따르는 HTTP exporter에서 공통 OTEL_EXPORTER_OTLP_ENDPOINT를 사용한다면, 기본 경로에 맞춰 베이스 URL을 /otel로 끝냅니다. exporter가 뒤에 신호별 경로를 붙입니다.
식별할 수 있는 요청을 하나 골라 서비스 이름과 스팬의 부모·자식 관계를 확인합니다. 메트릭은 미리 아는 만큼 변화를 주고 값과 단위, 누적 또는 델타 집계 기준을 확인합니다. 로그는 이벤트 시각과 심각도, 연결에 사용하는 식별자를 봅니다. 의도한 데이터가 조회되면 대시보드나 탐지 규칙에 사용합니다.
자주 묻는 질문
OpenTelemetry와 Prometheus는 어떻게 함께 쓰나요? Prometheus는 주로 메트릭을 스크레이프하고 저장하며, PromQL 쿼리와 알림 규칙을 평가하는 데 쓰입니다. OTel은 여러 신호를 생성하고 전송하는 데 쓰입니다. Collector의 Prometheus receiver 또는 exporter로 메트릭을 연결할 수 있습니다. 이때 메트릭 변환과 레이블도 확인해야 합니다. OpenTelemetry와 Prometheus 비교(중국어 간체)에서 더 자세히 다룹니다.
OTel을 써도 모니터링 플랫폼이 필요한가요? 장기 보존, 조회, 시각화, 알림, 권한 관리가 필요하다면 이를 담당할 백엔드가 있어야 합니다. Guance는 DataKit을 통해 지원되는 OTLP 신호를 받을 수 있습니다.
오래된 애플리케이션에도 쓸 수 있나요? 런타임과 라이브러리가 지원된다면 가능합니다. 예를 들어 Java Agent는 애플리케이션 소스 코드를 수정하지 않고 지원 라이브러리를 계측할 수 있습니다. 시작 옵션과 내보내기 대상을 설정하고 배포 방식에 따라 애플리케이션을 다시 시작합니다. 자동 계측에 잡히지 않는 작업은 수동으로 스팬을 추가할 수 있습니다.
OpenTelemetry 로그로 ELK를 대체할 수 있나요? OTel은 로그 수집과 전송의 일부를 맡을 수 있습니다. 인덱싱과 검색, 분석에는 백엔드가 필요합니다. DataKit으로 OTLP 로그를 받은 후 로그에 일치하는 Trace ID 등이 있고 해당 트레이스를 조회할 수 있으면 서로 연결할 수 있습니다.
관련 글
- 이전 글 eBPF 옵저버빌리티
- 다음 글 OpenTelemetry Collector(영어)
- 함께 읽기 OTLP(중국어 간체) · OpenTelemetry SDK(영어) · 기술 가이드 목록
참고 자료 OpenTelemetry 공식 문서(영어) · OTLP 명세(영어) · Guance OpenTelemetry 연동(영어) · Guance APM(영어) · DataKit 문서(영어)
