Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mrsarm/log4jwebtracker
Java web tool to setup at runtime the log level of Log4j appenders in an application, and read the log at runtime.
https://github.com/mrsarm/log4jwebtracker
java-library log4j logging
Last synced: 17 days ago
JSON representation
Java web tool to setup at runtime the log level of Log4j appenders in an application, and read the log at runtime.
- Host: GitHub
- URL: https://github.com/mrsarm/log4jwebtracker
- Owner: mrsarm
- Created: 2012-06-16T15:03:54.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2015-08-31T13:13:30.000Z (over 9 years ago)
- Last Synced: 2024-12-30T01:41:50.430Z (23 days ago)
- Topics: java-library, log4j, logging
- Language: Java
- Homepage:
- Size: 537 KB
- Stars: 39
- Watchers: 5
- Forks: 25
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Log4j Web Tracker
=================
**Log4j Web Tracker** is an _open source_ web tool to setup at runtime the
[Apache Log4j](http://logging.apache.org/log4j/) configuration loggers of an application.
It also has a tab that allows read the logs at runtime, or download them.
It's distributed in a small .jar file _(log4jwebtracker.jar)_, and it must be placed in the
`WEB-INF/lib` folder of the java web application.
To configure it, in the `WEB-INF/web.xml` file you have to add a mapping like this:
```xml
TrackerServlet
log4jwebtracker.servlet.TrackerServlet
TrackerServlet
/tracker/*
```
In the example the tool was mapped as `/tracker/*`, so if the application is accessible in
[http://localhost:8080/myapp](http://localhost:8080/myapp), the right URL to access the tracker is:
[http://localhost:8080/myapp/tracker](http://localhost:8080/myapp/tracker)
Introduction
------------
In the first tab you can setup the level of each logger of the application, including the `root` logger.
The configuration are applied at the moment, but not change the original configuration placed
in `log4j.properties`, `log4j.xml` or any configuration file, if you restart the application,
the original configuration will applied again.
In the second tab named _**Log**_, you can select an appender file and view the last content in the
webpage (the numbers of line are configurable), or download them.
Log4j configuration
-------------------
**Log4j** not need any special configuration for use this tool, you can use the usual way to
configure the logging. Many developers used a util class from **Spring** in the web context
to do this (`org.springframework.web.util.Log4jConfigListener`).
Also you can use the automatic setup (the configuration file must be placed on the
`WEB-INF/classes` folder), or the manually basic setup, invoking
`org.apache.log4j.PropertyConfigurator.configure(String configFilename)`.
**Log4jWebTracker** provides a servlet class to do that, but it's optional:
```xml
Log4jInitServlet
log4jwebtracker.servlet.init.Log4jInitServlet
log4jConfigLocation
WEB-INF/classes/log4j.xml
1
```
Requirements
------------
* Java 1.4+
* Servlet container 2.3+ (like Apache Tomcat 4.1 or higher, or WebSphere 5.0+, etc.)
Dependencies
------------
No dependencies with others libraries or frameworks, except of course **Log4j** _(tested only with v1.2)_.
Maven projects
--------------
If your project is building using **Apache Maven 2** or above, put this artifact in your `pom.xml`
to import the jar:
```xml
log4jwebtracker
log4jwebtracker
1.0.2
```
The repository necessary to get the artifact is:
```xml
log4jwebtracker-releases
http://repo.log4jwebtracker.com/maven2
```
TO DO
-----
* Securize access (_anyway, can be done with filters, web security using web.xml policies, or others options_).
* Configure appenders and patterns at runtime.
* Filter field with regular expressions to match the output of the log.
* _Send us your proposal..._
License
-------
The project is licensed under the terms of the
[GNU Lesser GPL General Public License version 3](http://www.gnu.org/licenses/lgpl-3.0.html) _(LGPLv3)_.
Binary and Source Code
----------------------
This source code is available in [Github](https://github.com/mrsarm/log4jwebtracker).
Also the source is available in .jar format
[here](http://repo.log4jwebtracker.com/maven2/log4jwebtracker/log4jwebtracker/1.0.2/log4jwebtracker-1.0.2-sources.jar).
The binary version in .jar format, ready to use for your project is
[here](http://repo.log4jwebtracker.com/maven2/log4jwebtracker/log4jwebtracker/1.0.2/log4jwebtracker-1.0.2.jar).
About
-----
**Author**: My name is **Mariano Ruiz**, I work as _Software & Web Developer_. I'm from Argentina.
**My Home**: http://www.mrdev.com.ar | **Email**: [[email protected]](mailto:[email protected])