Skip to content

Latest commit

 

History

History
167 lines (125 loc) · 6.11 KB

README.md

File metadata and controls

167 lines (125 loc) · 6.11 KB
Raw

Logback more appenders

is additional appenders for Logback and provide better performance and data consistency without any concern.

Appenders

Java 9 module(Jigsaw) with old Slf4j API.

This version is a patch for applications implemented with Java9 module(Jigsaw) but using Slf4j version 1.7(which is not a java 9 module), for example Spring boot doesn't allow to use Slf4j 1.8.x(org.slf4j module).

Just add it to your dependency then you can use the slf4j module in your application.

Gradle
  implementation 'com.sndyuk:logback-more-appenders:1.8.6-JAVA9MODULE_SLF4J17'
Maven
  <dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-classic</artifactId>
    <version>1.8.7-JAVA9MODULE_SLF4J17</version>
  </dependency>
module-info.java
  requires org.slf4j;

Latest changes

Version 1.8.8
  • Fix CloudWatch appenders duplicate logs: #71
Version 1.8.7
  • Add ignoredField option: #65
Version 1.8.6
  • Add AWS V2 CloudWatch and Kinesis appenders: #64
Version 1.8.5
  • Add option for Fluency appender: jvmHeapBufferMode
Version 1.8.4
  • Avoid CloudWatch request limit error
  • Fix issue: #60
Version 1.8.3
  • Make marker prefix customizable by markerPrefix option. #51
  • Fix issue: Error creating cloud watch appender with version 1.8.2-JAVA9MODULE_SLF4J17 and 1.8.1-JAVA9MODULE_SLF4J17. #60
Version 1.8.2
  • Fix issue at FastJsonEncoder.
Version 1.8.1
  • Add options for Fluent / Fluency appenders:
    • "encoder" option becomes optional. If you don't set encoder, the log message outputs pure message.
    • "messageFieldKeyName" option has been added: Set it if you want to change the default message field key name(= "message").
  • Add options for Fluency appender: bufferChunkRetentionTimeMillis
  • Fix bug: Messages were lost sometimes when the messages had been waiting for flushing on shutting down an application.
  • Fix bug: Fluent appender: Do not raise an error when a fluentd server is down.

Installing

Install jars from Maven2 repository

Configure your pom.xml:

<dependencies>

  <dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-classic</artifactId>
    <version>${logback.version}</version>
  </dependency>

  <dependency>
    <groupId>com.sndyuk</groupId>
    <artifactId>logback-more-appenders</artifactId>
    <version>1.8.7</version>
  </dependency>

  <!-- [Optional] If you use The CloudWatch V2 appender, You need to add the dependency(cloudwatchlogs). -->
  <dependency>
    <groupId>software.amazon.awssdk</groupId>
    <artifactId>cloudwatchlogs</artifactId>
    <version>${aws-v2.version}</version>
  </dependency>

  <!-- [Optional] If you use The CloudWatch appender, You need to add the dependency(aws-java-sdk-logs). -->
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-logs</artifactId>
    <version>${aws.version}</version>
  </dependency>

  <!-- [Optional] If you use The Kinesis V2 appender, You need to add the dependency(kinesis). -->
  <dependency>
    <groupId>software.amazon.awssdk</groupId>
    <artifactId>kinesis</artifactId>
    <version>${aws-v2.version}</version>
    <optional>true</optional>
  </dependency>

  <!-- [Optional] If you use The Kinesis appender, You need to add the dependency(aws-java-sdk-kinesis). -->
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-kinesis</artifactId>
    <version>${aws.version}</version>
  </dependency>

  <!-- [Optional] If you use The Fluentd appender, You need to add the dependency(fluent-logger). -->
  <dependency>
    <groupId>org.fluentd</groupId>
    <artifactId>fluent-logger</artifactId>
    <version>${fluentd.logger.version}</version>
  </dependency>

  <!-- [Optional] If you use The Fluency appender, You need to add the dependency(fluency). -->
  <dependency>
    <groupId>org.komamitsu</groupId>
    <artifactId>fluency-core</artifactId>
    <version>${fluency.version}</version>
    <optional>true</optional>
  </dependency>
  <dependency>
    <groupId>org.komamitsu</groupId>
    <artifactId>fluency-fluentd</artifactId>
    <version>${fluency.version}</version>
    <optional>true</optional>
  </dependency>

</dependencies>

Configure your logback.xml

You can find the sample configuration files here:

License

Apache License, Version 2.0