syslogappender

RFC-5424를 완벽하게 지원하는 로그백용 Syslog 어펜더

syslogappender

[syslog4j][]를 활용하여 RFC-5424 형식과 호환되는 syslog를 통해 원격 시스템에 로그 메시지를 보내는 Logback 어펜더입니다.

왜?

Logback용 기존 syslog 어펜더는 UDP를 통해 메시지를 보내는 기능만 제공합니다. syslog-java-client를 사용하면 TCP를 통해 메시지를 보낼 수 있고 선택적으로 TLS를 사용하여 TCP를 통해 전송하여 메시지를 암호화할 수 있습니다. 또한 이 라이브러리는 RFC-5424에 따라 메시지 길이를 추가하여 새 줄이 포함된 로그 줄이 올바르게 작동하도록 합니다.

어떻게?

https://bintray.com/serioussam/oss/com.github.serioussam%3Asyslogappender를 사용하여 설정 다음을 pom.xml 에 추가하세요.

    < dependency >
      < groupId >com.github.serioussam</ groupId >
      < artifactId >syslogappender</ artifactId >
      < version >1.0.0</ version >
    </ dependency >

그런 다음 logback.xml 에 어펜더를 추가하세요.

Maven을 사용하지 않는 경우 [logback-syslog4j-1.0.0.jar][] 및 최신 [syslog4j][] JAR을 다운로드하세요. Logback 자체와 함께 클래스 경로에 이러한 파일을 배치합니다.

TLS를 사용하여 TCP를 통해 로깅(권장)

  < appender name = " SYSLOG-TLS " class = " com.github.serioussam.syslogappender.SyslogAppender " >
    < layout class = " ch.qos.logback.classic.PatternLayout " >
      < pattern >%date %-5level %logger{35} - %message%n</ pattern >
    </ layout >

    < syslogConfig class = " SyslogConfig " >
      <!-- remote system to log to -->
      < host >localhost</ host >
      <!-- remote port to log to -->
      < port >514</ port >
      <!-- program name to log as -->
      < programName >java-app</ programName >
      <!-- protocol TCP_TLS -->
      < protocol >TCP_TLS</ protocol >
    </ syslogConfig >
  </ appender > 

  < root level = " DEBUG " >
    < appender-ref ref = " SYSLOG-TLS " />
  </ root >

TCP를 통한 로깅

  < appender name = " SYSLOG-TCP " class = " com.github.serioussam.syslogappender.SyslogAppender " >
    < layout class = " ch.qos.logback.classic.PatternLayout " >
      < pattern >%date %-5level %logger{35} - %message%n</ pattern >
    </ layout >

    < syslogConfig class = " SyslogConfig " >
      <!-- remote system to log to -->
      < host >localhost</ host >
      <!-- remote port to log to -->
      < port >514</ port >
      <!-- program name to log as -->
      < programName >java-app</ programName >
      <!-- protocol TCP -->
      < protocol >TCP</ protocol >
    </ syslogConfig >
  </ appender > 

  < root level = " DEBUG " >
    < appender-ref ref = " SYSLOG-TCP " />
  </ root >

UDP를 통한 로깅

  < appender name = " SYSLOG-UDP " class = " com.github.serioussam.syslogappender.SyslogAppender " >
    < layout class = " ch.qos.logback.classic.PatternLayout " >
      < pattern >%date %-5level %logger{35} - %message%n</ pattern >
    </ layout >

    < syslogConfig class = " SyslogConfig " >
      <!-- remote system to log to -->
      < host >localhost</ host >
      <!-- remote port to log to -->
      < port >514</ port >
      <!-- program name to log as -->
      < programName >java-app</ programName >
      <!-- protocol UDP -->
      < protocol >UDP</ protocol >
    </ syslogConfig >
  </ appender > 

  < root level = " DEBUG " >
    < appender-ref ref = " SYSLOG-UDP " />
  </ root >