Portal日志开发

1.       开发环境

日志分析工具：awstats

Awstats运行环境：tomcat5.5   Active Perl

2.       安装和配置tomcat5.5 和Active Perl

    配置Active Perl的环境变量：%perl_home%/bin

3.  将awstats部署成tomcat5.5的一个应用

在webapp下建立一个awstats的应用，里面含有WEB-INF的那种，即webapp下建立一个目录，名称为awstats,在awstats下建立一个WEB-INF的目录，目录里含有一个web.xml文件，内容如下

<?xml version="1.0" encoding="UTF-8"?>

<web-app xmlns="http://java.sun.com/xml/ns/j2ee"

  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

  xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"

  version="2.4">

  <servlet>

      <servlet-name>cgi</servlet-name>

      <servlet-class>org.apache.catalina.servlets.CGIServlet</servlet-class>

      <init-param>

        <param-name>clientInputTimeout</param-name>

        <param-value>100</param-value>

      </init-param>

      <init-param>

        <param-name>debug</param-name>

        <param-value>6</param-value>

      </init-param>

      <init-param>

        <param-name>cgiPathPrefix</param-name>

        <param-value>WEB-INF/cgi-bin</param-value>

      </init-param>

       <load-on-startup>5</load-on-startup>

  </servlet>

  <servlet-mapping>

      <servlet-name>cgi</servlet-name>

      <url-pattern>/cgi-bin/*</url-pattern>

  </servlet-mapping>

 

  <session-config>

    <session-timeout>

      30

    </session-timeout>

  </session-config>

  <welcome-file-list>

    <welcome-file>

      index.jsp

    </welcome-file>

    <welcome-file>

      index.html

    </welcome-file>

    <welcome-file>

      index.htm

    </welcome-file>

  </welcome-file-list>

</web-app>

5.       将tomcat的server/lib目录下的servlets-cgi.renametojar文件改名为servlets-cgi.jar

6.       在下载的awstats包里的docs、tools、wwwroot下的classes、js、css、icon等目录（除了cgi-bin目录）下的内容拷贝到tomcat下的awstats目录下，将cgi-bin目录下的内容拷贝到WEB-INF目录下

7.       在cgi-bin目录下找到awstats.model.conf文件，将其复制为（例awstats.chenjie.conf）修改其中内容如下：

Include "awstats.model.conf"

LogFile="D:/IBM/WebSphere/PortalServer/log/sa.log"

SiteDomain="XXXX银行综合信息管理平台"

DirCgi="/cgi-bin"

DirIcons="/awstats/icon"

DirData="data"

8.       为日志分析记录配置 WebSphere Portal

WebSphere Portal 记录以下用户活动，并使它们可用于分析：

• 页面管理（创建、读取、更新、删除页面）
• 用户对某个页面的请求（包括所包含的 Portlet）
• 会话活动（登录、注销、超时、登录失败）
• 用户管理操作（创建、读取、更新、删除用户和组）。

WebSphere Portal 通过将事件写到专用日志来提供分析日志记录，类似于用于分析交付静态页面的服务器的日志记录机制。门户分析文件名为 sa.log（sa 表示“站点分析”），通常位于 $WP_HOME/log/ 目录中。

Sa.log 中的每一行都表示一个特定的事件，由针对该门户的请求所激发。单个请求（例如，针对某个页面）可能导致向 sa.log 写入多行内容。您可以通过配置相应的日志记录器来自定义日志记录的类型和数量。

WebSphere Portal 定义了下列站点分析日志记录器：

日志记录器

用途

SiteAnalyzerSessionLogger

记录会话事件，如登录或注销

SiteAnalyzerUserManagementLogger

记录用户和组管理事件，如创建或删除用户和组

SiteAnalyzerPageLogger

记录页面呈现事件

SiteAnalyzerPortletLogger

记录 Portlet 呈现事件

SiteAnalyzerPortletActionLogger

记录 Portlet 中发生的操作

SiteAnalyzerApplicationActionLogger

记录 Portlet 应用程序中发生的操作

SiteAnalyzerErrorLogger

记录任何错误

对于用户与门户的每次交互，相应的日志记录器（如果配置了的话）都会在站点分析日志文件中创建一个新条目。对于每个活动，日志记录的一般格式遵循上面描述的定义。区别在于请求 URI，其中记录了每个活动的特定数据。

要为站点分析记录配置 WebSphere Portal，请设置门户网站配置属性中所述SiteAnalyzerLogService 中的参数。SiteAnalyzerLogService服务的描述位于portal_server_root/ config/properties文件夹中的SiteAnalyzerLogService.properties中，在SiteAnalyzerLogService.properties文件中按照上表开启相应的日志记录器。

运行portal_server_root/config /WPSconfig.bat update-properties以激活属性的新值。

重启Portal服务器之后，在portal_server_root/log中将新增一个sa.log，这个文件记录的就是Portal服务器的日志。对portal站点的日志分析正是基于这个日志文件的。

9.     将portal日志更新成awstats可读的数据信息

运行perl awstats.pl -config=Portal –update即可。可以将这条命令制作成批处理文件，定制成服务定时运行批处理文件，从而实现系统定时自动更新portal日志。

10. http://127.0.0.1:8080/awstats/cgi-bin/awstats.pl?config=Portal运行效果如下图：