liferay-log-viewer-portlet
This project provides a portlet that attaches to the Liferay Portal's log4j mechanism to provide a log view within the browser.
- Liferay Portal 6.1 CE GA2, GA3 (6.1.1+)
- Liferay Portal 6.1 EE GA2, GA3 (6.1.20+)
- Liferay Portal 6.2 CE GA1 (6.2.0+)
- Liferay Portal 6.2 EE GA1 (6.2.10+)
The latest releases are available from SourceForge.
You can also download or install the portlet from Liferay Marketplace
Administrators will see a "Log Viewer" portlet in the Server area of the Control Panel in 6.1. In 6.2, it is present in the Apps section of the Control Panel Other users can also be assigned permissions to see the Log Viewer Portlet.
The portlet polls the log buffer every 2 seconds to update the page with the latest logs. You can also attach or detach the logger from the portal log4j. (when detached, the portlet does not cause any overhead on portal operations).
Two portal properties can be set:
- permeance.log.viewer.autoattach to toggle whether the logger attaches automatically on startup, default "true".
- permeance.log.viewer.pattern to configure the log4j pattern, default "%d{ABSOLUTE} %-5p [%c{1}:%L] %m%n"
This plugin comes with the PACL Security Manager disabled. However the list of PACL requirements to run this plugin in secure mode is available (commented out) in WEB-INF/liferay-plugin-package.properties. You can uncomment those entries to run the plugin in PACL secure mode.
Step 1. Checkout source from GitHub project
% git clone https://github.com/permeance/liferay-log-viewer
Step 2. Build and package
% mvn -U clean package
This will build "liferay-log-viewer-portlet-XXXX.war" in the targets tolder.
NOTE: You will require JDK 1.6+ and Maven 3.
eg.
Deploy "liferay-log-viewer-portlet-XXXX.war" to "LIFERAY_HOME/deploy" folder.
Liferay Log Viewer is available under GNU Public License version 3.0 (GPLv3). A copy of the license is attached in the code package.
- Chun Ho - chun.ho@permeance.com.au
