SvelteKit OpenTelemetry 스팬 Vercel 네이티브 통합

Vercel이 SvelteKit의 새로운 서버측 OpenTelemetry 스팬을 네이티브로 통합했다. 두 가지 실험 플래그와 계측 파일 한 개만 설정하면 SvelteKit 스팬이 Vercel 인프라 스팬 트리에 병합되어 단일 뷰에서 전체 요청 경로를 추적할 수 있다.

핵심 포인트

svelte.config.js에서 experimental.tracing.server와 experimental.instrumentation.server를 true로 설정해야 한다.
src/instrumentation.server.ts 파일에 @vercel/otel의 registerOTel(serviceName)을 호출하면 초기화된다.
SvelteKit 스팬이 Vercel 인프라 스팬 트리에 병합, 시각화에서 초록색으로 구분 표시된다.
다른 OpenTelemetry 수집기로도 내보낼 수 있어 Vercel 외부 모니터링 도구와 연동 가능하다.

상세 정리

배경: 기존엔 SvelteKit 서버측 실행 경로를 Vercel 인프라 레벨 트레이스와 함께 볼 수 없었다.
설정 1 — svelte.config.js: experimental.tracing.server: true와 experimental.instrumentation.server: true 두 플래그를 추가한다.
설정 2 — 계측 파일: src/instrumentation.server.ts를 생성하고 @vercel/otel에서 registerOTel을 임포트한 뒤 서비스 이름과 함께 호출한다.
결과: 트레이싱 세션 중 SvelteKit이 생성하는 스팬이 Vercel 인프라 스팬 트리에 병합되어 표시된다.
시각화: SvelteKit 스팬은 초록색으로 구분되어 인프라 스팬과 구별 가능하다.
확장: 다른 OpenTelemetry 수집기를 설정해 Datadog, Grafana 등 외부 도구로도 내보낼 수 있다.
현재 상태: 실험 기능(experimental) 플래그로, SvelteKit 공식 문서에서 최신 지원 범위 확인 권장.

왜 읽나SvelteKit 앱을 Vercel에 배포하면서 서버측 성능 병목이나 오류 경로를 추적하려는 개발자에게 실제 설정 방법을 제공한다.

Vercel Blog 블로그

원문은 여기서 이어서 읽을 수 있어요

읽음 (0)