استخدام مكتبة المسجل: كيفية كتابة السجلات في روبي

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

نظرًا لأن مكتبة المسجل تأتي مع Ruby ، ​​فلا حاجة لتثبيت أي أحجار كريمة أو مكتبات أخرى. لبدء استخدام مكتبة المسجل ، ببساطة تطلب "المسجل" وإنشاء كائن مسجل جديد. ستتم كتابة أي رسائل مكتوبة إلى كائن المسجل إلى ملف السجل.

#! / usr / bin / env ruby
تتطلب "مسجل"
log = Logger.new ('log.txt')
log.debug "تم إنشاء ملف السجل"

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

في المثال السابق ، كانت الأولوية تصحيح الأخطاء، الأقل أهمية لجميع الأولويات ("تأجيل حتى يكون لديك وقت" من قائمة المهام الخاصة بك ، إذا أردت). أولويات رسالة السجل ، بالترتيب من الأقل إلى الأكثر أهمية ، هي كما يلي: debug، info، warn، خطأوقاتل. لتعيين مستوى الرسائل التي يجب أن يتجاهلها المسجل ، استخدم مستوى ينسب.

#! / usr / bin / env ruby
تتطلب "مسجل"
log = Logger.new ('log.txt')
log.level = مسجل:: WARN
log.debug "سيتم تجاهل هذا"
log.error "لن يتم تجاهل هذا"

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

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

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

#! / usr / bin / env ruby
تتطلب "مسجل"
log = Logger.new ('log.txt'، 'daily')
log.debug "بمجرد أن يصبح السجل واحدًا على الأقل"
log.debug "يوم ، ستتم إعادة تسميته و"
log.debug "سيتم إنشاء ملف log.txt جديد."