seq forwarder

Seq Forwarder

Seq Forwarder adalah pengumpul log sisi klien yang menerima peristiwa melalui API HTTP lokalnya dan menyimpannya di penyimpanan internalnya sendiri hingga server Seq jarak jauh dapat dijangkau.

Seq Forwarder mendengarkan pada port 15341 secara default. API penyerapan HTTP identik dengan Seq, sehingga pustaka klien standar seperti Serilog.Sinks.Seq dapat menulis ke dalamnya secara langsung.

 Log.Logger = new LoggerConfiguration() .WriteTo.Seq("http://localhost:15341").CreateLogger();Log.Information("Halo, Seq Forwarder!");

Aplikasi klien dapat menentukan kunci API saat masuk ke Seq Forwarder. Dalam hal ini kunci API yang diberikan oleh klien akan diteruskan ke server Seq target.

Alternatifnya, Seq Forwarder dapat dikonfigurasi dengan kunci API, dan akan menggunakannya untuk masuk ke Seq ketika aplikasi klien tidak menentukannya.

Memulai

Pertama, unduh bundel rilis untuk platform Anda, dan ekstrak ke lokasi yang sesuai.

Petunjuk di bawah ini menggunakan baris perintah seqfwd . Untuk mempelajari tentang perintah yang tersedia, coba seqfwd help .

Di Windows

Untuk menyiapkan Seq Forwarder sebagai layanan Windows, dari perintah PowerShell administratif di direktori Seq Forwarder, tetapkan URL server Seq target dan kunci API opsional:

 ./seqfwd config -k output.serverUrl --value="http://seq.example.com/"./seqfwd config -k output.apiKey --value="1a2b3c4d5e6f"./seqfwd config -k penyimpanan.bufferSizeBytes -v 1073741824./seqfwd instal
./seqfwd mulai

Batas ukuran buffer default adalah 64 MB. Misalnya, ini ditingkatkan menjadi 1 GB.

Untuk memutakhirkan, hentikan layanan, timpa bundel rilis penerus, dan mulai ulang layanan.

Di Windows, Seq Forwarder akan menggunakan DPAPI cakupan mesin untuk mengenkripsi kunci API default dan kunci API apa pun yang disediakan oleh klien.

Di macOS atau Linux

Di Linux, Anda memerlukan liblmdb :

apt install liblmdb-dev

Untuk menjalankan Seq Forwarder, konfigurasikan URL server Seq target, dan secara opsional, kunci API:

 ./seqfwd config -k output.serverUrl --value="http://seq.example.com/"./seqfwd config -k output.apiKey --value="1a2b3c4d5e6f"./seqfwd config -k penyimpanan.bufferSizeBytes -v 1073741824
./seqfwd dijalankan

Perhatikan bahwa di macOS dan Linux, kunci API keluaran dan kunci API apa pun yang disediakan oleh klien akan disimpan dalam teks biasa.

Batas ukuran buffer default adalah 64 MB. Misalnya, ini ditingkatkan menjadi 1 GB.

Perkembangan

Seq Forwarder adalah aplikasi .NET Core yang dapat dibangun menggunakan .NET Core SDK di Windows, macOS, dan Linux.

Untuk melakukan debug, F5 akan berfungsi, tetapi pada Windows Anda harus menjalankan perintah install (lihat di bawah) untuk membuat reservasi namespace HTTP, atau dijalankan sebagai Administrator.

Pemecahan masalah

Secara default, log "penerus" akan disimpan di bawah %PROGRAMDATA%SeqLogs . Jika server Seq tujuan tidak tersedia, pengecualian akan disimpan dalam file log ini.

Jika Anda perlu memeriksa konfigurasi saat ini, konfigurasi tersebut dapat ditemukan di: %PROGRAMDATA%SeqForwarderSeqForwarder.json

Penggunaan baris perintah

> ./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

Perhatikan bahwa HTTP Windows dan perintah terkait layanan ( bind-ssl , install , restart , start , status , stop , dan uninstall ) hanya tersedia di platform tersebut.

Contoh konfigurasi SeqForwarder.json

Perintah seqfwd config membaca dan menulis SeqForwarder.json :

 { "diagnostik": {"internalLogPath": "C:ProgramDataSeqLogs","internalLoggingLevel": "Informasi"
  }, "output": {"serverUrl": "http://localhost:5341","eventBodyLimitBytes": 262144,"rawPayloadLimitBytes": 10485760,"apiKey": null
  }, "penyimpanan": {"bufferSizeBytes": 67108864
  }, "api": {"listenUri": "http://localhost:15341"
  }
}

Di Windows, file ini berada di C:ProgramDataSeqForwarder .