عند استكشاف مشكلات أو أخطاء Discourse، من المهم مراجعة السجلات (logs). فيما يلي قائمة بمواقعها وما تحتويه.
نطاق موقعك
سجلات الإدارة المعروضة في واجهة المستخدم
تحتوي لوحة تحكم إدارة Discourse على عدة أشكال من التسجيل (logging):
- يتم تسجيل رسائل البريد الإلكتروني المرسلة، التي تم تخطيها، المرتدة، المستلمة، والمرفوضة على الرابط https://=DOMAIN=/admin/email-logs والألسنة المجاورة.
- يتم تسجيل إجراءات الموظفين على الرابط https://=DOMAIN=/admin/logs/staff_action_logs
- سيتم إدراج عناوين البريد الإلكتروني وعناوين IP التي تم حظرها من التسجيل في https://=DOMAIN=/admin/logs/screened_emails و https://=DOMAIN=/admin/logs/screened_ip_addresses
- يتم إدراج الروابط التي نشرتها الحسابات التي تم حظرها كمرسلي بريد عشوائي (spammers) على الرابط https://=DOMAIN=/admin/logs/screened_urls
- يتم عرض سجلات تحليلات البحث على الرابط https://=DOMAIN=/admin/logs/search_logs
واجهة المستخدم الرسومية لعرض السجلات Logster
يأتي كل تثبيت لـ Discourse مزودًا بعارض سجلات بواجهة رسومية (GUI). وهو موجود على: https://=DOMAIN=/logs
ملاحظة: إذا كنت تستخدم خطة مستضافة، فقد تكون هذه الصفحة مخفية عنك. بدلاً من ذلك، اتصل بالدعم عندما تواجه هذا النوع من المشكلات!
إذا كنت تحقق في خطأ غامض 500 (500 error) في المنتديات، فيجب عليك دائمًا تجربة هذا المكان أولاً!
حدد سطر الخطأ للحصول على تفاصيل عنه. قد يُطلب منك تقديم محتويات علامات التبويب env و backtrace هنا على Meta.
سجلات Rails / Pitchfork
يحتوي Ruby on Rails على سجل مفصل للغاية يتم كتابته على القرص. بالإضافة إلى ذلك، يقوم خادم الويب pitchfork (وهو نسخة مشتقة من unicorn) أيضًا بالتسجيل على القرص.
للوصول إليها:
cd /var/discourse
./launcher enter app
cd /shared/log/rails
يحتوي هذا المجلد على “production.log” و “unicorn.stderr.log” بالإضافة إلى ملفات السجل “المُدارة” (rotated). يمكنك استخدام أدوات Unix القياسية مثل less production.log لفحصها.
هذا المجلد متاح أيضًا دون الدخول إلى الحاوية عبر المسار /var/discourse/shared/standalone/log/rails.
سجلات NGINX
قد تحتوي سجلات NGINX في بعض الأحيان على بعض التلميحات الإضافية، وهي موجودة في:
cd /var/discourse
./launcher enter app
cd /var/log/nginx
سيكون الملفان access.log و error.log موجودين هناك بالإضافة إلى مجموعة من الملفات المضغوطة التي تم تدويرها. سيؤدي تشغيل less access.log.2.gz إلى فك ضغط ملف السجل وعرضه تلقائيًا لك.
هذا الدليل متاح أيضًا على المضيف عبر المسار /var/discourse/shared/standalone/log/var-log/nginx.
سجلات Redis
على الرغم من أنه من النادر جدًا الحاجة إلى رؤية سجلات Redis، إذا احتجت إليها، فإنها تذهب إلى /var/log/redis داخل الحاوية و /var/discourse/shared/standalone/log/var-log/redis على المضيف. ستكون أحدث إدخالات السجل موجودة في ملف current في ذلك الدليل.
سجلات PostgreSQL
إذا كنت بحاجة إلى مراجعة سجلات خادم قاعدة البيانات، فهي موجودة في /var/log/postgres داخل الحاوية و /var/discourse/shared/standalone/log/var-log/postgres على المضيف؛ تكون أحدث الإدخالات في الملف current في ذلك الدليل.