About this project

qyl provides a complete local observability solution tailored for .NET applications. By installing the global tool and running `qyl up`, users can start a collector and an embedded dashboard on localhost. The system captures telemetry data including traces, logs, and metrics, storing them locally in `~/.qyl/`. Integration into .NET applications is streamlined through the `Qyl.Telemetry.Hosting` package. A single call to `AddQyl()` activates automatic instrumentation, registers activity sources and meters, and exports data over OTLP. The architecture ensures that producers and collectors are decoupled yet synchronized through shared contracts and semantic conventions generated from a single source of truth. Key features include: - **Local Stack**: Runs collector, dashboard, and APIs locally without external dependencies. - **Automatic Instrumentation**: Minimal code changes required to start capturing telemetry. - **Dashboard & API**: Visualize data via an embedded UI or query it programmatically via REST or MCP endpoints. - **Native AOT Support**: Includes samples and SDK support for Native AOT ASP.NET Core APIs. - **Strict Contracts**: Uses TypeSpec and Weaver registries to ensure consistency between producer constants and collector ingest catalogs. The project is licensed under MIT and includes comprehensive build verification processes to ensure reliability across its various packages.