หน้าแรก>การเขียนโปรแกรมที่เกี่ยวข้อง>ซอร์สโค้ดอื่น ๆ
ดาวน์โหลด

ผู้ส่งต่อ Seq

Seq Forwarder คือตัวรวบรวมบันทึกฝั่งไคลเอ็นต์ที่รับเหตุการณ์ผ่าน HTTP API ในเครื่องและคงไว้ในที่จัดเก็บข้อมูลภายในของตัวเองจนกว่าจะสามารถเข้าถึงเซิร์ฟเวอร์ Seq ระยะไกลได้

Seq Forwarder ฟังพอร์ต 15341 โดยค่าเริ่มต้น API การนำเข้า HTTP นั้นเหมือนกับ Seq one ดังนั้นไลบรารีไคลเอนต์มาตรฐาน เช่น Serilog.Sinks.Seq จึงสามารถเขียนลงไปได้โดยตรง

 Log.Logger = ใหม่ 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 -k output.serverUrl --value="http://seq.example.com/"./seqfwd config -k output.apiKey --value="1a2b3c4d5e6f"./seqfwd config -k storage.bufferSizeBytes -v 1073741824./seqfwd ติดตั้ง
./seqfwd เริ่มต้น

ขีดจำกัดขนาดบัฟเฟอร์เริ่มต้นคือ 64 MB ในตัวอย่างนี้ เพิ่มเป็น 1 GB

หากต้องการอัปเกรด ให้หยุดบริการ เขียนทับชุดการเผยแพร่ตัวส่งต่อ และรีสตาร์ทบริการ

บน Windows Seq Forwarder จะใช้ DPAPI ที่กำหนดขอบเขตด้วยเครื่องเพื่อเข้ารหัสคีย์ API เริ่มต้นและคีย์ API ใดๆ ที่ไคลเอ็นต์ส่งมา

บน macOS หรือ Linux

บน Linux คุณจะต้องมี liblmdb : 

apt install liblmdb-dev

หากต้องการเรียกใช้ Seq Forwarder ให้กำหนดค่า URL เซิร์ฟเวอร์ Seq เป้าหมาย และอาจเลือกคีย์ API:

 ./seqfwd config -k output.serverUrl --value="http://seq.example.com/"./seqfwd config -k output.apiKey --value="1a2b3c4d5e6f"./seqfwd config -k storage.bufferSizeBytes -v 1073741824
./seqfwd วิ่ง

โปรดทราบ ว่าบน macOS และ Linux คีย์ API เอาต์พุตและคีย์ API ใดๆ ที่ไคลเอ็นต์ให้ไว้จะถูกจัดเก็บไว้ในข้อความธรรมดา

ขีดจำกัดขนาดบัฟเฟอร์เริ่มต้นคือ 64 MB ในตัวอย่างนี้ เพิ่มเป็น 1 GB

การพัฒนา

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 ) มีเฉพาะบนแพลตฟอร์มนั้นเท่านั้น

ตัวอย่างการกำหนดค่า SeqForwarder.json

คำสั่ง seqfwd config อ่านและเขียน SeqForwarder.json :

 { "การวินิจฉัย": {"internalLogPath": "C:ProgramDataSeqLogs"internalLoggingLevel": "ข้อมูล"
  }, "เอาท์พุท": {"serverUrl": "http://localhost:5341", "eventBodyLimitBytes": 262144, "rawPayloadLimitBytes": 10485760, "apiKey": null
  }, "ที่เก็บข้อมูล": {"bufferSizeBytes": 67108864
  }, "api": {"listenUri": "http://localhost:15341"
  -
-

บน Windows ไฟล์นี้อยู่ใน C:ProgramDataSeqForwarder

ขยาย
ข้อมูลเพิ่มเติม
แอปที่เกี่ยวข้อง
แนะนำสำหรับคุณ
ข้อมูลที่เกี่ยวข้อง ทั้งหมด