ضبط مستويات السجل أثناء التشغيل

قد يرغب المستخدم أحيانًا في سجلات مختصرة، وأحيانًا في تفاصيل عميقة. يتيح MCP للعميل ضبط مستوى السجل أثناء التشغيل بدلًا من إعادة تشغيل الخادم.

يرسل العميل طلب logging/setLevel محددًا أدنى مستوى يريده. وبما أن هذا طلب، يرد الخادم لتأكيده.

لا يتلقى الخادم setLevel إلا إذا أعلن عن إمكانية logging أثناء مصافحة التهيئة. ويُمكّن FastMCP ذلك نيابةً عنك.

المستوى المختار هو عتبة. يعني ضبطه على warning أن warning وكل ما هو أشد خطورة سيمر، بينما تُسقط الرسائل الأقل أهمية.

بعد setLevel، يقارن الخادم خطورة كل سجل بالحد الأدنى. وأي شيء أدنى من العتبة لا يُرسل إلى ذلك العميل ببساطة.

لتصحيح تشغيل معقّد، يمكن للعميل ضبط المستوى على debug. عندها تُرسل كل رسالة، حتى التتبعات المليئة بالضوضاء، للفحص.

للحصول على عرض هادئ في بيئة الإنتاج، اضبطه على error. عندها لا تصل إلا حالات الفشل، فتظل شاشة المستخدم خالية من الرسائل الاعتيادية.

ينطبق المستوى على جلسة ذلك العميل. ويؤدي تغييره لاحقًا إلى تحريك الحد الأدنى فقط؛ ولا يتطلب اتصالًا جديدًا أو إعادة تحميل.

قبل وصول أي setLevel، يستخدم الخادم حدّه الافتراضي، وغالبًا ما يكون info. سجّل دائمًا بتفصيل وافٍ، ودع العميل يختار ما يحتفظ به.

تعني المستويات أثناء التشغيل أنك تشحن إصدارًا واحدًا هادئًا افتراضيًا، لكنه جاهز للتحول إلى verbose فور إبلاغ المستخدم عن خطأ يصعب العثور عليه.

يتحكم هذا القرص في استدعاءات ctx.info وctx.debug نفسها التي تكتبها. يختار العميل الحد الأدنى، بينما يسجّل كودك بمستويات صادقة.

تعلّمت أن logging/setLevel يضبط حدًا أدنى أثناء التشغيل، وكيف تُسقط التصفية الرسائل الأقل أهمية، ولماذا يحافظ ذلك على مرونة إصدار واحد. ممتاز!