qyl

qyl은 .NET 애플리케이션을 위해 맞춤 제작된 완전한 로컬 관측성 솔루션을 제공합니다. 글로벌 도구를 설치하고 `qyl up`을 실행하면 사용자는 localhost에서 컬렉터와 내장 대시보드를 시작할 수 있습니다. 이 시스템은 트레이스, 로그, 메트릭을 포함한 텔레메트리 데이터를 캡처하여 `~/.qyl/`에 로컬로 저장합니다. .NET 애플리케이션으로의 통합은 `Qyl.Telemetry.Hosting` 패키지를 통해 간소화됩니다. `AddQyl()`을 한 번 호출하면 자동 계측이 활성화되고, 액티비티 소스와 미터가 등록되며, OTLP를 통해 데이터가 내보내집니다. 이 아키텍처는 단일 진실 공급원(single source of truth)에서 생성된 공유 계약과 시맨틱 규약을 통해 생산자와 컬렉터가 분리되면서도 동기화되도록 보장합니다. 주요 기능은 다음과 같습니다: - **로컬 스택**: 외부 의존성 없이 컬렉터, 대시보드, API를 로컬에서 실행합니다. - **자동 계측**: 텔레메트리 캡처를 시작하기 위해 최소한의 코드 변경만 필요합니다. - **대시보드 및 API**: 내장 UI를 통해 데이터를 시각화하거나 REST 또는 MCP 엔드포인트를 통해 프로그래밍 방식으로 쿼리할 수 있습니다. - **네이티브 AOT 지원**: Native AOT ASP.NET Core API를 위한 샘플과 SDK 지원을 포함합니다. - **엄격한 계약**: TypeSpec과 Weaver 레지스트리를 사용하여 생산자 상수와 컬렉터 수집 카탈로그 간의 일관성을 보장합니다. 이 프로젝트는 MIT 라이선스에 따라 제공되며, 다양한 패키지 전반에서 신뢰성을 보장하기 위한 포괄적인 빌드 검증 프로세스를 포함합니다.