إعداد تسجيل Cloudflare AI Gateway: الضوابط والاختبارات

إعداد تسجيل Cloudflare AI Gateway يجب أن يبدأ بالأدلة التي يحتاج إليها فريقك والمحتوى الذي ينبغي تجنب الاحتفاظ به. قد تجعل لوحة المعلومات الطلبات ظاهرة، لكنها تنشئ أيضا مخزنا جديدا للمطالبات والاستجابات والبيانات الوصفية. يعتمد الإعداد الصحيح على الاستخدام التشغيلي وعقد التسجيل الحالي للحساب معا.

حدد هل تستخدم البوابة نظام Workers Logs الحالي أم Legacy Logs، ثم اضبط جمع السجلات وتخزين محتواها عمدا. اختبر مسار الطلب الفعلي بعلامات مصطنعة، وافحص السجلات الناتجة. احتفظ ببيانات وصفية تشغيلية مفيدة عند ملاءمتها، دون افتراض أن تعطيل تخزين المحتوى يزيل البيانات من كل نظام آخر.

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

يركز هذا الدليل على تجهيز تشغيلي مقترح. ولا يقدم شهادة امتثال قانوني، أو يفترض خضوع جميع الحسابات لترتيبات التسعير والاحتفاظ والتصدير نفسها.

إعداد تسجيل Cloudflare AI Gateway يعتمد على أهلية الحساب

تميز وثائق تسجيل AI Gateway الحالية بين العملاء وفقا لموعد إنشاء أول بوابة لهم. يتبع العملاء الذين ينشئون أول بوابة في 24 سبتمبر 2026 أو بعده تسعير Workers Logs واحتفاظه، بينما يستخدم العملاء الأسبق Legacy Logs. تحقق من أهلية الحساب الذي تضبطه.

لا تنقل فترة احتفاظ أو حصة سجلات من مقالة أقدم وتطبقها على كل نشر. سجل ترتيب الخدمة الساري والإعدادات المختارة وتاريخ التحقق. وأعد التحقق عندما يتغير الحساب أو بنية التسجيل.

تفصل الوثائق نفسها بين جمع قيد السجل كاملا وتخزين محتوى طلبه واستجابته. يتيح هذا التمييز نقاشا أدق من مجرد السؤال هل التسجيل مفعل أم معطل.

حدد أسئلة الحوادث أولا

اكتب الأسئلة التي يجب أن يجيب عنها مسؤول التشغيل. أي عبء عمل أخفق؟ وأي مزود ومسار نموذج استخدما؟ وهل أعاد التطبيق المحاولة؟ وهل عادت استجابة قبل توقف المستخدم عن الانتظار؟ وهل ما زالت المهمة في الوجهة غير محسومة؟

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

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

يغطي دليل AI Gateway الحالي لدينا الدور الأوسع للوكيل والتحكم في التكلفة. أما عمل الإعداد هنا فيتعلق بإثبات الأدلة الموجودة فعليا وسلوك الجمع المختار.

اضبط جمع القيد والمحتوى بصورة منفصلة

توثق Cloudflare الترويسة cf-aig-collect-log لجمع قيد السجل كاملا، والترويسة cf-aig-collect-log-payload لتخزين محتوى الطلب والاستجابة. قد يحفظ ضبط التحكم في المحتوى على false البيانات الوصفية دون الأجسام الخام؛ أما تعطيل القيد كاملا فيحجب القيد بما فيه البيانات الوصفية. اقرأ دلالات الترويسات الحالية قبل تطبيقها.

السياسة التالية توضيحية للترويسة، وليست طلبا كاملا أو دليلا على النتيجة المنشورة:

1cf-aig-collect-log-payload: false

طبق السياسة في مكون تطبيق موثوق. يجب ألا يستطيع مستدع غير موثوق تغيير سياسة الأدلة في المؤسسة بحقن ترويسات تحكم عشوائية للبوابة. حدد الترويسات التي يمررها الخادم أو يضبطها أو يزيلها.

لا تستنتج الإعداد الافتراضي من طلب ناجح واحد. تحقق من إعداد مستوى البوابة ومسار التجاوز الخاص بكل طلب بصورة منفصلة. قد يختلف سلوك إعداد يعمل لمسار النموذج الأساسي عند استخدام بديل أو عميل آخر.

احتفظ بسجل للسياسة الفعلية

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

عندما يضيف مطور تكامل نموذج آخر، يجب أن تشمل المراجعة مسار تسجيله. وإلا فقد تتراكم عدة مسارات بسلوك احتفاظ مختلف، بينما يعتقد الفريق وجود سياسة عامة واحدة.

استخدم بيانات وصفية لا تتحول إلى محتوى إضافي

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

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

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

تحقق من الجمع بعلامات مصطنعة

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

اختبر استجابة عادية وخطأ لدى المزود ومسارا بديلا إذا استخدمه التطبيق. معالجة الأخطاء موضع شائع لنسخ أجسام الطلبات إلى حقول تشخيص خارج مسار الجمع العادي.

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

أدرج الصادرات والمخازن الأخرى في المراجعة

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

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

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

استخدم حالات مصطنعة لاختبارات منع التراجع الاعتيادية. وعندما يلزم محتوى فعلي للتحقيق في عيب، فحدد غرض جمع خاصا ووصولا مضبوطا بدلا من تغيير السياسة العامة دون سجل.

خصص ميزانية للأدلة المفيدة وصيانتها

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

اطلب عرضا بالجنيه الإسترليني GBP يحدد نظام البوابة والاختبارات المطلوب تسليمها. تختلف مهمة إعداد فقط عن إعادة بناء تسجيل التطبيق عبر عدة مسارات نماذج ووجهات تصدير.

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

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

الأسئلة الشائعة

هل تستخدم كل حسابات AI Gateway نظام التسجيل نفسه؟ لا. تميز الوثائق الحالية العملاء الذين أنشئت أول بوابة لهم في 24 سبتمبر 2026 أو بعده عن العملاء الأسبق. تحقق هل ينطبق Workers Logs أم Legacy Logs قبل الاعتماد على افتراضات التسعير أو الاحتفاظ.

هل يمكن حفظ البيانات الوصفية دون أجسام المطالبات والاستجابات؟ يدعم التحكم الموثق في جمع المحتوى قيودا تتضمن البيانات الوصفية فقط عند ضبطه بصورة مناسبة. تحقق من سياسة البوابة والطلب الفعلية، وافحص نتائج الاختبار في وجهة التسجيل الحقيقية.

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

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

كيف نختبر التسجيل دون بيانات العملاء؟ استخدم علامات مصطنعة في طلبات غير حساسة، وافحص السجلات والصادرات ذات الصلة. أدرج النتائج العادية والأخطاء وإعادة المحاولات والمسارات البديلة. أكد أن البيانات الوصفية لا تتضمن العلامة بصورة غير مباشرة.

هل ينبغي السماح للعملاء باختيار سياسة تسجيلهم؟ فقط عندما تكون تلك الصلاحية مقصودة. طبق سياسة المؤسسة في مكون خادم موثوق، وحدد ترويسات التحكم المقبولة أو التي يعاد ضبطها. يجب ألا يغير مستدع عادي سياسة الأدلة بصمت.

ما الذي ينبغي أن يقدمه التقييم؟ يجب أن يحدد العقد الساري ومخازن البيانات وسياسة الجمع الفعلية ومسؤولي الوصول وقرارات الاحتفاظ. أدرج نتائج تحقق مصطنعة وإجراء قابلا للتكرار لفحص مسارات نماذج أو وجهات سجلات جديدة.