المعرفات العامة التي يجب التقاطها
لا تخزن معرفات مهام المزود، عناوين URL الخاصة بالمزود، معرفات المزود، مفاتيح Redis، أو بيانات التنفيذ الحساسة كسجلات ظاهرة للعملاء.
ما يجب تسجيله
سجل ما يكفي لتشخيص الطلب دون تسريب الأسرار:- نقطة النهاية، طريقة HTTP، النموذج، رمز الحالة، الطابع الزمني، والكمون.
- المعرفات العامة:
request_id،task_id،poll_url، وbilling_transaction_idعند وجودها. - شكل الطلب المنقح: أي الحقول كانت موجودة، وليس النص الكامل أو محتوى الوسائط الخاصة.
- استجابات الحالة غير المتزامنة النهائية، بما في ذلك حقول الخطأ العامة.
- عدد محاولات إعادة الاتصال من العميل وما إذا كانت إعادة الاتصال قد أنشأت مهمة جديدة أو استأنفت واحدة موجودة.
Authorization، مفاتيح API، رموز الإدارة، عناوين URL الموقعة، عناوين URL الوسائط الخاصة، النصوص الكاملة، وبيانات المستخدم الشخصية ما لم يكن لديك إذن صريح للاحتفاظ بها.
مصفوفة استكشاف الأخطاء
تسوية الاستخدام
استخدم واجهة إدارة API للتسوية من جانب الخادم:GET /v1/management/api-keys/{keyId}/usage يمكن أن يقوم بالتصفية حسب scene، model، modelVendor، startDate، و endDate. استخدم هذه السجلات بدلاً من جمع بيانات صفحات لوحة التحكم أو الاعتماد على معرفات مهام المزود العلوية.
قد تستقر الاستجابات المتدفقة بعد إرسال التدفق، لذا قد يكون رأس الفوترة غائبًا حتى عندما يتم تسجيل الاستخدام لاحقًا. قد تستقر المهام الإعلامية غير المتزامنة بعد الاستعلام النهائي.
قالب حزمة الدعم
عند الاتصال بالدعم، قم بتضمين:request_id.task_idوpoll_urlللعمل غير المتزامن.billing_transaction_idعند وجوده.- نقطة النهاية، الطريقة، النموذج، الطابع الزمني، ورمز الحالة.
- شكل الطلب المنقح وجسم الخطأ العام.
- النتيجة المتوقعة وما رآه المستخدم فعليًا.
الفحوصات التشغيلية
- تنبيه على تكرار الاستجابات
401،402،429، و5xxبشكل منفصل؛ عادةً ما يكون لها مالكون مختلفون. - تتبع المهام غير المتزامنة التي تبقى غير نهائية لفترة أطول من SLA المنتج الخاص بك.
- تتبع محاولات الإنشاء المكررة لنفس معرف وظيفة المستخدم.
- عيّن عينة من الوظائف المكتملة وتحقق من أن الأصل المرئي للمستخدم، سجل الاستخدام، وسجل المهمة المخزنة تتفق.