منصوبے کے بارے میں

qyl .NET ایپلیکیشنز کے لیے تیار کردہ مکمل مقامی آبزرویبلٹی حل فراہم کرتا ہے۔ گلوبل ٹول انسٹال کرکے اور `qyl up` چلا کر، صارفین localhost پر ایک کلیکٹر اور ایمبیڈڈ ڈیش بورڈ شروع کرسکتے ہیں۔ یہ نظام ٹیلی میٹری ڈیٹا بشمول ٹریسز، لاگز اور میٹرکس حاصل کرتا ہے اور انہیں `~/.qyl/` میں مقامی طور پر محفوظ کرتا ہے۔ .NET ایپلیکیشنز میں انٹیگریشن `Qyl.Telemetry.Hosting` پیکیج کے ذریعے آسان بنایا گیا ہے۔ `AddQyl()` کی ایک کال خودکار انسٹرومنٹیشن کو فعال کرتی ہے، ایکٹیویٹی سورسز اور میٹرز رجسٹر کرتی ہے، اور OTLP کے ذریعے ڈیٹا ایکسپورٹ کرتی ہے۔ یہ آرکیٹیکچر یقینی بناتا ہے کہ پروڈیوسرز اور کلیکٹرز الگ الگ مگر مشترکہ کنٹریکٹس اور سیمنٹک کنونشنز کے ذریعے ہم آہنگ رہیں جو ایک ہی ذریعہ سے تیار ہوتے ہیں۔ اہم خصوصیات میں شامل ہیں: - **مقامی اسٹیک**: بغیر کسی بیرونی انحصار کے کلیکٹر، ڈیش بورڈ اور APIs مقامی طور پر چلاتا ہے۔ - **خودکار انسٹرومنٹیشن**: ٹیلی میٹری کیپچر شروع کرنے کے لیے کم سے کم کوڈ تبدیلیاں درکار۔ - **ڈیش بورڈ اور API**: ایمبیڈڈ UI کے ذریعے ڈیٹا دیکھیں یا REST یا MCP اینڈ پوائنٹس کے ذریعے پروگرامی طور پر استفسار کریں۔ - **نیٹو AOT سپورٹ**: نیٹو AOT ASP.NET Core APIs کے لیے نمونے اور SDK سپورٹ شامل ہیں۔ - **سخت کنٹریکٹس**: پروڈیوسر کنسٹنٹس اور کلیکٹر انجیسٹ کیٹلاگز کے درمیان مستقل مزاجی کو یقینی بنانے کے لیے TypeSpec اور Weaver رجسٹریز استعمال کرتا ہے۔ یہ پروجیکٹ MIT لائسنس کے تحت ہے اور اس میں جامع بلڈ تصدیقی عمل شامل ہے تاکہ اس کے مختلف پیکیجز میں قابل اعتمادی کو یقینی بنایا جاسکے۔