seq forwarder

시퀀스 전달자

Seq Forwarder는 로컬 HTTP API를 통해 이벤트를 수신하고 원격 Seq 서버에 도달할 수 있을 때까지 자체 내부 스토리지에 유지하는 클라이언트 측 로그 수집기입니다.

Seq Forwarder는 기본적으로 포트 15341 에서 수신 대기합니다. HTTP 수집 API는 Seq와 동일하므로 Serilog.Sinks.Seq 와 같은 표준 클라이언트 라이브러리에 직접 쓸 수 있습니다.

 Log.Logger = new LoggerConfiguration() .WriteTo.Seq("http://localhost:15341").CreateLogger();Log.Information("안녕하세요, Seq 전달자!");

클라이언트 애플리케이션은 Seq Forwarder에 로그인할 때 API 키를 지정할 수 있습니다. 이 경우 클라이언트가 제공한 API 키는 대상 Seq 서버로 전달됩니다.

또는 API 키를 사용하여 Seq Forwarder를 구성할 수 있으며, 클라이언트 애플리케이션이 API 키를 지정하지 않을 때 이를 사용하여 Seq에 기록합니다.

시작하기

먼저, 귀하의 플랫폼에 맞는 릴리스 번들을 다운로드하고 적절한 위치에 추출하십시오.

아래 지침에서는 seqfwd 명령줄을 사용합니다. 사용 가능한 명령에 대해 알아보려면 seqfwd help 시도해 보세요.

Windows의 경우

Seq Forwarder를 Windows 서비스로 설정하려면 Seq Forwarder 디렉터리의 관리 PowerShell 프롬프트에서 대상 Seq 서버 URL과 선택적 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 시작

기본 버퍼 크기 제한은 64MB입니다. 예시에서는 1GB로 늘어났습니다.

업그레이드하려면 서비스를 중지하고 전달자 릴리스 번들을 덮어쓴 다음 서비스를 다시 시작하십시오.

Windows에서 Seq Forwarder는 머신 범위 DPAPI를 사용하여 기본 API 키와 클라이언트가 제공하는 모든 API 키를 암호화합니다.

macOS 또는 Linux에서

Linux에서는 liblmdb 필요합니다.

apt install liblmdb-dev

Seq Forwarder를 실행하려면 대상 Seq 서버 URL과 선택적으로 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 키가 일반 텍스트로 저장됩니다.

기본 버퍼 크기 한도는 64MB입니다. 예시에서는 1GB로 늘어났습니다.

개발

Seq Forwarder는 Windows, macOS 및 Linux에서 .NET Core SDK를 사용하여 빌드할 수 있는 .NET Core 애플리케이션입니다.

디버깅하려면 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 에 있습니다.