本文へスキップ

トランザクション

トランザクションとは、ユーザーのブラウザーからのリクエストを処理するためのサーバーサイドの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/ba/{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の前にアプリケーションのフルネームを表示します。