Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Log File analysis and visualization for Clojure
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
doc
img
src/lumberjack
test/lumberjack
.gitignore
README.md
project.clj

README.md

lumberjack

A Clojure library designed to help with your log lines. Currently creates a log entry structure for Nginx logs, and allows for some basic visualization of time series data.

Dependencies

Dev Dependencies

Artifacts

Lumberjack artifacts are released to Clojars. If you are using Maven, add the following repository definition to your pom.xml:

<repository>
  <id>clojars.org</id>
  <url>http://clojars.org/repo</url>
</repository>

The Most Recent Release

With Leiningen:

[lumberjack "0.1.0"]

With Maven:

<dependency>
  <groupId>lumberjack</groupId>
  <artifactId>lumberjack</artifactId>
  <version>0.1.0</version>
</dependency>

Usage

To view a simple time series graph of the number of hits by the minute:

=> (use 'lumberjack.core)
=> (use 'lumberjack.nginx)
=> (use 'lumberjack.visualization)
(view-time-series (nginx-logs [path-to-nginx-log file]) :by timestamp-minute :grouping-name "minute")

Doing the above will give you a graph that looks like the following.

time series by timestamp minute

For very large log files you may need to update the project.clj file to include a setting for the allowed memory size via:

 :jvm-opts ["-Xmx768M"]

and adjust the 768M to an appropriate number of megabytes.

License

Copyright © 2013 Steven Proctor

Distributed under the Eclipse Public License, the same as Clojure.

Something went wrong with that request. Please try again.