seq forwarder
v2.1.128
Seq Forwarder هو مجمع سجلات من جانب العميل يتلقى الأحداث عبر HTTP API المحلي الخاص به ويحتفظ بها في وحدة التخزين الداخلية الخاصة به حتى يمكن الوصول إلى خادم Seq البعيد.
يستمع Seq Forwarder على المنفذ 15341 بشكل افتراضي. تتطابق واجهة برمجة تطبيقات استيعاب HTTP مع واجهة Seq، لذا يمكن لمكتبات العملاء القياسية مثل Serilog.Sinks.Seq الكتابة إليها مباشرة.
Log.Logger = new LoggerConfiguration() .WriteTo.Seq("http://localhost:15341").CreateLogger();Log.Information("Hello, Seq Forwarder!");يمكن لتطبيقات العميل تحديد مفتاح API عند تسجيل الدخول إلى Seq Forwarder. في هذه الحالة، سيتم إعادة توجيه مفتاح واجهة برمجة التطبيقات (API) الذي قدمه العميل إلى خادم Seq المستهدف.
وبدلاً من ذلك، يمكن تكوين Seq Forwarder باستخدام مفتاح API، وسيستخدم هذا لتسجيل الدخول إلى Seq عندما لا تحدد تطبيقات العميل واحدًا.
أولاً، قم بتنزيل حزمة الإصدار لمنصتك واستخرجها إلى الموقع المناسب.
تستخدم الإرشادات أدناه سطر الأوامر seqfwd . للتعرف على الأوامر المتوفرة، حاول استخدام seqfwd help .
لإعداد Seq Forwarder كخدمة Windows، من موجه PowerShell الإداري في دليل Seq Forwarder، قم بتعيين عنوان URL لخادم Seq المستهدف ومفتاح API اختياري:
./seqfwd config -kput.serverUrl --value="http://seq.example.com/"./seqfwd config -kput.apiKey --value="1a2b3c4d5e6f"./seqfwd config -k Storage.bufferSizeBytes -v 1073741824./seqfwd تثبيت ./seqfwd البداية
الحد الأقصى لحجم المخزن المؤقت الافتراضي هو 64 ميغابايت. في المثال، يتم زيادة هذا إلى 1 غيغابايت.
للترقية، قم بإيقاف الخدمة، والكتابة فوق حزمة إصدار معيد التوجيه، ثم أعد تشغيل الخدمة.
في نظام التشغيل Windows، سيستخدم Seq Forwarder DPAPI على نطاق الجهاز لتشفير مفتاح API الافتراضي وأي مفاتيح API يوفرها العملاء.
على نظام Linux، ستحتاج إلى liblmdb :
apt install liblmdb-dev
لتشغيل Seq Forwarder، قم بتكوين عنوان URL لخادم Seq المستهدف، واختياريًا، مفتاح API:
./seqfwd config -kput.serverUrl --value="http://seq.example.com/"./seqfwd config -kput.apiKey --value="1a2b3c4d5e6f"./seqfwd config -k Storage.bufferSizeBytes -ت1073741824 ./seqfwd تشغيل
لاحظ أنه في نظامي التشغيل macOS وLinux، سيتم تخزين مفتاح API الناتج وأي مفاتيح API يقدمها العملاء بنص عادي.
الحد الأقصى لحجم المخزن المؤقت الافتراضي هو 64 ميجابايت. في المثال، يتم زيادة هذا إلى 1 غيغابايت.
Seq Forwarder هو تطبيق .NET Core يمكن إنشاؤه باستخدام .NET Core SDK على أنظمة التشغيل Windows وmacOS وLinux.
لتصحيح الأخطاء، سيعمل F5 ، ولكن في نظام التشغيل Windows ستحتاج إما إلى تشغيل أمر install (انظر أدناه) لإنشاء حجز مساحة اسم HTTP، أو تشغيله كمسؤول.
افتراضيًا، سيتم تخزين سجلات "معيد التوجيه" ضمن %PROGRAMDATA%SeqLogs . إذا لم يكن خادم Seq الوجهة متاحًا، فسيتم تخزين استثناء في ملفات السجل هذه.
إذا كنت بحاجة إلى فحص التكوين الحالي، فيمكن العثور عليه على: %PROGRAMDATA%SeqForwarderSeqForwarder.json
> ./seqfwd help Usage: seqfwd <command> [<args>] Available commands are: bind-ssl Bind an installed SSL certificate to an HTTPS port served by Seq Forwarder config View and set fields in the SeqForwarder.json file; run with no arguments to list all fields dump Print the complete log buffer contents as JSON help Show information about available commands install Install the Seq Forwarder as a Windows service restart Restart the Windows service run Run the server interactively start Start the Windows service status Show the status of the Seq Forwarder service stop Stop the Windows service truncate Clear the log buffer contents uninstall Uninstall the Windows service version Print the current executable version
لاحظ أن Windows HTTP والأوامر المتعلقة بالخدمة ( bind-ssl و install و restart و start و status و stop و uninstall ) متاحة فقط على هذا النظام الأساسي.
يقوم أمر seqfwd config بقراءة وكتابة SeqForwarder.json :
{ "التشخيص": {"internalLogPath": "C:ProgramDataSeqLogs"، "internalLoggingLevel": "المعلومات"
}, "output": {"serverUrl": "http://localhost:5341",eventBodyLimitBytes": 262144,"rawPayloadLimitBytes": 10485760,"apiKey": null
}, "storage": {"bufferSizeBytes": 67108864
}, "api": {"listenUri": "http://localhost:15341"
}
} على نظام التشغيل Windows، يوجد هذا الملف في C:ProgramDataSeqForwarder .
