Rust

공식 opentelemetry 크레이트를 사용해 별도의 Sophonz 패키지 없이 모든 Rust 서버에서 트레이스와 로그를 Sophonz로 전송하세요.

제공되는 것

• 공식 Rust SDK — opentelemetry + opentelemetry_sdk + opentelemetry-otlp. 프로그래밍 방식으로 재정의하지 않는 한 표준 OTEL_EXPORTER_OTLP_* 환경 변수를 읽는 OTLP/HTTP 익스포터를 만들어 줍니다.
• tracing 브릿지 — 애플리케이션이 이미 구조화 로깅에 tracing 크레이트를 쓰고 있다면(대부분의 Rust 웹 서비스가 그렇습니다), tracing-opentelemetry와 opentelemetry-appender-tracing이 기존 tracing::info!/#[instrument] 호출을 다시 작성할 필요 없이 OTel 스팬과 로그 레코드로 바꿔 줍니다.
• 시작 시점에 한 번만 작성하면 되는 작고 명시적인 설정 함수 — Go와 마찬가지로 Rust에는 바이트코드를 재작성하는 에이전트가 없으므로, 플래그 하나가 아니라 몇 줄의 코드로 연결합니다.

동작 방식

Rust에는 코드 변경 없는(zero-code) 자동 계측 에이전트가 없습니다 — 패치할 런타임 바이트코드가 없고 컴파일러가 정적 바이너리를 만들기 때문입니다. 대신 시작 시점에 짧은 설정 함수를 한 번 호출합니다.

1. 서비스를 설명하는 Resource를 만듭니다 (service.name 등).
2. SpanExporter::builder().with_http().build() / LogExporter::builder().with_http().build()로 OTLP/HTTP 스팬 익스포터와 로그 익스포터를 만듭니다 — 둘 다 OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_PROTOCOL, OTEL_EXPORTER_OTLP_HEADERS를 자동으로 읽습니다.
3. 결과로 만들어진 SdkTracerProvider / SdkLoggerProvider를 전역으로 등록하고, tracing을 쓴다면 tracing-opentelemetry의 레이어를 설치해 기존 스팬과 로그 라인이 같은 파이프라인으로 흐르게 합니다.

이후 요청 핸들러를 #[tracing::instrument]나 프레임워크의 트레이싱 미들웨어(tower-http, tracing-actix-web, axum-tracing-opentelemetry)로 계측하면 스팬이 자동으로 생성됩니다.