syslogappender

Anexador Syslog para logback com suporte total a RFC-5424

syslogappender

Um anexador de Logback que aproveita [syslog4j][] para enviar mensagens de log para sistemas remotos via syslog compatível com o formato RFC-5424.

Por que?

O anexador syslog existente para Logback fornece apenas a capacidade de enviar mensagens via UDP. Usar syslog-java-client nos permite enviar mensagens via TCP e, opcionalmente, criptografá-las enviando por TCP com TLS. Esta biblioteca também se encarrega de adicionar o comprimento da mensagem conforme RFC-5424 para que as linhas de log contendo novas linhas funcionem corretamente.

Como?

Configuração usando https://bintray.com/serioussam/oss/com.github.serioussam%3Asyslogappender Adicione isto ao seu pom.xml :

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

Em seguida, adicione o anexador ao seu logback.xml .

Se não estiver usando o Maven, baixe [logback-syslog4j-1.0.0.jar][] e o JAR [syslog4j][] mais recente. Coloque esses arquivos no classpath, além do próprio Logback.

Registro via TCP com TLS (recomendado)

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

Registro via 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 >

Registro via 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 >