Extensions for Logback logging library

License	The MIT License (MIT)
Categories	Logback Application Layer Libs Logging
GroupId	co.wrisk.logback
ArtifactId	logback-ext-kinesis-appender
Last Version	1.0.9
Release Date	May 2, 2017
Type	jar
Description	Extensions for Logback logging library Extensions for Logback logging library
Project URL	https://github.com/WriskHQ/logback-ext
Source Code Management	https://github.com/WriskHQ/logback-ext

Download logback-ext-kinesis-appender

Filename	Size
logback-ext-kinesis-appender-1.0.9.pom
logback-ext-kinesis-appender-1.0.9.jar	4 KB
logback-ext-kinesis-appender-1.0.9-sources.jar	2 KB
logback-ext-kinesis-appender-1.0.9-javadoc.jar	25 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/co.wrisk.logback/logback-ext-kinesis-appender/ -->
<dependency>
    <groupId>co.wrisk.logback</groupId>
    <artifactId>logback-ext-kinesis-appender</artifactId>
    <version>1.0.9</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/co.wrisk.logback/logback-ext-kinesis-appender/
implementation 'co.wrisk.logback:logback-ext-kinesis-appender:1.0.9'

Gradle Kotlin

// https://jarcasting.com/artifacts/co.wrisk.logback/logback-ext-kinesis-appender/
implementation ("co.wrisk.logback:logback-ext-kinesis-appender:1.0.9")

Apache Buildr

'co.wrisk.logback:logback-ext-kinesis-appender:jar:1.0.9'

Apache Ivy

<dependency org="co.wrisk.logback" name="logback-ext-kinesis-appender" rev="1.0.9">
  <artifact name="logback-ext-kinesis-appender" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='co.wrisk.logback', module='logback-ext-kinesis-appender', version='1.0.9')
)

Scala SBT

libraryDependencies += "co.wrisk.logback" % "logback-ext-kinesis-appender" % "1.0.9"

Leiningen

[co.wrisk.logback/logback-ext-kinesis-appender "1.0.9"]

Dependencies

compile (4)

Group / Artifact	Type	Version
ch.qos.logback : logback-core	jar	1.2.1
ch.qos.logback : logback-classic	jar	1.2.1
com.amazonaws : aws-java-sdk-kinesis	jar	1.11.35
co.wrisk.logback : logback-ext-aws-core	jar	1.0.9

Project Modules

There are no modules declared in this project.

Logback Extensions

This is a fork of https://github.com/trautonen/logback-ext

Extensions for Logback logging library mainly for appenders aimed for Amazon Web Services, including CloudWatch Logs, DynamoDB, Kinesis, SNS and SQS appenders. Contains also high performance asynchronous appender based on LMAX disrupotr and some utilities like Jackson JSON encoder.

Using Logback Extensions

Logback Extensions requires Java 8 or newer. Include desired modules in your project's dependency management and configure the appenders or encoders using Logback's XML configutation or Java API.

Modules

All modules belong to group org.eluder.logback. See each module for specific documentation.

• Extensions core module: logback-ext-core
• AWS core module: logback-ext-aws-core
• Jackson JSON encoder: logback-ext-jackson
• LMAX Disruptor appender: logback-ext-lmax-appender
• CloudWatch appender: logback-ext-cloudwatch-appender
• DynamoDB appender: logback-ext-dynamodb-appender
• Kinesis appender: logback-ext-kinesis-appender
• SNS appender: logback-ext-sns-appender
• SQS appender: logback-ext-sqs-appender

AWS Authentication

All AWS based appenders require IAM authentication. The default credentials provider from org.eluder.logback.ext.aws.core.AwsSupport creates a credential chain in the following order.

1. Environment variables AWS_ACCESS_KEY_ID and AWS_SECRET_KEY
2. System properties aws.accessKeyId and aws.secretKey
3. Appender configuration properties accessKey and secretKey
4. AWS profile configuration file ~/.aws/credentials
5. EC2 instance role

Best practice for EC2 instances is to use instance role only. With instance role no access keys or secret keys are exposed if the server is compromised.

Continuous Integration

CircleCI builds the project with Oracle JDK 8. Builds are deployed to Sonatype OSSRH.

Wrisk

Versions

Version
1.0.9 May 2, 2017
1.0.3 Sep 14, 2016
1.0.1-alpha.1 Sep 14, 2016