本文へスキップ

トランザクション

トランザクションとは、ユーザーのブラウザからのリクエストを処理するためのサーバーサイドのLogical Unit of Work(KUW)です。個々のウェブサービス(URL)のリクエストを処理する過程がトランザクションです。ウェブアプリケーションにおいてトランザクションは、ウェブサービス(URL)に対するHTTP Requestを受信し、Responseを返すプロセスです。

アプリケーションの性能は、これらのトランザクションの性能であると言えます。トランザクションの性能には、トランザクションの開始から終了までの時間、レスポンス時間およびリソースの使用量、トランザクション呼び出し元の属性などの情報が含まれます。

基本的には、トランザクションのレスポンス分布とトランザクション統計を使用してトランザクションの性能を分析できます。

トランザクショントレーシング​

以下は、アプリケーション内の各トランザクションの実行パスを詳以下追跡できるエージェントのオプションです。

  • 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

    既定値300000

    トランザクションが終了するまで待機時間です。5分以内にトランザクションが終了しない場合、トランザクションは情報を収集しません。トランザクションのトレース情報で「Lost Connection」を確認できます。

  • prepend_app_pool_name Boolean

    既定値false

    オプション値をtrueに設定すると、トランザクションのURLの前にアプリケーションのフルネームを表示します。

  • trace_db_command_methods String Deprecated

    System.Data.Common.DbCommandクラスでモニタリングするメソッド名を入力します。2 つ以上の値を設定するには、コンマ(,)を区切り文字として利用します。すべてのメソッドをモニタリングするには、以下のように適用します。

    whatap.conf
    trace_db_command_methods=ExecuteReader, ExecuteReaderAsync, ExecuteNonQuery, ExecuteNonQueryAsync, ExecuteScalar, ExecuteScalarAsync

  • expand_transaction_level Boolean

    既定値false

    オプション値をtrueに設定すると、トランザクションの外部から発生するSQL、HTTPの呼び出しをトランザクションとして扱い、ヒットマップに表示します。

  • expand_transaction_basetime Int

    既定値1000(1秒)/最小値100(0.1秒)

    expand_transaction_level オプションが trueに設定されている場合は、指定した時間よりも応答時間のかかるリクエストのみが、データを収集します。1秒当たり最大100件まで収集します。

例外処理​

以下は、アプリケーションで発生する例外を管理およびモニタリングするためのオプションです。ビジネス例外を登録し、関連する統計を収集することで、アプリケーションの安定性を確認できます。また、特定の例外を無視したりHTTPステータスコードがエラーの場合、エラーとして処理するかどうかを設定できます。例外として処理された項目は、ヒットマップまたはトレース分析画面で、正常なトランザクションとして表示されます。

  • transaction_status_error_enable Boolean ​

    既定値 true

    正常応答ではなくHTTP401、403のようなステータスコードがリターンされた場合、エラーとして処理するかどうかを設定します。

  • status_ignore String ​

    無視するHTTPのステータスコードを設定できます。複数の値を対象とする場合は、コンマ(,)を区切り文字として使用してください。

    whatap.conf
    # example
    status_ignore=408,500
    Tips

    Statusエラー無視 / ヒットマップ表示レベル：INFO(青色) / エラー統計を含まない

  • status_ignore_set String ​

    whatap.error.STATUS_ERRORを無視します。複数の値を対象とする場合は、コンマ(,)を区切り文字として使用してください。

    whatap.conf
    # example
    status_ignore_set=/api/test/timeout/{time}:408,/error:500
    Tips

    Status エラーセット無視 / ヒットマップ表示レベル：INFO(青色) / エラー統計を含まない

  • httpc_status_error_enable Boolean

    既定値 true

    HTTPステータスコードがエラーの場合は、収集有無を設定します。クライアントエラーレスポンス(400以上)、サーバーエラーレスポンス(500以上)が該当します。

    ノート

    HTTPステータスコードの詳細については、次のリンクを参考にしてください。

  • httpc_status_ignore String

    HTTPのステータスコードがエラー(HTTPC_ERROR)の場合、無視します。複数の値を対象にする場合は、コンマ(,)を区切り文字として使用してください。

    Tips

    HTTPステータスエラーコード無視 / エラー統計を含まない

  • httpc_status_ignore_set String

    whatap.error.HTTPC_ERRORを無視します。複数の値を対象とする場合は、コンマ(,)を区切り文字として使用してください。

    httpc_status_ignore_set=/a/b/c:400,/a/ab/c:404に設定します。 この時に、URLは統計/エラー分析にHTPC_URLの値を入力します。

    whatap.conf
    httpc_status_ignore_set=/a/b/c:400,/a/ab/c:404
    Tips

    HTTPステータスエラーコード無視 / エラー統計を含まない

HTTPトランザクションの追跡​

以下は、HTTPリクエストと応答に関連する様々な情報を追跡および記録するエージェントのオプションです。これにより、ユーザーはアプリケーションのHTTPトランザクションを細かくモニタリングし分析できます。トランザクション名にパラメータ値を追加または特定のURLやHTTPメソッドを除外できます。またHTTPヘッダー情報やパラメータ情報を含め、トランザクションをより詳細に記録できます。

  • profile_http_parameter_keys String

    設定されたキーで対応するパラメータ情報を記録します。複数の登録をする場合は、コンマ(,)を区切り文字として使用します。

  • 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_body_url_prefix String

    トレース履歴にhttp body情報を記録する対象URLのprefixを定義するときに使用します。

  • trace_ignore_url_set String

    トランザクション追跡から除外するURLを設定します。2つ以上の値を設定する場合は、コンマ(,)を区切り文字として使用します。

    ノート

    このオプションを通じて登録したURLは、ヒットマップ, トレース分析またはトランザクション情報画面で収集が除外されます。

  • trace_ignore_url_prefix String

    トランザクションの収集から除外するURLのプレフィクス(prefix)を設定します。設定したプレフィクスと一致するURLは、トランザクションの性能を収集しません。複数の値を設定するには、コンマ(,)で区切りします。

    ノート

    このオプションを通じて登録したURLは、ヒットマップ, トレース分析またはトランザクション情報画面で収集が除外されます。

  • trace_ignore_url_suffix String

    トランザクションの収集から除外するURLのサフィックスを設定します。設定したサフィックスと一致するURLは、トランザクションの性能を収集しません。複数の値を設定するには、コンマ(,)で区切りします。

    ノート

    このオプションを通じて登録したURLは、ヒットマップ, トレース分析またはトランザクション情報画面で収集が除外されます。