パフォーマンスバケットの使用

パフォーマンスバケットを使用すると、バケットを定義し、それらのバケットをさまざまなサーバー関数にリンクできます。これらの関数のいずれかを呼び出すごとに、サーバーは統計データを収集し、それをバケットに追加します。たとえば、send-cgi と service-j2ee はそれぞれ、CGI と Java サーブレットの要求にサービスを提供するために使用される関数です。2 つのバケットを定義して CGI とサーブレットの要求に対して別々のカウンタを保持するか、または両方のタイプの動的コンテンツに対する要求をカウントするバケットを 1 つ作成することができます。この情報を収集するためにかかる負担は最小限で済み、サーバーパフォーマンスへの影響も通常はわずかです。この情報へはあとで perfdump ユーティリティーを使用してアクセスできます。バケット内には、次の情報が格納されます。

• バケットの名前: この名前によって、バケットが関数に関連付けられます。

• 説明: このバケットが関連付けられている関数の説明。

• この関数に対する要求の数: この関数の呼び出しを引き起こした要求の総数。

• 関数が呼び出された回数: 1 つの要求に対して複数回実行される関数もあるため、この回数は、関数に対する要求の数とは一致しない可能性があります。

• 関数の待ち時間またはディスパッチ時間: サーバーが関数を呼び出すためにかかった時間。

• 関数の時間: 関数自体で費やされた時間。

  default-bucket は、サーバーで事前に定義されています。。ここには、ユーザーが定義したどのバケットにも関連付けられていない関数の統計情報が記録されます。

構成

パフォーマンスバケットのすべての設定情報を、magnus.conf および obj.conf ファイルに指定してください。自動的に有効になるのは、default-bucket だけです。

最初に、パフォーマンス統計の収集と perfdump を有効にする必要があります。

次の例は、magnus.conf で新しいバケットを定義する方法を示しています。

Init fn="define-perf-bucket" name="acl-bucket" description="ACL bucket"

Init fn="define-perf-bucket" name="file-bucket" description="Non-cached responses"

Init fn="define-perf-bucket" name="cgi-bucket" description="CGI Stats"

前述の例では、次の 3 つのバケットを作成しています。acl-bucket、file-bucket、および cgi-bucket。これらのバケットを関数に関連付けるには、パフォーマンスを測定する obj.conf 関数に bucket=bucket-name を追加します。

例

PathCheck fn="check-acl" acl="default" bucket="acl-bucket"
...
Service method="(GET|HEAD|POST)" type="*~magnus-internal/*" 
fn="send-file" bucket="file-bucket"
...
<Object name="cgi">
ObjectType fn="force-type" type="magnus-internal/cgi"
Service fn="send-cgi" bucket="cgi-bucket"
</Object>

詳細については、『Sun Java System Web Server 7.0 Administrator’s Configuration File Reference』の「The bucket Parameter」を参照してください。

パフォーマンスレポート

バケットのサーバー統計情報には、perfdump ユーティリティーを使用してアクセスできます。パフォーマンスバケット情報は、perfdump によって返されるレポートの最後のセクションに配置されています。

レポートには次の情報が含まれています。

• 平均 (Average)、合計 (Total)、パーセント (Percent) の各列には、要求された各統計情報のデータが表示されます。

• 要求処理時間 (Request Processing Time) はサーバーがそれまでに受信したすべての要求を処理するために要した合計時間です。

• 要求数 (Number of Requests) は関数の要求の合計数です。

• 呼び出し数 (Number of Invocations) は、関数が呼び出された合計回数です。1 つの要求の処理中に、関数が何度も呼び出される場合があるため、呼び出された回数は要求の数とは異なります。この行のパーセント列は、すべてのバケットの呼び出し回数の合計に基づいて計算されます。

• 遅延 (Latency) は Web Server が関数の呼び出しに要した時間 (秒) です。

• 関数処理時間 (Function Processing Time) は Web Server が関数の処理に費やした時間 (秒) です。Function Processing Time と Total Response Time のパーセンテージは、Request Processing Time の合計に基づいて計算されます。

• 合計応答時間 (Total Response Time) は Function Processing Time と Latency の合計 (秒) です。

perfdump で表示可能なパフォーマンスバケット情報の例を次に示します。

Performance Counters:
------------------------------------------------
                           Average         Total      Percent

Total number of requests:               62647125
Request processing time:    0.0343  2147687.2500

default-bucket (Default bucket)
Number of Requests:                     62647125    (100.00%)
Number of Invocations:                3374170785    (100.00%)
Latency:                    0.0008    47998.2500    (  2.23%)
Function Processing Time:   0.0335  2099689.0000    ( 97.77%)
Total Response Time:        0.0343  2147687.2500    (100.00%)