ما الذي ينبغي تضمينه في تقرير خطأ الوكيل

أعطِ الدعم الخطوة التي فشلت والخطأ الدقيق، بدل الاكتفاء بقول «الوكيل لا يعمل». يمكن لتقرير صغير اتباع هذه البنية:

Client and version:
Proxy protocol and port:
Attempt time and timezone:
Connection / overall timeout settings:
Last completed stage:
Exact error or numeric status:
Same target over an allowed direct route:
Same target through another comparable endpoint:

صف المرحلة بأنها اتصال بالوكيل أو مصادقة الوكيل أو إنشاء النفق أو TLS الوجهة أو استجابة HTTP النهائية. مثلًا، «وكيل HTTP على المنفذ 8080؛ TCP متصل؛ أعاد CONNECT الحالة 407؛ لم يبدأ TLS الوجهة بعد» يحدد المشكلة دون كشف بيانات الدخول. عند خطأ شهادة، أبقِ فئته وسياق اسم المضيف المتوقع، وأخفِ الأسماء الخاصة عند الحاجة.

راجع النص الفعلي قبل مشاركته. أزل userinfo من URL الوكيل، وProxy-Authorization، وAuthorization الخاص بالوجهة، وCookie، وSet-Cookie، وقيم الاستعلام الخاصة وأجسام الطلبات. قد يتيح ملف ارتباط جلسة أو رمز bearer الوصول دون أن يبدو ككلمة مرور. قد يختلف إخفاء الأدوات باختلاف النسخة ووضع الإخراج؛ فلا يلزم أن ينقّح السجل المفصل والتتبع الكامل بالطريقة نفسها.

استخدم علامات مثل REDACTED_PROXY_PASSWORD مع إبقاء أسماء الترويسات وبنية URL والأخطاء الرقمية ظاهرة. لا تحذف كامل التبادل المحيط بالفشل. شارك نقاط النهاية الخاصة وتفاصيل الشبكة فقط في قناة الدعم المناسبة.

إذا أعاد طلب أدنى إلى وجهة غير ضارة أو خدمة تتحكم فيها إنتاج المشكلة، فأرفقه بدل تتبع يحتوي بيانات أعمال. إذا وقع الخطأ مع الوجهة الأصلية فقط، فاذكر ذلك: تغيير الوجهة يغير ما يثبته إعادة الإنتاج. لوكيل HTTP، يمكن لطلب curl محدود الوقت أن يقدم مثالًا أدنى.