1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
|
<html><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>Tomcat Connector - Tools</title><meta value="Glenn Nielsen" name="author"><meta value="" name="email"><link rel="stylesheet" type="text/css" href="../style.css"></head><body vlink="#525D76" alink="#525D76" link="#525D76" text="#000000" bgcolor="#ffffff"><table cellspacing="4" width="100%" border="0"><!--PAGE HEADER--><tr><td colspan="2"><!--TOMCAT LOGO--><a href="http://tomcat.apache.org/"><img border="0" alt="Apache Tomcat" align="left" src="../images/tomcat.gif"></a><!--APACHE LOGO--><a href="http://www.apache.org/"><img border="0" alt="Apache Logo" align="right" src="http://www.apache.org/images/asf-logo.gif"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr size="1" noshade="noshade"></td></tr><tr><!--LEFT SIDE NAVIGATION--><td nowrap="true" valign="top" width="20%"><p><strong>Links</strong></p><ul><li><a href="../index.html">Docs Home</a></li></ul><p><strong>AJP Protocol</strong></p><ul><li><a href="ajpv13a.html">AJPv13</a></li><li><a href="ajpv13ext.html">AJPv13 extension Proposal</a></li></ul></td><!--RIGHT SIDE MAIN BODY--><td align="left" valign="top" width="80%"><table cellspacing="4" width="100%" border="0"><tr><td valign="top" align="left"><h1>Tomcat Connector</h1><h2>Tools</h2></td><td nowrap="true" valign="top" align="right"><small><a href="printer/tools.html"><img alt="Printer Friendly Version" border="0" src="../images/printer.gif"><br>print-friendly<br>version
</a></small></td></tr></table><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Introduction"><strong>Introduction</strong></a></font></td></tr><tr><td><blockquote>
<p>Documentation for additional mod_jk related tools.</p>
</blockquote></td></tr></table><table width="100%" cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Reports"><strong>Reports</strong></a></font></td></tr><tr><td><blockquote>
<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><b class="code">tomcat_trend.pl log_dir archive_dir</b></p>
<p>
Script for analyzing mod_jk.log data when logging tomcat request data using
the <b class="code">JkRequestLogFormat</b> 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><b class="code">tomcat_reports.pl archive_dir reports_dir</b></p>
<p>
Script for generating reports and graphs using statistical data generated
by the <b class="code">tomcat_trend.pl</b> 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>
</blockquote></td></tr></table></td></tr><!--FOOTER SEPARATOR--><tr><td colspan="2"><hr size="1" noshade="noshade"></td></tr><!--PAGE FOOTER--><tr><td colspan="2"><div align="center"><font size="-1" color="#525D76"><em>
Copyright © 1999-2005, Apache Software Foundation
</em></font></div></td></tr></table></body></html>
|
