tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From gl...@apache.org
Subject cvs commit: jakarta-tomcat-connectors/jk/xdocs/common tools.xml
Date Sun, 07 Sep 2003 03:33:24 GMT
glenn       2003/09/06 20:33:24

  Modified:    jk/xdocs menu.idx.in style.xsl.in
  Added:       jk/xdocs/common tools.xml
  Log:
  Add documentation for tools and reports
  
  Revision  Changes    Path
  1.4       +24 -23    jakarta-tomcat-connectors/jk/xdocs/menu.idx.in
  
  Index: menu.idx.in
  ===================================================================
  RCS file: /home/cvs/jakarta-tomcat-connectors/jk/xdocs/menu.idx.in,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- menu.idx.in	14 Mar 2003 00:12:10 -0000	1.3
  +++ menu.idx.in	7 Sep 2003 03:33:24 -0000	1.4
  @@ -1,23 +1,24 @@
  -<?xml version="1.0" encoding="ISO-8859-1"?>
  -
  -<!DOCTYPE index [
  -<!ENTITY JK SYSTEM  "menu.jk.idx">
  -<!ENTITY JK2 SYSTEM "menu.jk2.idx">
  -]>
  -
  -<index>
  -  <section name="Presentation">
  -  <document href="index.xml"/>
  -  </section>
  -  
  -  <section name="Commons">
  -  <document href="common/AJPv13.xml"/>
  -  <document href="common/AJPv13-extensions-proposal.xml"/>
  -  <document href="common/doccontrib.xml"/>
  -  <document href="faq.xml"/>
  -  </section>
  -  
  -@JK@
  -@JK2@
  -  
  -</index>
  +<?xml version="1.0" encoding="ISO-8859-1"?>
  +
  +<!DOCTYPE index [
  +<!ENTITY JK SYSTEM  "menu.jk.idx">
  +<!ENTITY JK2 SYSTEM "menu.jk2.idx">
  +]>
  +
  +<index>
  +  <section name="Presentation">
  +  <document href="index.xml"/>
  +  </section>
  +  
  +  <section name="Commons">
  +  <document href="common/AJPv13.xml"/>
  +  <document href="common/AJPv13-extensions-proposal.xml"/>
  +  <document href="common/doccontrib.xml"/>
  +  <document href="common/tools.xml"/>
  +  <document href="faq.xml"/>
  +  </section>
  +  
  +@JK@
  +@JK2@
  +  
  +</index>
  
  
  
  1.16      +1 -1      jakarta-tomcat-connectors/jk/xdocs/style.xsl.in
  
  Index: style.xsl.in
  ===================================================================
  RCS file: /home/cvs/jakarta-tomcat-connectors/jk/xdocs/style.xsl.in,v
  retrieving revision 1.15
  retrieving revision 1.16
  diff -u -r1.15 -r1.16
  --- style.xsl.in	6 Nov 2002 14:31:52 -0000	1.15
  +++ style.xsl.in	7 Sep 2003 03:33:24 -0000	1.16
  @@ -50,7 +50,7 @@
           <title>
             <xsl:value-of select="properties/title"/>
           </title>
  -        <meta name="copyright" content="1999-2002 The Apache Software Foundation"/>
  +        <meta name="copyright" content="1999-2003 The Apache Software Foundation"/>
           <xsl:for-each select="properties/date">
             <xsl:variable name="date">
               <xsl:value-of select="."/>
  
  
  
  1.1                  jakarta-tomcat-connectors/jk/xdocs/common/tools.xml
  
  Index: tools.xml
  ===================================================================
  <?xml version="1.0" encoding="UTF-8"?>
  <document>
  <properties>
  <title>Tools</title>
  <author>Glenn Nielsen</author>
  <date>$Date: 2003/09/07 03:33:24 $</date>
  </properties>
  <section name="Introduction">
  <p>Documentation for additional mod_jk related tools.</p>
  </section>
  
  <section name="Reports">
  <p>
  The mod_jk source distribution contains two perl scripts in the
  jk/tools/reports directory which can be used to analyze the mod_jk
  logs, save statistical data, and generate report graphs.
  </p>
  
  <p><code>tomcat_trend.pl log_dir archive_dir</code></p>
  <p>
  Script for analyzing mod_jk.log data when logging tomcat request data using
  the <code>JkRequestLogFormat</code> Apache mod_jk configuration.
  Generates statistics for request latency and errors.  Archives the generated
  data to files for later use in long term trend graphs and reports.
  </p>
  
  <p><code>tomcat_reports.pl archive_dir reports_dir</code></p>
  <p>
  Script for generating reports and graphs using statistical data generated
  by the <code>tomcat_trend.pl</code> script.
  
  The following graphs are created:
  <ul>
    <li>tomcat_request.png - Long term trend graph of total number of tomcat
      requests handled.</li>
    <li>tomcat_median.png - Long term overall trend graph of tomcat request
      latency median.</li>
    <li>tomcat_deviation.png - Long term overall trend graph of tomcat request
      mean and standard deviation.</li>
    <li>tomcat_error.png - Long term trend graph of requests rejected by tomcat.
      Shows requests rejected when tomcat has no request processors available.
      Can be an indicator that tomcat is overloaded or having other scaling
      problems.</li>
    <li>tomcat_client.png - Long term trend graph of requests forward to tomcat
      which were aborted by the remote client (browser).  You will normally see
      some aborted requests.  High numbers of these can be an indicator that
      tomcat is overloaded or there are requests which have very high latency.</li>
  </ul>
  </p>
  
  <p>
  A great deal of statistical data is generated but at this time
  only long term trend graphs are being created and no reports.
  This is only a start.  Many more graphs and reports could be
  generated from the data. Please consider contributing back any
  new reports or graphs you create.  Thanks.
  </p>
  
  <p>
  These perl scripts depend upon the following perl modules and libraries:
  <ul>
    <li>GD 1.8.x graphics library <a href="http://www.boutell.com/gd/">
      http://www.boutell.com/gd/</a></li>
    <li>GD 1.4.x perl module</li>
    <li>GD Graph perl module</li>
    <li>GD TextUtil perl module</li>
    <li>StatisticsDescriptive perl module</li>
  </ul>
  </p>
  </section>
  </document>
  
  
  

Mime
View raw message