protologbeat
Version 0.2.0
ويهدف هذا التطبيق كبديل لudplogbeat. على الرغم من تشابهه تمامًا، إلا أنه يحتوي على بعض التحسينات ويسمح لك ببدء التشغيل عبر UDP أو TCP. يمكن أن يعمل على قبول النص العادي أو سجلات JSON ويعمل أيضًا كبديل لوجهة سجل النظام.
تأكد من وجود هذا المجلد في الموقع التالي: ${GOPATH}/github.com/harfordfive
protologbeat.protocol : إما tcp أو udp (الافتراضي: udp)protologbeat.address : العنوان الذي سيتم تسجيل العملية عليه (الافتراضي: 127.0.0.1)protologbeat.port : المنفذ الذي ستستمع إليه العملية (الافتراضي = 5000)protologbeat.max_message_size : الحد الأقصى لحجم الرسالة المقبولة (الافتراضي = 4096)protologbeat.json_mode : تمكين تسجيل الرسائل بتنسيق JSON فقط (افتراضي = خطأ)protolog.merge_fields_to_root : عند تمكين json_mode ، سواء لدمج الحقول التي تم تحليلها إلى مستوى الجذر. (الافتراضي = خطأ)protologbeat.default_es_log_type : نوع Elasticsearch لتعيينه لحدث إذا لم يتم تحديده (افتراضي: protologbeat)protologbeat.enable_syslog_format_only : قيمة منطقية تشير إلى ما إذا كان يجب قبول رسائل سجل النظام فقط. (الافتراضي = خطأ)protologbeat.enable_gelf : قيمة منطقية تشير إلى ما إذا كان يجب أن تكون العملية في الوضع لقبول الرسائل بتنسيق GELF فقطprotologbeat.enable_json_validation : قيمة منطقية تشير إلى ما إذا كان يجب تطبيق التحقق من صحة مخطط JSON على رسائل تنسيق json (افتراضي = false)protologbeat.validate_all_json_types : عند تمكين json_mode، يشير إلى ما إذا كان يجب أن تحتوي جميع الأنواع على مخطط محدد. لن يتم نشر إدخالات السجل ذات الأنواع التي لا تحتوي على مخطط. (الافتراضي = خطأ)protologbeat.json_schema : تجزئة تتكون من نوع Elasticsearch كمفتاح، ومسار ملف المخطط المحلي المطلق كقيمة. فيما يلي أمثلة على كتل التكوين لقسم protologbeat .
يمكن إنشاء مخططات JSON تلقائيًا من كائن هنا: http://jsonschema.net/. يمكنك أيضًا عرض مخططات email_contact وstock_item كأمثلة.
يرجى مراجعة دليل _samples/ للحصول على أمثلة للعملاء بلغات مختلفة.
لتشغيل Protologbeat وتثبيت التبعيات أيضًا، قم بتشغيل الأمر التالي:
make setup
سيتم إنشاء سجل git نظيف لكل خطوة رئيسية. لاحظ أنه يمكنك دائمًا إعادة كتابة السجل إذا كنت ترغب في ذلك قبل دفع التغييرات.
لدفع Protologbeat في مستودع git، قم بتشغيل الأوامر التالية:
git remote set-url origin https://github.com/harfordfive/protologbeat
git push origin master
لمزيد من التطوير، راجع دليل مطور Beat.
لإنشاء الملف الثنائي لـ Protologbeat، قم بتشغيل الأمر أدناه. سيؤدي هذا إلى إنشاء ملف ثنائي في نفس الدليل بالاسم protologbeat.
make
إذا كنت ترغب في إنشاء الملف الثنائي لأنظمة التشغيل OSX و/أو Linux و/أو Windows، فيمكنك تشغيل ما يلي:
./build-bin [TAG_VERSION]
سيتم وضع الثنائيات الناتجة في الدليل bin/
لتشغيل Protologbeat مع تمكين إخراج التصحيح، قم بتشغيل:
./protologbeat -c protologbeat.yml -e -d "*"
لاختبار Protologbeat، قم بتشغيل الأمر التالي:
make testsuite
بدلاً عن ذلك:
make unit-tests
make system-tests
make integration-tests
make coverage-report
يتم الإبلاغ عن تغطية الاختبار في المجلد ./build/coverage/
تحتوي كل إيقاع على قالب للتعيين في Elasticsearch ووثائق للحقول التي يتم إنشاؤها تلقائيًا بناءً على etc/fields.yml . لإنشاء etc/protologbeat.template.json وetc/protologbeat.asciidoc
make update
لتنظيف التعليمات البرمجية المصدر لـ Protologbeat، قم بتشغيل الأوامر التالية:
make fmt
make simplify
لتنظيف دليل البناء والعناصر التي تم إنشاؤها، قم بتشغيل:
make clean
لاستنساخ Protologbeat من مستودع git، قم بتشغيل الأوامر التالية:
mkdir -p ${GOPATH}/github.com/harfordfive
cd ${GOPATH}/github.com/harfordfive
git clone https://github.com/harfordfive/protologbeat
لمزيد من التطوير، راجع دليل مطور Beat.
يمكنك العثور على صور Docker لهذه الإيقاع هنا. يرجى ملاحظة أن الحاوية تبدأ بتكوين أساسي يستمع إلى البروتوكول/العنوان/المنفذ الافتراضي ويقبل الرسائل النصية العادية. بالنسبة لأية تخصيصات، يرجى تعديل نموذج التكوين protologbeat.full.yml وإنشاء ملف Docker الخاص بك الذي يحل محل الملف الأصلي.
توفر أطر الإيقاع أدوات لتجميع إيقاعاتك وتجميعها لمنصات مختلفة. وهذا يتطلب عامل إرساء والبائعين كما هو موضح أعلاه. لإنشاء حزم من إيقاعك، قم بتشغيل الأمر التالي:
make package
سيؤدي هذا إلى جلب وإنشاء جميع الصور المطلوبة لعملية الإنشاء. يمكن أن تستغرق عملية الحفر حتى النهاية عدة دقائق.
