mod_jkソース配布物には、tools/reportsディレクトリに2つのPerlスクリプトが含まれており、これらを使用してmod_jkログを解析し、統計データを保存し、レポートグラフを生成できます。
tomcat_trend.pl log_dir archive_dir
JkRequestLogFormat Apache mod_jk設定を使用してTomcatリクエストデータをログに記録する際に、mod_jk.logデータを解析するためのスクリプトです。リクエストのレイテンシとエラーの統計を生成します。生成されたデータは、長期トレンドグラフやレポートで後で使用するためにファイルにアーカイブされます。
tomcat_reports.pl archive_dir reports_dir
tomcat_trend.plスクリプトによって生成された統計データを使用して、レポートとグラフを生成するためのスクリプトです。以下のグラフが作成されます。
- tomcat_request.png - 処理されたTomcatリクエスト総数の長期トレンドグラフ。
- tomcat_median.png - Tomcatリクエストのレイテンシ中央値の全体的な長期トレンドグラフ。
- tomcat_deviation.png - Tomcatリクエストの平均と標準偏差の全体的な長期トレンドグラフ。
- tomcat_error.png - Tomcatによって拒否されたリクエストの長期トレンドグラフ。Tomcatに利用可能なリクエストプロセッサがない場合に拒否されたリクエストを示します。これは、Tomcatが過負荷になっているか、他のスケーリング問題があることを示す指標となる可能性があります。
- tomcat_client.png - リモートクライアント（ブラウザ）によって中断された、Tomcatに転送されたリクエストの長期トレンドグラフ。通常、いくつかの中断されたリクエストが見られます。これらが多数発生する場合、Tomcatが過負荷になっているか、非常に高いレイテンシを持つリクエストがあることを示す指標となる可能性があります。
多くの統計データが生成されますが、現時点では長期トレンドグラフのみが作成されており、レポートはありません。これはまだ始まりに過ぎません。データからさらに多くのグラフやレポートを生成できます。新しいレポートやグラフを作成された場合は、ぜひ貢献をご検討ください。ありがとうございます。
これらのPerlスクリプトは以下のPerlモジュールとライブラリに依存しています
- GD 1.8.x グラフィックスライブラリ http://www.boutell.com/gd/
- GD 1.4.x Perlモジュール
- GD Graph Perlモジュール
- GD TextUtil Perlモジュール
- StatisticsDescriptive Perlモジュール