Splitlog

Welcome to Splitlog

Splitlog helps you make some sense out of continually developing files, such as application log files. Think of it as tail and grep combined, plus much more. And, of course, it is open source software.

What can Splitlog do for you?

Block your code until a specific message appears in the log.

Say you're writing integration tests for a web application. Your servlet is deploying and you only want to start your tests after it deploys. Splitlog to the rescue — just wait for the deployment notification from the server!

Focus on the interesting parts of the log.

Let's say the log contains a lot of junk, such as DEBUG-level information. You can use Splitlog to filter it out and only tell you about the important stuff.

Forward any part of the log to a different file.

Ever wondered which part of the server log happened while your test was running? Look no further, Splitlog can tell you.

And much more...

Currently, the only log format supported is the JBoss server log format, but it is trivial to make Splitlog understand any other format. Pull requests are welcome!

Using Splitlog

Splitlog is a Maven-based project, licensed under the Apache Software License 2.0. To use it in your Maven projects, you simply need to use the following dependency:

<dependency>
    <groupId>com.github.triceo.splitlog</groupId>
    <artifactId>splitlog-core</artifactId>
    <version>1.7.2</version>
</dependency>

Look for the artifacts in the Maven Central repository.

Alternately, you can download the uber-JAR to bundle in your applications directly.

Looking for support?

Splitlog documentation is available here. We also provide Javadocs and source code cross-reference.

At the moment, there is no user forum for Splitlog. Bugs can be filed through Github and we welcome any pull requests. And don't worry about your code so much — if you break it, the the machines will tell you.