المسجل Logger في كوكب Kawkab

المقدمة

التسجيل (Logging) جزء أساسي من أي تطبيق، حيث يساعد على تتبع حالة النظام وسلوكه. إطار العمل كوكب Kawkab يوفر نظام تسجيل مدمج يتيح لك تسجيل الرسائل بمستويات متعددة مثل: info، warn، error، verbose، debug، وsilly.

استخدام نظام التسجيل

الاستيراد

لبدء استخدام نظام التسجيل في كوكب Kawkab، يجب استيراد log من مكتبة kawkab:

import { log } from "kawkab";

تسجيل الرسائل

تسجيل رسالة عامة

لتسجيل رسالة بمستوى معين، استخدم الدالة message مع تحديد مستوى السجل المطلوب.

مثال:

log.message('info', 'هذه رسالة معلوماتية.');

تسجيل رسالة خطأ

لتسجيل رسالة خطأ، استخدم الطريقة error:

مثال:

log.error('حدث خطأ في النظام.');

تسجيل رسالة تحذير

لتسجيل رسالة تحذيرية، استخدم الطريقة warn:

مثال:

log.warn('هذه رسالة تحذيرية.');

تسجيل رسالة معلوماتية

لتسجيل رسالة معلوماتية، استخدم الطريقة info:

مثال:

log.info('هذه رسالة معلوماتية.');

تسجيل رسالة تفصيلية

لتسجيل رسالة تحتوي على تفاصيل أكثر من المستوى المعلوماتي، استخدم الطريقة verbose:

مثال:

log.verbose('هذه رسالة تحتوي على تفاصيل إضافية.');

تسجيل رسالة تصحيحية (Debugging)

لتسجيل رسالة تصحيحية أثناء التطوير، استخدم الطريقة debug:

مثال:

log.debug('هذه رسالة تصحيحية.');

تسجيل رسالة تفصيلية جدًا

لتسجيل رسالة بأعلى مستوى من التفاصيل، استخدم الطريقة silly:

مثال:

log.silly('هذه رسالة شديدة التفصيل.');

تخزين السجلات

ملف السجلات

يتم تخزين جميع الرسائل المسجلة في ملف باسم app.log.
يحتوي هذا الملف على جميع الأحداث المسجلة ويمكن استخدامه لمراجعة السجلات وتحليل أداء النظام.

مثال على محتويات ملف السجل:

[2024-11-28T14:32:00.000Z] [INFO] - تم تشغيل التطبيق بنجاح.
[2024-11-28T14:33:00.000Z] [ERROR] - حدث خطأ في قاعدة البيانات.

الخاتمة

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

ابدأ باستخدام نظام التسجيل اليوم لجعل تطبيقك أكثر استقرارًا واحترافية!