jmx-logger

JmxLogger makes it easy to do realtime application log monitoring. The JmxLogger API provides both Java Util Logging Handler and a Log4J Appender classes for integration with your choice of logging technologies that you feel confortable with. You simply configure your logging framework, as you would normally do, and the JmxLogger automatically capture and braodcasts your event logs to any registered JMX client. It provides a built-in log console to monitor your log locally or remotely (no more tail -f server.log).

Features

Easy integration with your favorite logging framework
Support for Java Util Logging API
Support for the Log4J logging API
No additional API coding required, configure your logging framework and that's it
Leverages JMX client/agent infrastructure for logging/monitoring
Support one or more logger running within same VM
Design for performance / scalability
- dedicated log worker threads
- logged messages are quickly dispatched to dedicated work queue
- all log filtering occur on dedicated threads
Specify and control the your log levels
Set log filter at agent-side to save network chatter
Expression language support for complex event filtering
Set log filter expression using
- log event parameters (level, message, logger name, etc)
- log event statistics (log count, logger count, etc)
- system status (avail memory, runtime, thread count, etc)
Multi-function JmxLogger GUI console to view logs
Say bye to "tail -f server.log": monitor application log locally/remotely
- ability to connect, pause, resume JmxLoger connection
- control JmxLogger? log settings remotely
- change/update log levels directly from console
- change/update log filter expression
- color-coded log mesage based on level for readability
- consolidated message console for ease of use
- support secure/non-secure connection using JMX security settings
Usage of JmxLogger is transparent to the developer.
- in your code, send your log events using your logging framework
- the JmxLogger (appender or handler class) then delegates propagation of your log events as JMX notifications using the JMX API.

Getting Started

Download the binary distribution zip
Add jmxlogger-log4j-.x.x.x.jar (and log4j jar) to your classpath if you plan to use log4j for logging.
Add jmxlogger-x.x.x.jar to classpath if you are using Java Logging Util.
Add mvel2-x.x.x.jar to your classpath as well.
Configure your application to use your favorite logging framework and run your application
Start JmxLogger console (or JConsole) to monitor log via JMX

Configure JmxLogger for Java Util Logging

If you are a user of the Java util Logging API, you should already be familiar with how to configure (declaratively or programmatically) the framwork for logging. The JmxLogger? handler is configured like any other Java Logging handler:

handlers=jmxlogger.integration.logutil.JmxLogHandler, java.util.logging.ConsoleHandler

# Default global logging level.
.level=INFO

# jmx log handler
jmxlogger.Handler.level=INFO
jmxlogger.Handler.objectName=jmxlogger:type=LogEmitter

# Console log handler
java.util.logging.ConsoleHandler.level = INFO
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
jmxlogger.Handler.objectName=jmxlogger:type=LogEmitter

The handler supports several attributes that are not provided and are automatically assigned a default value. In this configuration, we are declaring a JmxLogger with Level set to INFO The SimpleFormatter class will be used to format logs JMX ObjectName for remote monitoring is set to jmxlogger:type=LogEmitter.

Example Code

import java.util.logging.Level;
import java.util.logging.LogManager;
import java.util.logging.Logger;

public class SomeClassA {
    private static final Logger logger = Logger.getLogger(SomeClassA.class.getName());
    public static void main(String[] args) {
        logger.log(Level.INFO, "I am happy!");
        logger.log(Level.WARNING, "I am concerned...");
        logger.log(Level.SEVERE, "I am in trouble, something went wrong.");
        logger.log(Level.FINE, "I am up, I am down, I am all around!");
    }
}

Configure JmxLogger for Log4J

JmxLogger also supports the Log4J logging framework. If you are a user of the Log4J framework, you should already be familiar with the configuration steps for Log4J appenders. The JmxLogger appender is configured as shown below:

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">

<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
  <appender name="console" class="org.apache.log4j.ConsoleAppender">
    <param name="Target" value="System.out"/>
    <layout class="org.apache.log4j.PatternLayout">
      <param name="ConversionPattern" value="%-5p %c{1} - %m%n"/>
    </layout>
  </appender>

  <appender name="jmxlogger" class="jmxlogger.integration.log4j.JmxLogAppender">
    <param name="Threshold" value="INFO"/>
    <param name="ObjectName" value="jmxlogger:type=LogEmitter"/>
    <layout class="org.apache.log4j.PatternLayout">
      <param name="ConversionPattern" value="%-5p %c{1} - %m%n"/>
    </layout>
  </appender>

  <root>
    <priority value ="DEBUG" />
    <appender-ref ref="console" />
    <appender-ref ref="jmxlogger" />
  </root>

</log4j:configuration>

Code Example

import org.apache.log4j.Level;
import org.apache.log4j.Logger;
public class SomeClassB {
    private static Logger logger = Logger.getLogger(SomeClassB.class);
    public static void main (String[] args) {
        logger.log(Level.INFO, "I am happy!");
        logger.log(Level.WARN, "I am concerned...");
        logger.log(Level.ERROR, "I am in trouble, something went wrong.");
        logger.log(Level.DEBUG, "I am up, I am down, I am all around!");
    }
}

Running the Code

You must provide several system properties to start your process with JMX remote connectivity & security enabled. For this example, we are only going to enable the remote port and turn off security

java -cp your:class:path \
    -Dcom.sun.management.jmxremote \
    -Dcom.sun.management.jmxremote.port=7070 \
    -Dcom.sun.management.jmxremote.authenticate=false
your.process.main.Class

When you start the process, it will setup JMX with remote connectivity. This will enable you to connect and see your log using the JmxLogger console (see below).

Viewing Logs in JmxLoggerConsole and JConsole

Once you have started your process, you can view the log in realtime by connecting to the JmxLogger agent started by the logging framework. To start JmxLogger, do

java -cp mvel2-mvel2-2.0.14.jar:jmxlogger-0.3.0.jar jmxlogger.tools.console.Main This will start the console:

JmxLogger exposes several parameters which can be used in filter expressions at runtime.

Using JConsole, you can see these events as they are logged as well.

JConsole

Since JmxLogger is based on the JMX standard Java API, all logs can also be viewed using JConsole:

vladimirvivien / jmx-logger

readme