الرصد واستكشاف الأخطاء

يبدأ رصد TokenLab الجيد بالمعرفات العامة. يجب أن تساعدك سجلاتك في الإجابة على "ما الذي طلبه المستخدم، وما هي المهمة العامة التي أنشأها TokenLab، وكيف تم الفوترة؟" دون الكشف عن تفاصيل مزود حساسة أو بيانات مستخدم حساسة.

من الطلب إلى التحقيق والدعمCopy Anchor Link

1. افتح الطلبات في مساحة العمل المالكة للطلب. ابحث عن Request ID وحدد الصف.

2. افتح التفاصيل الكاملة في صفحة مستقلة. تعيد العودة إلى القائمة عوامل التصفية. لا يمنح الرابط صلاحية الوصول إلى مساحة أخرى؛ استخدم حسابًا مخولًا.

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

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

5. احتفظ بتأكيد الإرسال وتابع المحادثة نفسها في الدعم للردود والمعلومات الإضافية بدل إنشاء طلبات مكررة.

المعرفات العامة التي يجب التقاطهاCopy Anchor Link

لا تخزن معرفات مهام المزود، عناوين URL الخاصة بالمزود، معرفات المزود، مفاتيح Redis، أو بيانات التنفيذ الحساسة كسجلات ظاهرة للعملاء.

ما يجب تسجيلهCopy Anchor Link

سجل ما يكفي لتشخيص الطلب دون تسريب الأسرار:

• نقطة النهاية، طريقة HTTP، النموذج، رمز الحالة، الطابع الزمني، والكمون.
• المعرفات العامة: request_id، task_id، poll_url، و billing_transaction_id عند وجودها.
• شكل الطلب المنقح: أي الحقول كانت موجودة، وليس النص الكامل أو محتوى الوسائط الخاصة.
• استجابات الحالة غير المتزامنة النهائية، بما في ذلك حقول الخطأ العامة.
• عدد محاولات إعادة الاتصال من العميل وما إذا كانت إعادة الاتصال قد أنشأت مهمة جديدة أو استأنفت واحدة موجودة.

قم دائمًا بحجب Authorization، مفاتيح API، رموز الإدارة، عناوين URL الموقعة، عناوين URL الوسائط الخاصة، النصوص الكاملة، وبيانات المستخدم الشخصية ما لم يكن لديك إذن صريح للاحتفاظ بها.

مصفوفة استكشاف الأخطاءCopy Anchor Link

تسوية الاستخدامCopy Anchor Link

استخدم واجهة إدارة API للتسوية من جانب الخادم:

curl "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/usage?page=1&limit=20&scene=video" \
  -H "Authorization: Bearer mt-your-management-token"

GET /v1/management/api-keys/{keyId}/usage يمكن أن يقوم بالتصفية حسب scene، model، modelVendor، startDate، و endDate. استخدم هذه السجلات بدلاً من جمع بيانات صفحات لوحة التحكم أو الاعتماد على معرفات مهام المزود العلوية.

قد تستقر الاستجابات المتدفقة بعد إرسال التدفق، لذا قد يكون رأس الفوترة غائبًا حتى عندما يتم تسجيل الاستخدام لاحقًا. قد تستقر المهام الإعلامية غير المتزامنة بعد الاستعلام النهائي.

قالب حزمة الدعمCopy Anchor Link

عند الاتصال بالدعم، قم بتضمين:

• request_id.
• task_id و poll_url للعمل غير المتزامن.
• billing_transaction_id عند وجوده.
• نقطة النهاية، الطريقة، النموذج، الطابع الزمني، ورمز الحالة.
• شكل الطلب المنقح وجسم الخطأ العام.
• النتيجة المتوقعة وما رآه المستخدم فعليًا.

لا تتضمن مفاتيح API، رموز الإدارة، الوسائط الخاصة، النصوص الكاملة، عناوين URL للمزود، معرفات القنوات، أو معرفات التشخيص الخاصة ما لم يطلب دعم TokenLab صراحةً عينة محجوبة.

الفحوصات التشغيليةCopy Anchor Link

• تنبيه على تكرار الاستجابات 401، 402، 429، و 5xx بشكل منفصل؛ عادةً ما يكون لها مالكون مختلفون.
• تتبع المهام غير المتزامنة التي تبقى غير نهائية لفترة أطول من SLA المنتج الخاص بك.
• تتبع محاولات الإنشاء المكررة لنفس معرف وظيفة المستخدم.
• عيّن عينة من الوظائف المكتملة وتحقق من أن الأصل المرئي للمستخدم، سجل الاستخدام، وسجل المهمة المخزنة تتفق.

مرجع APICopy Anchor Link