jlv

jlv copied to clipboard

"!https://api.travis-ci.org/rdiachenko/jlv.png!":http://travis-ci.org/rdiachenko/jlv

h3. Information

Java logging viewer is available as a plugin for Eclipse IDE.

h5. Supported logging systems:

• logback v1.x
• log4j v1.x
• log4j v2.x

h5. Main features:

• Receiving logs via socket
• Quick filtration
• Detailed information about selected log
• Preferences page for controlling and saving plugin state
• Preferences page for customizing log list representation

h5. Minimum requirements:

• Eclipse 4.6
• Java 1.8

h5. Breaking backward compatibility:

• Release 1.4.0: Jlv Eclipse plugin 1.4.0 uses plugin element ids which are different from those, used in 1.3.3 version, so old versions of Jlv Eclipse plugin should be removed before installing 1.4.0 ("#82":https://github.com/rdiachenko/jlv/issues/82).

h3. Eclipse update site

bc.. https://github.com/rdiachenko/jlv/raw/repo/eclipse

h3. Release notes

• "Past releases":https://github.com/rdiachenko/jlv/milestones?state=closed
• "Upcoming releases":https://github.com/rdiachenko/jlv/milestones?state=open

h3. Client logging system configuration

Jlv uses socket connection to receive logs from clients. Clients should configure their logging system properties file for successful interaction. Default port is 4445, but you may also change it in Jlv plugin preferences page.

h5. Logback minimum configuration (logback.xml)

bc.. <remoteHost>localhost</remoteHost> 4445 <includeCallerData>true</includeCallerData>

h5. Log4j1 minimum configuration (log4j.xml/log4j.properties)

bc..

<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/"> </log4j:configuration>

bc.. log4j.rootCategory=DEBUG, JLV log4j.appender.JLV=org.apache.log4j.net.SocketAppender log4j.appender.JLV.remoteHost=localhost log4j.appender.JLV.port=4445 log4j.appender.JLV.locationInfo=true

h5. Log4j2 minimum configuration (log4j2.xml)

bc.. <Configuration> <Appenders> <Socket name="JLV" host="localhost" port="4445"> <SerializedLayout /> </Socket> </Appenders> <Loggers> <Root level="DEBUG"> <AppenderRef ref="JLV" /> </Root> </Loggers> </Configuration>

h3. Screenshots

h5. Open Jlv view (Window > Show View > Other > Java Logging Viewer > Log list)

!https://raw.github.com/rdiachenko/JLV/gh-pages/jlv_screenshots/open_jlv_view.png!

h5. Main preferences page (Window > Preferences > Java Logging Viewer)

!https://raw.github.com/rdiachenko/JLV/gh-pages/jlv_screenshots/jlv_main_preferences.png!

h5. User Interface preferences page (Window > Preferences > Java Logging Viewer > User Interface)

!https://raw.github.com/rdiachenko/JLV/gh-pages/jlv_screenshots/jlv_ui_preferences.png!

h5. Log list view and log details

!https://raw.github.com/rdiachenko/JLV/gh-pages/jlv_screenshots/jlv_loglist_view.png!

h5. Log list view with filtering

!https://raw.github.com/rdiachenko/JLV/gh-pages/jlv_screenshots/jlv_loglist_with_filtering.png!

h3. How to contribute

• "Install and configure your Eclipse":https://github.com/rdiachenko/JLV/wiki/Eclipse-installation-and-configuration
• Read article about "development workflow with git":https://github.com/rdiachenko/JLV/wiki/Development-workflow-with-Git%3A-Fork%2C-Branching%2C-Commits-and-Pull-Request

h3. Contributors

"Ruslan Diachenko":https://github.com/rdiachenko