تعرّفت للتو على السجلات الموسومة (tagged logging) في Rails. هل تعلمون أنه يمكنكم وسم السجل باستخدام

logger.tagged('Your Tag') { logger.info('Message') }

config/application.rb

ويمكنكم أيضًا تطبيق ذلك على مستوى التطبيق كله باستخدام

# config/application.rb
config.log_tags = [:method_on_request_object, lambda { |request| request.method.modifier_method }]

config/application.rb

أضيفوا معلومات نظام تشغيل جهاز العميل وإصداره إلى السجلات (يتطلب ذلك أن يرسل العملاء ترويستي X-OS وX-OS-Version)

# config/application.rb
config.log_tags = [ :request_id, lambda { |request| "#{request.headers['HTTP_X_OS']} #{request.headers['HTTP_X_OS_VERSION']}" } ]

في بيئات الإنتاج، يمكن إضافة إعدادات خاصة في الملف config/environments/production.rb لتحسين التسجيل والأداء.

1. مقدمة عن وسوم السجلات

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

2. إعداد مكوّنات Rails

يُعدّ إعداد مكوّنات Rails جزءًا أساسيًا من تهيئة تطبيقكم. نناقش في هذا القسم كيفية إعداد مكوّنات Rails المختلفة، بما فيها التطبيق والبيئة والـ middleware. كما نتناول كيفية استخدام الدالة config لإعداد تهيئات مخصصة لتطبيقكم.

3. تخصيص وسوم السجلات

يتيح لكم تخصيص وسوم السجلات إضافة معلومات محددة ذات صلة بتطبيقكم. نناقش في هذا القسم كيفية تخصيص وسوم السجلات باستخدام الدالة log_tags. كما نتناول كيفية استخدام الـ Procs والكائنات التي تستجيب لـ to_s لإضافة معلومات ديناميكية إلى سجلاتكم.

4. أمثلة على وسم السجلات

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

5. أفضل الممارسات لوسوم السجلات

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