morciuch 2002/08/27 13:17:05
Modified: docs/site changes.html todo.html config_guide.html
Log:
Documentation for PortletStatsService (see Bugzilla issue 11737)
Revision Changes Path
1.46 +9 -0 jakarta-jetspeed/docs/site/changes.html
Index: changes.html
===================================================================
RCS file: /home/cvs/jakarta-jetspeed/docs/site/changes.html,v
retrieving revision 1.45
retrieving revision 1.46
diff -u -r1.45 -r1.46
--- changes.html 26 Aug 2002 01:59:18 -0000 1.45
+++ changes.html 27 Aug 2002 20:17:05 -0000 1.46
@@ -130,10 +130,19 @@
-->
</ul>
<li>
+ Add - Bug # 11737 - 2002/08/27 - Implemented PortletStatsService, disabled by
default (MO)
+</li>
+ <li>
Fix - 2002/08/25 - Updated Ant to 1.5 (PS)
</li>
<li>
Fix - 2002/08/25 - Implemented allow-if-owner element for in RegistrySecurity and
enable "owner" in the authentication methods (PS)
+</li>
+ <li>
+ Add - Bug # 11599 - 2002/08/23 - Added import/export feature in PSML Browser (MO)
+</li>
+ <li>
+ Add - Bug # 11697 - 2002/08/20 - Implemented portlet parameter presentation
styles (MO)
</li>
<li>
Add - 2002/08/13 - Bug fixes: enhancement to customizing portlet title allowing
for multiple instances of same portlet on a page with different titles
1.36 +2 -2 jakarta-jetspeed/docs/site/todo.html
Index: todo.html
===================================================================
RCS file: /home/cvs/jakarta-jetspeed/docs/site/todo.html,v
retrieving revision 1.35
retrieving revision 1.36
diff -u -r1.35 -r1.36
--- todo.html 26 Aug 2002 01:59:18 -0000 1.35
+++ todo.html 27 Aug 2002 20:17:05 -0000 1.36
@@ -414,7 +414,7 @@
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan=""
valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
- Customizer parameter presentation styles
+ Customizer parameter presentation styles. <strong>Done</strong>
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan=""
valign="top" align="left">
@@ -465,7 +465,7 @@
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan=""
valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
- Portlet Usage Logging
+ Portlet Usage Logging. <strong>Done</strong>
</font>
</td>
<td bgcolor="#a0ddf0" colspan="" rowspan=""
valign="top" align="left">
1.16 +120 -1 jakarta-jetspeed/docs/site/config_guide.html
Index: config_guide.html
===================================================================
RCS file: /home/cvs/jakarta-jetspeed/docs/site/config_guide.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- config_guide.html 2 Aug 2002 10:57:28 -0000 1.15
+++ config_guide.html 27 Aug 2002 20:17:05 -0000 1.16
@@ -891,6 +891,99 @@
<table border="0"
cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Portlet usage logger"><strong>Portlet usage logger</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p>
+ This facility is useful to generate web server like access log which
+ captures access to individual portlets (since this cannot be accomplished
+ via regular web server logging). See javadoc for
<code>org.apache.jetspeed.services.JetspeedPortletStatsService</code>
+ for more information about the internals of this service. The following
are service properties as
+ defined in JetspeedResources.properties:
+ </p>
+ <table>
+ <tr>
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Property
+ </font>
+</td>
+ <td bgcolor="#039acc" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Description
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ services.PortletStats.classname =
org.apache.jetspeed.services.portletstats.JetspeedPortletStatsService
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Simple implementation using Apache Common Log Format (CLF)
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ services.PortletStats.logger = access
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Name of the log4j logger
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ services.PortletStats.enabled = false
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ This service is disabled by default
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ services.PortletStats.excludePortlets =
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Portlets to exclude from logging (not yet implemented)
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ services.PortletStats.dateFormat = dd/MMM/yyyy:hh:mm:ss z
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Date format to use in the log entry
+ </font>
+</td>
+ </tr>
+ </table>
+ </blockquote>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0"
cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#828DA6">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Example configuration"><strong>Example configuration</strong></a>
</font>
</td></tr>
@@ -921,7 +1014,7 @@
#
# destination.file: A path relative to the web app root
# -------------------------------------------------------------------
-services.LoggingService.facilities=rotation,system,debug
+services.LoggingService.facilities=rotation,system,debug,logforj,access
services.LoggingService.default=rotation
services.LoggingService.loggingConfig=org.apache.turbine.services.logging.PropertiesLoggingConfig
@@ -955,6 +1048,32 @@
services.LoggingService.security.destination.file=/WEB-INF/log/jetspeed.log
services.LoggingService.security.className=org.apache.turbine.services.logging.Log4JavaLogger
services.LoggingService.security.level=DEBUG
+
+# An example configuration for using Log4Java, with log4j properties inline
+# The category name - at the end of this line - needs to match the logging facility
name - the first log4j.
+# need this rootCategory entry to capture the torque/fulcrum etc logging
+services.LoggingService.logforj.log4j.rootCategory = INFO, logforj, access
+
+# need this category entry for the actual jetspeed logging (I don't know why it
doesn't get covered by the root category!)
+services.LoggingService.logforj.log4j.category.logforj = DEBUG, logforj
+
+services.LoggingService.logforj.log4j.appender.logforj.file
=${webappRoot}/WEB-INF/log/jetspeed.log
+services.LoggingService.logforj.log4j.appender.logforj =
org.apache.log4j.FileAppender
+services.LoggingService.logforj.log4j.appender.logforj.layout =
org.apache.log4j.PatternLayout
+services.LoggingService.logforj.log4j.appender.logforj.layout.conversionPattern =
[%d{dd MMM yyyy HH:mm:ss} %5p] - %m%n
+services.LoggingService.logforj.log4j.appender.logforj.append = false
+services.LoggingService.logforj.className=org.apache.turbine.services.logging.Log4JavaLogger
+services.LoggingService.logforj.level=DEBUG
+
+# An example configuration for portlet access audit logging
+services.LoggingService.access.log4j.category.access = INFO, access
+services.LoggingService.access.log4j.appender.access.file =
${webappRoot}/WEB-INF/log/access.log
+services.LoggingService.access.log4j.appender.access = org.apache.log4j.FileAppender
+services.LoggingService.access.log4j.appender.access.layout =
org.apache.log4j.PatternLayout
+services.LoggingService.access.log4j.appender.access.layout.ConversionPattern = %m%n
+services.LoggingService.access.log4j.appender.access.append = true
+services.LoggingService.access.className =
org.apache.turbine.services.logging.Log4JavaLogger
+services.LoggingService.access.level = INFO
# An example configuration for automatic log rotation using Log4Java
# This will keep the log file size under 1MB and save up to 5 backup copies
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
