トランザクション
トランザクションとは、ユーザーのブラウザーからのリクエストを処理するためのサーバーサイドのLogical Unit of Work(KUW)です。個々のウェブサービス(URL)のリクエストを処理する過程がトランザクションです。ウェブアプリケーションにおいてトランザクションは、ウェブサービス(URL)に対するHTTP Requestを受信し、Responseを返すプロセスです。
アプリケーションの性能は、これらのトランザクションの性能であると言えます。トランザクションの性能には、トランザクションの開始から終了までの時間、レスポンス時間およびリソースの使用量、トランザクション呼び出し元の属性などの情報が含まれます。
基本的には、トランザクションのレスポンス分布とトランザクション統計を使用してトランザクションの性能を分析できます。
エージェントでトランザクションのパフォーマンスを追跡および設定するため、次のオプションを提供します。
トランザクショントレーシング
-
profile_http_header_enabled Boolean
既定値
false
トレース履歴にHTTPヘッダー情報を記録するには、
true
に設定します。 -
profile_http_parameter_enabled Boolean
既定値
false
トレース履歴にHTTPパラメータ情報を記録するには、
true
に設定します。パラメータは、他のセキュリティ キーを入力して参照できます。ノートセキュリティキーは、WASサーバ_
%PROGRAMFILES%
\WhaTap .NET\paramkey.txt_ ファイル内に6桁に設定します。 paramkey.txt ファイルが存在しない場合、ランダムな値で自動的に生成されます。 -
profile_http_parameter_url_prefix String
トレース履歴にhttpパラメータ情報を記録する対象URLのprefixを定義するときに使用します。
-
profile_http_host_enabled Boolean
既定値
false
トランザクションのホスト情報を出力します。値が
false
の場合、トランザクションのURLにURIのみが表示され、true
の場合/xxx.aaa.com/URLの形式で出力します。 -
profile_http_body_url_prefix String
トレース履歴にhttp body情報を記録する対象URLのprefixを定義するときに使用します。
-
biz_exceptions String
既定値
Empty
特定のErrorrまたはExceptionをBusiness Exceptionに設定します。 ヒットマップでは、エラーと表示されず、統計情報として収集します。 収集したError Class名と同じ名前を適用します。コンマ(,)を区切り文字として使用して、複数登録できます。
-
ignore_exceptions String
既定値
NONE
登録したExceptionのエラー自体を無視します。
Exceptionの場合、Custom Exception Classを定義しない場合は、既定の
Exception
として収集します。 特定のExceptionを区別するには、Custom Exception Classを定義し、その名前を設定することで、例外を除外します。 -
trace_normalize_enabled Boolean
既定値
true
トランザクションURLを解析および正規化する機能を有効にします。
ノートfalse
に値を変更すると、パスパラメータの構文解析が無効になります。この場合、統計データの意味が弱くなるため、デバッグ目的のみで使用することをお勧めします。 -
trace_normalize_urls String
既定値
NONE
正規化するトランザクションURLパターンを設定します。呼び出しURLパターンを解析して、pathパラメータを削除します。
ノート例)
/a/{v}/b
と宣言する場合は、a/123/b
→a/{v}/b
に置き換えます。複数登録する場合は、コンマ(,)を区切り文字として使用します。置換パターンをクリーンアップした後は、補足する必要があります。
-
transaction_status_error_enable Boolean
既定値
true
正常応答ではなくHTTP401、403のようなステータスコードがリターンされた場合、エラーとして処理するかどうかを設定します。
-
status_ignore String
無視するHTTPのステータスコードを設定できます。複数の値を対象とする場合は、コンマ(,)を区切り文字として使用してください。
whatap.conf# example
status_ignore=408,500 -
status_ignore_set String
whatap.error.STATUS_ERROR
を無視します。複数の値を対象とする場合は、コンマ(,)を区切り文字として使用してください。whatap.conf# example
status_ignore_set=/api/test/timeout/{time}:408,/api/test/timeout:200,/error:500 -
httpc_status_error_enable Boolean
既定値
true
HTTPステータスコードがエラーの場合は、収集有無を設定します。クライアントエラーレスポンス(
400
以上)、サーバーエラーレスポンス(500
以上)が該当します。ノートHTTPステータスコードの詳細については、次のリンクを参考にしてください。
-
httpc_status_ignore String
HTTPのステータスコードがエラー(
HTTPC_ERROR
)の場合、無視します。複数の値を対象にする場合は、コンマ(,)を区切り文字として使用してください。 -
httpc_status_ignore_set String
whatap.error.HTTPC_ERROR
を無視します。複数の値を対象とする場合は、コンマ(,)を区切り文字として使用してください。ノートhttpc_status_ignore_set=/a/b/c:400,/a/ab/c:404
に設定します。 この時に、URLは統計/エラー分析にHTPC_URL
の値を入力します。 -
profile_http_parameter_keys String
設定されたキーで対応するパラメータ情報を記録します。複数の登録をする場合は、コンマ(,)を区切り文字として使用します。
-
trace_active_transaction_slow_time Millisecond
既定値
3000
収集情報を確認するダッシュボードのアクティブトランザクションのアークイコライザーグラフで、slow間隔と表示するトランザクションレスポンス時間の基準を設定します。トランザクションのレスポンス時間が設定時間を超えた場合、slowアクティブのトランザクションの数に含まれます。
-
trace_active_transaction_very_slow_time Millisecond
既定値
8000
収集情報を確認するダッシュボードのアクティブトランザクションアークイコライザーグラフにおいてvery slow区間と表記できるトランザクションレスポンス時間の基準を設定します。トランザクションのレスポンス時間が設定時間を超えた場合、very slowアクティブトランザクションの数に含まれます。
-
trace_active_transaction_lost_time Millisecond
既定値
30000
トランザクションが終了するまで待機時間です。5分以内にトランザクションが終了しない場合、トランザクションは情報を収集しません。トランザクションのトレース情報で「Lost Connection」を確認できます。
-
prepend_app_pool_name Boolean
既定値
false
オプション値を
true
に設定すると、トランザクションのURLの前にアプリケーションのフルネームを表示します。