本文へスキップ

トランザクション

トランザクションとは、ユーザーブラウザからのリクエストを処理するサーバーサイドの Logical Unit of Work（LUW）です。Web アプリケーションにおいては、1 つの HTTP リクエストを受け取り、レスポンスを返すまでの一連の処理全体がトランザクションに該当します。

アプリケーションの性能は、トランザクション処理性能によって評価できます。トランザクション性能には、トランザクション開始から終了までの応答時間、リソース使用量、呼び出し元の属性などの情報が含まれます。

トランザクション性能は、応答時間の分布や統計データを基に分析できます。

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

アプリケーション内の各トランザクションの実行経路を詳細に追跡するためのエージェントオプションです。

  • trace_active_transaction_slow_time Millisecond

    既定値 3000

    ダッシュボードのアクティブTX・アークイコライザーグラフにおいて、slow として表示するトランザクション応答時間の基準を設定します。応答時間が設定値を超えると、slow アクティブTXとしてカウントされます。

  • trace_active_transaction_very_slow_time Millisecond

    既定値 8000

    ダッシュボードのアクティブTX・アークイコライザーグラフにおいて、very slow として表示するトランザクション応答時間の基準を設定します。応答時間が設定値を超えると、very slow アクティブTXとしてカウントされます。

  • trace_active_transaction_lost_time Millisecond

    既定値 300000

    トランザクション完了を待つ制限時間です。5 分以内にトランザクションが終了しない場合、そのトランザクションの情報収集を停止します。トランザクショントレースでは「Lost Connection」と表示されます。

  • prepend_app_pool_name Boolean

    既定値 false

    true に設定すると、トランザクション URL の前にアプリケーションの完全な名前が表示されます。

  • 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

    HTTP 401、403 などの正常ではない HTTP ステータスコードを返した場合に、エラーとして扱うかどうかを設定します。

  • status_ignore String ​

    無視する HTTP ステータスコードを設定します。複数指定する場合は、カンマ（,）で絞り込んでください。

    whatap.conf
    # example
    status_ignore=408,500
    Tips

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

  • status_ignore_set String ​

    特定の URL と HTTP ステータスコードの組み合わせをエラーとして扱わないようにするオプションです。

    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

    HTTP クライアントの外部呼び出しにおいて、特定の URL とステータスコードの組み合わせをエラーとして扱わないためのオプションです。

    whatap.conf
    httpc_status_ignore_set=api.example.com:404,payment.service:500
    # アプリケーションが api.example.com を呼び出し、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_host_enabled Boolean

    既定値: false

    トランザクションの Host 情報を出力します。値が false の場合、トランザクションの URL には URI のみが表示されます。true の場合は、/xxx.aaa.com/URL 形式で表示されます。

  • 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は、ヒットマップ, トレース分析またはトランザクション情報画面で収集が除外されます。

最終修正：