السجلات
تسجل شاشة السجلات نشاط النظام داخل نقطة البيع. إنها أداة أساسية لاستكشاف الأخطاء وفهم ما يحدث وراء الكواليس.
الوصول إلى السجلات
افتح شاشة السجلات من لوحة الملاحة اليسرى (رمز نبض القلب).
نظرة عامة على الواجهة
البحث والتصفية
- بحث السجلات - العثور على إدخالات سجل محددة حسب محتوى الرسالة
- تصفية مستوى السجل - التصفية حسب مستوى السجل (info، warn، error)
- إعدادات العرض - تكوين الأعمدة المرئية
جدول السجلات
كل إدخال سجل يظهر:
| العمود | الوصف |
|---|---|
| الوقت | متى حدث الحدث |
| المستوى | الخطورة: info(رمادي)، warn(برتقالي)، error(أحمر) |
| الرسالة | وصف يمكن قراءته من قبل الإنسان للحدث |
| السياق | JSON قابل للتوسيع مع تفاصيل إضافية |
| الرمز | رمز الخطأ (يؤدي إلى الوثائق) |
مستويات السجل
Info (رمادي)
العمليات العادية والأحداث الناجحة:
- "تم جلب جميع معرفات المنتجات"
- "تم مزامنة العملاء الجدد"
- "تم جلب جميع معرفات الضرائب"
Warning (برتقالي)
مشكلات غير حرجة قد تحتاج إلى الانتباه:
- "تعذر تحديث الجلسة"
- "محاولة إعادة للمزامنة"
Error (أحمر)
مشكلات تحتاج إلى معالجة:
- "عذرًا، لا يمكنك سرد الموارد" (مشكلة في الإذن)
- "فشل طلب API"
- "خطأ في مزامنة قاعدة البيانات"
بيانات السياق
انقر على سهم التوسع في أي إدخال سجل لرؤية السياق التفصيلي بصيغة JSON:
{
"total": "6",
"execution_time": "54.79 ms",
"server_load": "[10.51, 10.42, 9.98]"
}
تشمل هذه البيانات:
- أعداد العناصر - عدد السجلات المتأثرة
- وقت التنفيذ - المدة التي استغرقتها العملية
- حمولة الخادم - مقاييس أداء الخادم
- تفاصيل الطلب/الاستجابة - لاستكشاف أخطاء API
رموز الخطأ
تتضمن العديد من إدخالات السجل رمز خطأ (مثل، API02004، DB01001). ترتبط هذه الرموز مباشرة بالوثائق الخاصة بـ رموز الأخطاء، والتي تقدم:
- شرح مفصل للخطأ
- الأسباب الشائعة
- خطوات استكشاف الأخطاء
إدخالات السجل الشائعة
عمليات المزامنة
[info] Fetched all IDs for products {...} 3 items
[info] Synced new customers {...} 1 item
[info] Fetched all IDs for taxes {...} 3 items
تشير هذه إلى نشاط مزامنة عادي. يظهر السياق عدد العناصر التي تمت مزامنتها.
أخطاء الأذونات
[error] Sorry, you cannot list resources {...} API02004
هذا يعني عادة أن المستخدم لا يملك الإذن للوصول إلى مورد. تحقق من أدوار المستخدمين في WP Admin > POS > Settings > Access.
مشكلات الجلسة
[warn] Unable to refresh session {...} API02007
لم تتمكن نقطة البيع من تحديث جلسة المصادقة. قد يتطلب ذلك تسجيل الخروج والدخول مرة أخرى.
استخدام السجلات للدعم
عند طلب الدعم:
- إعادة إنتاج المشكلة - نفذ الإجراء الذي يسبب المشكلة
- تحقق من السجلات - ابحث عن الأخطاء (الحمراء) أو التحذيرات (البرتقالية)
- توسيع السياق - الحصول على التفاصيل كاملة بصيغة JSON
- تدوين رمز الخطأ - تضمين هذا في طلب الدعم الخاص بك
- نسخ الإدخالات ذات الصلة - مشاركة رسائل السجل مع السياق
مراقبة الأداء
تشمل السجلات وقت التنفيذ ومقاييس حمولة الخادم. إذا لاحظت:
- أوقات تنفيذ عالية - قد يكون الخادم محملاً أو بطيئاً
- قيم حمولة خادم عالية - اعتبر تحسين الخادم
- انقطاعات متكررة - تحقق من الاتصال بالشبكة