This appender sends logs to your Logz.io account, using non-blocking threading, bulks, and HTTPS encryption. Please note that this appendr requires logback version 1.1.7 and up, and java 8 and up.

This appender uses LogzioSender implementation. All logs are backed up to a local file system before being sent. Once you send a log, it will be enqueued in the buffer and 100% non-blocking. There is a background task that will handle the log shipment for you. This jar is an "Uber-Jar" that shades both BigQueue, Gson and Guava to avoid "dependency hell".

<dependency>
    <groupId>io.logz.logback</groupId>
    <artifactId>logzio-logback-appender</artifactId>
    <version>1.0.17</version>
</dependency>

<!-- Use debug=true here if you want to see output from the appender itself -->
<!-- Use line=true here if you want to see the line of code that generated this log -->
<configuration>
    <!-- Use shutdownHook so that we can close gracefully and finish the log drain -->
    <shutdownHook class="ch.qos.logback.core.hook.DelayingShutdownHook"/>
    <appender name="LogzioLogbackAppender" class="io.logz.logback.LogzioLogbackAppender">
        <token>yourlogziopersonaltokenfromsettings</token>
        <logzioType>myAwesomeType</logzioType>
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <level>INFO</level>
        </filter>
    </appender>
</configuration>

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class LogzioLogbackExample {

    public static void main(String[] args) {
        Logger logger = LoggerFactory.getLogger(LogzioLogbackExample.class);
        
        logger.info("Testing logz.io!");
        logger.warn("Winter is coming");
    }
}

Each key value you will add to MDC will be added to each log line as long as the thread alive. No further configuration needed.

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.slf4j.MDC;

public class LogzioLogbackExample {

    public static void main(String[] args) {
        Logger logger = LoggerFactory.getLogger(LogzioLogbackExample.class);

        MDC.put("Key", "Value");
        logger.info("This log will hold the MDC data as well");
    }
}

Will send a log to Logz.io that looks like this:

{
    "message": "This log will hold the MDC data as well",
    "Key": "Value",
    ... (all other fields you used to get)
}

Markers are named objects used to enrich log statements, so each log line will be enriched with its own. No further configuration needed.

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.slf4j.Marker;

public class LogzioLogbackExample {

    public static void main(String[] args) {
        Logger logger = LoggerFactory.getLogger(LogzioLogbackExample.class);

        Marker marker = MarkerFactory.getMarker("Fatal");
        logger.error(marker, "This line has a fatal error");
    }
}

Will send a log to Logz.io that looks like this:

{
    "message": "This line has a fatal error",
    "Marker": "Fatal",
    ... (all other fields you used to get)
}

• 1.0.16 - 1.0.17
  • added line parameter to enable printing the line of code that generated this log
• 1.0.15 - 1.0.16
  • add error message about reason of 400(BAD REQUEST)
• 1.0.1 - 1.0.14
  • Separate LogzioSender to independent project, add dependency on logzio-sender
• 1.0.12
  • Add Marker support
• 1.0.11
  • Add environment variables support to token and logzioUrl parameters
• 1.0.10
  • Replace task executor in case of old executor termination
• 1.0.9
  • Fixed an issue preventing the appender to restart if asked. Also, prevented hot-loading of logback config.xml
• 1.0.8
  • Fixed filesystem percentage wrong calculation (#12)
• 1.0.7
  • Create different buffers for different types
  • Moved LogzioSender class to be a factory, by log type - meaning no different configurations for the same type (which does not make sense anyway)
• 1.0.6
  • Fix: Appender can get into dead-lock thus causing all threads logging to bloc
  • Refactored all Unit tests
  • Switched to maven wrapper for build consistency
• 1.0.5
  • Add MDC support
  • Replace exception handling to use Logback own instead of implementing alone
  • Periodically calls BigQueue GC function so we can release files on local disk
• 1.0.4
  • If you logged a throwable as well, we will put it inside a field named "exception"
• 1.0.3
  • Addional fields support
  • Add hostname to logs support
• 1.0.0 - 1.0.2
  • Initial releases

• Fork
• Code
• mvn test
• Issue a PR :)