عن المشروع

يوفر qyl حلاً كاملاً للمراقبة المحلية مخصصًا لتطبيقات .NET. ومن خلال تثبيت الأداة العامة وتشغيل `qyl up`، يمكن للمستخدمين بدء مجمّع ولوحة تحكم مدمجة على localhost. يلتقط النظام بيانات القياس عن بُعد بما في ذلك التتبعات والسجلات والمقاييس، ويخزّنها محليًا في `~/.qyl/`. يتم تبسيط التكامل في تطبيقات .NET من خلال حزمة `Qyl.Telemetry.Hosting`. وتؤدي استدعاءة واحدة إلى `AddQyl()` إلى تفعيل القياس التلقائي، وتسجيل مصادر النشاط والعدادات، وتصدير البيانات عبر OTLP. ويضمن هذا البنية أن المنتجين والمجمعين منفصلون ومع ذلك متزامنون من خلال العقود المشتركة والاصطلاحات الدلالية المولّدة من مصدر حقيقة واحد. تشمل الميزات الرئيسية: - **حزمة محلية**: تشغيل المجمّع ولوحة التحكم وواجهات API محليًا دون تبعيات خارجية. - **قياس تلقائي**: تغييرات برمجية طفيفة مطلوبة لبدء التقاط بيانات القياس عن بُعد. - **لوحة تحكم وواجهة API**: عرض البيانات عبر واجهة مستخدم مدمجة أو الاستعلام عنها برمجيًا عبر نقاط نهاية REST أو MCP. - **دعم Native AOT**: يتضمن عينات ودعمًا في SDK لواجهات ASP.NET Core API بتقنية Native AOT. - **عقود صارمة**: يستخدم TypeSpec وسجلات Weaver لضمان الاتساق بين ثوابت المنتج وفهارس استيعاب المجمّع. المشروع مرخّص بموجب MIT ويتضمن عمليات تحقق شاملة من البناء لضمان الموثوقية عبر حزمه المختلفة.