rubbos/app/tomcat-connectors-1.2.32-src/docs/miscellaneous/reporttools.html

   1 <html><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>The Apache Tomcat Connector - Miscellaneous Documentation - Reporting Tools</title><meta name="author" value="Glenn Nielsen"><meta name="email" value=""><link href="../style.css" type="text/css" rel="stylesheet"></head><body bgcolor="#ffffff" text="#000000" link="#525D76" alink="#525D76" vlink="#525D76"><table border="0" width="100%" cellspacing="4"><!--PAGE HEADER--><tr><td colspan="2"><!--TOMCAT LOGO--><a href="http://tomcat.apache.org/"><img src="../images/tomcat.gif" align="left" alt="Apache Tomcat" border="0"></a><!--APACHE LOGO--><a href="http://www.apache.org/"><img src="http://www.apache.org/images/asf-logo.gif" align="right" alt="Apache Logo" border="0"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><tr><!--LEFT SIDE NAVIGATION--><td width="20%" valign="top" nowrap="true"><p><strong>Links</strong></p><ul><li><a href="../index.html">Docs Home</a></li></ul><p><strong>Reference Guide</strong></p><ul><li><a href="../reference/workers.html">workers.properties</a></li><li><a href="../reference/uriworkermap.html">uriworkermap.properties</a></li><li><a href="../reference/status.html">Status Worker</a></li><li><a href="../reference/apache.html">Apache HTTP Server</a></li><li><a href="../reference/iis.html">IIS</a></li></ul><p><strong>Generic HowTo</strong></p><ul><li><a href="../generic_howto/quick.html">For the impatient</a></li><li><a href="../generic_howto/workers.html">All about workers</a></li><li><a href="../generic_howto/timeouts.html">Timeouts</a></li><li><a href="../generic_howto/loadbalancers.html">Load Balancing</a></li><li><a href="../generic_howto/proxy.html">Reverse Proxy</a></li></ul><p><strong>Webserver HowTo</strong></p><ul><li><a href="../webserver_howto/apache.html">Apache HTTP Server</a></li><li><a href="../webserver_howto/iis.html">IIS</a></li><li><a href="../webserver_howto/nes.html">Netscape/SunOne/Sun</a></li></ul><p><strong>AJP Protocol Reference</strong></p><ul><li><a href="../ajp/ajpv13a.html">AJPv13</a></li><li><a href="../ajp/ajpv13ext.html">AJPv13 Extension Proposal</a></li></ul><p><strong>Miscellaneous Documentation</strong></p><ul><li><a href="../miscellaneous/faq.html">Frequently asked questions</a></li><li><a href="../miscellaneous/changelog.html">Changelog</a></li><li><a href="http://issues.apache.org/bugzilla/buglist.cgi?query_format=advanced&amp;short_desc_type=allwordssubstr&amp;short_desc=&amp;product=Tomcat+Connectors&amp;long_desc_type=substring&amp;long_desc=&amp;bug_file_loc_type=allwordssubstr&amp;bug_file_loc=&amp;keywords_type=allwords&amp;keywords=&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;emailassigned_to1=1&amp;emailtype1=substring&amp;email1=&amp;emailassigned_to2=1&amp;emailreporter2=1&amp;emailcc2=1&amp;emailtype2=substring&amp;email2=&amp;bugidtype=include&amp;bug_id=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;cmdtype=doit&amp;order=Reuse+same+sort+as+last+time&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=">Current Tomcat Connectors bugs</a></li><li><a href="../miscellaneous/doccontrib.html">Contribute documentation</a></li><li><a href="../miscellaneous/jkstatustasks.html">JK Status Ant Tasks</a></li><li><a href="../miscellaneous/reporttools.html">Reporting Tools</a></li><li><a href="http://tomcat.apache.org/connectors-doc-archive/jk2/index.html">Old JK/JK2 documentation</a></li></ul><p><strong>News</strong></p><ul><li><a href="../news/20110701.html">2011</a></li><li><a href="../news/20100101.html">2010</a></li><li><a href="../news/20090301.html">2009</a></li><li><a href="../news/20081001.html">2008</a></li><li><a href="../news/20070301.html">2007</a></li><li><a href="../news/20060101.html">2006</a></li><li><a href="../news/20050101.html">2005</a></li><li><a href="../news/20041100.html">2004</a></li></ul></td><!--RIGHT SIDE MAIN BODY--><td width="80%" valign="top" align="left"><table border="0" width="100%" cellspacing="4"><tr><td align="left" valign="top"><h1>The Apache Tomcat Connector - Miscellaneous Documentation</h1><h2>Reporting Tools</h2></td><td align="right" valign="top" nowrap="true"><small><a href="printer/reporttools.html"><img src="../images/printer.gif" border="0" alt="Printer Friendly Version"><br>print-friendly<br>version
   2                     </a></small></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Reporting Tools"><strong>Reporting Tools</strong></a></font></td></tr><tr><td><blockquote>
   3 <p>
   4 The mod_jk source distribution contains two perl scripts in the
   5 tools/reports directory which can be used to analyze the mod_jk
   6 logs, save statistical data, and generate report graphs.
   7 </p>
   8
   9 <p><b class="code">tomcat_trend.pl log_dir archive_dir</b></p>
  10 <p>
  11 Script for analyzing mod_jk.log data when logging tomcat request data using
  12 the <b class="code">JkRequestLogFormat</b> Apache mod_jk configuration.
  13 Generates statistics for request latency and errors.  Archives the generated
  14 data to files for later use in long term trend graphs and reports.
  15 </p>
  16
  17 <p><b class="code">tomcat_reports.pl archive_dir reports_dir</b></p>
  18 <p>
  19 Script for generating reports and graphs using statistical data generated
  20 by the <b class="code">tomcat_trend.pl</b> script.
  21
  22 The following graphs are created:
  23 <ul>
  24   <li>tomcat_request.png - Long term trend graph of total number of tomcat
  25     requests handled.</li>
  26   <li>tomcat_median.png - Long term overall trend graph of tomcat request
  27     latency median.</li>
  28   <li>tomcat_deviation.png - Long term overall trend graph of tomcat request
  29     mean and standard deviation.</li>
  30   <li>tomcat_error.png - Long term trend graph of requests rejected by tomcat.
  31     Shows requests rejected when tomcat has no request processors available.
  32     Can be an indicator that tomcat is overloaded or having other scaling
  33     problems.</li>
  34   <li>tomcat_client.png - Long term trend graph of requests forward to tomcat
  35     which were aborted by the remote client (browser).  You will normally see
  36     some aborted requests.  High numbers of these can be an indicator that
  37     tomcat is overloaded or there are requests which have very high latency.</li>
  38 </ul>
  39 </p>
  40
  41 <p>
  42 A great deal of statistical data is generated but at this time
  43 only long term trend graphs are being created and no reports.
  44 This is only a start.  Many more graphs and reports could be
  45 generated from the data. Please consider contributing back any
  46 new reports or graphs you create.  Thanks.
  47 </p>
  48
  49 <p>
  50 These perl scripts depend upon the following perl modules and libraries:
  51 <ul>
  52   <li>GD 1.8.x graphics library <a href="http://www.boutell.com/gd/">
  53     http://www.boutell.com/gd/</a></li>
  54   <li>GD 1.4.x perl module</li>
  55   <li>GD Graph perl module</li>
  56   <li>GD TextUtil perl module</li>
  57   <li>StatisticsDescriptive perl module</li>
  58 </ul>
  59 </p>
  60 </blockquote></td></tr></table></td></tr><!--FOOTER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><!--PAGE FOOTER--><tr><td colspan="2"><div align="center"><font color="#525D76" size="-1"><em>
  61         Copyright &copy; 1999-2011, Apache Software Foundation
  62         </em></font></div></td></tr></table></body></html>