Logging macros which delegate to a specific logging implementation. At runtime a specific implementation is selected from, in order, slf4j, Apache commons-logging, log4j, and finally java.util.logging.
Logging levels are specified by clojure keywords corresponding to the values used in log4j and commons-logging:
:trace, :debug, :info, :warn, :error, :fatal
Logging occurs with the
log macro, or the level-specific convenience macros, which write either directly or via an agent. The log macros will not evaluate their message arguments unless the specific logging level is in effect. Alternately, you can use the
spy macro when you have code that needs to be evaluated, and also want to output the code and its result to the log.
Unless otherwise specified, the current namespace (as identified by
*ns*) will be used as the log-ns (similar to how the java class name is usually used). Note: your logging configuration should display the name that was passed to the logging implementation, and not perform stack-inspection, otherwise you'll see some ugly and unhelpful text in your logs.
enabled? macro to write conditional code against the logging level (beyond simply whether or not to call log, which is handled automatically).
You can redirect all java writes of
System.err to the log system by calling
log-capture!. To bind
*err* to the log system invoke
with-logs. In both cases a log-ns (e.g., "com.example.captured") must be specified in order to namespace the output.
The latest API documentation can be found at http://clojure.github.com/tools.logging
The following short example should give you what you need to get started:
(ns example.core (:use [clojure.tools.logging :only (info error)])) (defn divide [x y] (try (info "dividing" x "by" y) (/ x y) (catch Exception ex (error ex "There was an error in calculation"))))
For those new to using a java logging library, the following is a very basic configuration for log4j. Place it in a file called
log4j.properties and place that file (and the log4j JAR) on the classpath.
log4j.rootLogger=WARN, A1 log4j.logger.user=DEBUG log4j.appender.A1=org.apache.log4j.ConsoleAppender log4j.appender.A1.layout=org.apache.log4j.PatternLayout log4j.appender.A1.layout.ConversionPattern=%d %-5p %c: %m%n
The above will print messages to the console for
:debug or higher if one is in the
user namespace, and
:warn or higher in all other namespaces.
Logging is available in Maven central. Add it to your Maven project's
<dependency> <groupId>org.clojure</groupId> <artifactId>tools.logging</artifactId> <version>0.2.3</version> </dependency>
or your leiningen project.clj:
Please note the changelog below.
- Clone the repo
- Make sure you have maven installed
- Run the maven build; run either:
mvn install: This will produce a logging jar file in the
targetdirectory, and run all tests with the most recently-released build of Clojure.
- Chris Dean
- Phil Hagelberg
- Richard Newman
- Timothy Pratley
Copyright © 2009 Alex Taggart
Licensed under the EPL. (See the file epl.html.)