qyl

qyl 为 .NET 应用提供完整的本地可观测性解决方案。安装全局工具并运行 `qyl up` 后，用户可在 localhost 上启动收集器和内嵌仪表板。系统捕获 traces、logs 和 metrics 等遥测数据，并将其本地存储在 `~/.qyl/` 中。 通过 `Qyl.Telemetry.Hosting` 包可简化与 .NET 应用的集成。只需调用一次 `AddQyl()` 即可启用自动埋点、注册 activity sources 和 meters，并通过 OTLP 导出数据。该架构确保生产者与收集器解耦，同时通过由单一事实来源生成的共享契约和语义约定保持同步。 主要特性包括： - **本地栈**：在本地运行收集器、仪表板和 API，无需外部依赖。 - **自动埋点**：只需极少代码改动即可开始捕获遥测数据。 - **仪表板与 API**：通过内嵌 UI 可视化数据，或通过 REST 或 MCP 端点以编程方式查询。 - **Native AOT 支持**：包含面向 Native AOT ASP.NET Core API 的示例和 SDK 支持。 - **严格契约**：使用 TypeSpec 和 Weaver registries 确保生产者常量与收集器摄取目录之间的一致性。 该项目采用 MIT 许可证，并包含全面的构建验证流程，以确保其各个包的可靠性。