ビジネストランザクション検出の設定

コンテキストのあるビジネストランザクション

リアルタイム インストルメンテーションによって生成されたビジネストランザクションは、ビジネストランザクションの有効期間中に存続する BT コンテキストを作成します。

BT コンテキストは以下に必要です。

• 標準 SQL および ABAP トレース（「スナップショット設定の構成」を参照）。
• カスタムアクション。
• カスタム RFC exit コール。
• HTTP クライアントコールを介したダウンストリーム エージェントとの関連付け。

リアルタイム ビジネス トランザクションには、次の制限があります。

• RFC exit コールは、カスタム RFC exit コールを介してのみ機能します。
  • 1 つの例外は、フロントエンドとバックエンドシステム間の RFC 相関がサポートされている OData インストゥルメンテーションです。「NetWeaver Gateway のインストゥルメント化」を参照してください。
• ST22 および更新エラーとの関連付けはサポートされていません。

コンテキストのないビジネストランザクション

ログから再構築されたビジネストランザクションは、BT コンテキストを作成せず、コンテキストに依存する機能をサポートしません。BT の再構築に使用されるログには、サポートされていない追加機能を有効にする追加情報が含まれます。

• RFC コールは exit コールとして再構築されます。
  • ソースシステムからターゲットシステムへの 1 つの RFC コールステップのみが再構築されます。コールがターゲットシステムで 3 番目のシステムに継続される場合、コールは再構築されません。
• ST22 および更新エラーとの関連付けがサポートされます。
• 「SAP ダイアログトランザクションのモニター」を参照してください。

再構築されたビジネストランザクションには、次の制限があります。

• BT コンテキストを必要とする機能のリストを参照してください。
• 標準 SQL および ABAP トレースはサポートされません。再構築されたビジネストランザクションで能動的なトレースを使用できるようになりました。「スナップショット設定の構成」を参照してください。
• HTTP exit コールは再構築されますが、これらの exit コールでビジネストランザクションは継続されません。

コンテキストのあるビジネストランザクション

リアルタイム インストルメンテーションによって生成されたビジネストランザクションは、ビジネストランザクションの有効期間中に存続する BT コンテキストを作成します。

BT コンテキストは以下に必要です。

• 標準 SQL および ABAP トレース（「スナップショット設定の構成」を参照）。
• カスタムアクション。
• カスタム RFC exit コール。
• HTTP クライアントコールを介したダウンストリーム エージェントとの関連付け。

リアルタイム ビジネス トランザクションには、次の制限があります。

• RFC exit コールは、カスタム RFC exit コールを介してのみ機能します。
  • 1 つの例外は、フロントエンドとバックエンドシステム間の RFC 相関がサポートされている OData インストゥルメンテーションです。「NetWeaver Gateway のインストゥルメント化」を参照してください。
• ST22 および更新エラーとの関連付けはサポートされていません。

コンテキストのないビジネストランザクション

ログから再構築されたビジネストランザクションは、BT コンテキストを作成せず、コンテキストに依存する機能をサポートしません。BT の再構築に使用されるログには、サポートされていない追加機能を有効にする追加情報が含まれます。

• RFC コールは exit コールとして再構築されます。
  • ソースシステムからターゲットシステムへの 1 つの RFC コールステップのみが再構築されます。コールがターゲットシステムで 3 番目のシステムに継続される場合、コールは再構築されません。
• ST22 および更新エラーとの関連付けがサポートされます。
• 「SAP ダイアログトランザクションのモニター」を参照してください。

再構築されたビジネストランザクションには、次の制限があります。

• BT コンテキストを必要とする機能のリストを参照してください。
• 標準 SQL および ABAP トレースはサポートされません。再構築されたビジネストランザクションで能動的なトレースを使用できるようになりました。「スナップショット設定の構成」を参照してください。
• HTTP exit コールは再構築されますが、これらの exit コールでビジネストランザクションは継続されません。

HANA の SQL ステートメント：SAP システムが HANA DB を使用し、HANA の高コストなステートメントが有効になっている場合、上位 5 つの SQL ステートメントは、そのステートメントが HANA の高コストなステートメントメカニズムによって記録されている限り、すべてのビジネストランザクション タイプとスナップショットで使用できます。

汎用 HTTP 一致ルール

一致ルールを設定するには、次の手順を実行します。

1. HTTP 要求メソッド（GET、POST、PUT、DELETE）で照合するか、空のままにして、どの HTTP 要求メソッドでも照合しないようにします。この値には大文字/小文字の区別はありません。
2. 次から一致オプションを選択します。
   • [Equals]：大文字と小文字は区別されず、比較される値と等しい必要があります。例：URI - “/sap/order/orderId={2145}” Equals - “/sap/order/orderid={2145}”
   • [Starts with]：大文字と小文字は区別されず、ワイルドカードは使用できません。URI は指定された値で始まる必要があります。例：URI - “/sap/order/orderId={2145}” Starts with - “/sap/order
   • [Ends with]：大文字と小文字は区別されず、ワイルドカードは使用できません。URI は指定された値で終わる必要があります。例：URI - “/sap/order/orderId={2145}” Ends with - “{2145}”
   • [Contains]：大文字と小文字は区別されず、ワイルドカードは使用できません。URI は指定された値を含む必要があります。例：URI - “ /sap/order/orderId={2145}” Contains - “order”
   • [Matches RegEx]：大文字と小文字は区別されます。URI は指定された正規表現と一致する必要があります。例：URI - “ /sap/order/orderId={2145}” RegEx - “\/sap\/order\/orderId=\{[0-9]*\}”
   • [Is in list]：大文字と小文字は区別されず、URI はデリミタ「,」を使用して定義されたリスト内に存在する必要があります。例：URI："/sap/order/orderId={2145}" Is in list：“/sap/order/orderid={2145},/sap/order/orderid={2146},/sap/order/orderid={2147}”
   • [Is not empty]：空でない場合は、任意の URI に一致します。

また、URI パターンを設定します。URI パターンでは大文字と小文字が区別されず、URI による照合は必須です。

オプション

1. 一致ルールの詳細を追加するには、[Add match detail] をクリックします。既存の一致ルールの詳細を編集するには、[Edit match detail] をクリックします。

   

一致の詳細では、HTTP パラメータ、ヘッダー、または Cookie の値または存在を確認します。この値には大文字/小文字の区別はありません。

値、パラメータ、ヘッダー、または Cookie をチェックするときの一致タイプと一致値を設定します。この例では、一致する値に HTTP パラメータの値が含まれ、大文字と小文字が区別されます。一致と判断されるためには、一致ルールのすべての詳細条件が満たされる必要があります（AND 関係）。

バージョン 22.11.0 では、要素または要素の値の存在を確認できます。この機能は、HTTP リクエスト本文が XML、JSON、または SOAPXML フォーマットである場合にサポートされます。一致の詳細のドロップダウンメニューから、[HTTP Body Element] オプションを選択します。

• [Existence] を選択した場合は、要素の名前（または XPath 文字列）を使用します。一致ルールは、指定された要素が HTTP 要求本文で見つかった場合に、特定の HTTP 要求と一致します。

  

• [Value] を選択した場合は、要素の名前（または XPath）とその要素の目的の値を使用します（[equals] / [contains] / [starts with] などの多数の演算子を使用できます）。一致ルールは、指定された要素の値が HTTP 要求本文で一致した場合に、特定の HTTP 要求と一致します。

  

どちらの場合も、値に大文字/小文字の区別はありません。

OData サービス一致ルール

1. HTTP 要求メソッド（GET、POST、PUT、DELETE）で照合するか、空のままにして、HTTP 要求メソッドで照合しないようにします。この値には大文字/小文字の区別はありません。

   

2. OData サービス条件は、[Add match detail] を使用して一致ルールの詳細と同様に追加されます。既存の OData サービス条件を編集するには、[Edit match detail] をクリックします。この値には大文字/小文字の区別はありません。標準 F4 ヘルプは、OData サービスフィールドで使用できます。

   

   一致が発生するには、すべての OData サービス条件が満たされている必要があります（AND 関係）。

BSP アプリケーション一致ルール

BSP アプリケーションと BSP イベントによる一致。この値には大文字/小文字の区別はありません。標準 F4 ヘルプと複数選択は、[BSP Application] フィールドで使用できます。BSP アプリケーションおよびイベントのリストは、標準の選択オプション（OR 関係）と同様に評価されます。

GUI トランザクションの一致ルール

この一致ルールタイプは、SAP ダイアログ トランザクション モニタリングに関連します。「SAP ダイアログトランザクションのモニター」を参照してください。

トランザクションコード、レポート、機能コード（OK コード）、リファレンスプログラム、およびアプリケーション コンポーネント識別子による一致。これらの値には大文字/小文字の区別はありません。標準 F4 ヘルプと複数選択は、[Transaction Code] フィールドと [Application Component ID] フィールドで使用できます。5 つのリストはすべて、標準の選択オプション（OR 関係）として評価されます。

これらのフィールドの値は、GUI トランザクション BT の再構築のために評価（照合）されている STAD レコードの対応するフィールドと比較されます。

バックグラウンドジョブの一致ルール

この一致ルールは、STAD ログに記録された終了したバックグラウンドジョブを検出します。結果のビジネストランザクションは、バックグラウンドタスクとして登録されます。「バックグラウンドタスクのモニター」を参照してください。

ジョブ名（SM37 に表示されるジョブの名前）と実行されたレポートによる一致。標準 F4 ヘルプは、TBTCO からジョブのリストを選択できる [Jobname] に使用できます（将来/未定義のジョブは F4 ヘルプに表示されません）。

これらの値は、一致ルール（SM37 スクリーンショット）に対して評価されます。

着信 RFC 一致ルール

この一致ルールは、RFC サーバーコールからビジネストランザクションを再構築します。データは STAD RFC サーバー統計情報から抽出されます。

このルールは、次の条件で照合できます。

• [Function module]：現在のシステムで RFC を介して実行された関数モジュール。

• [Source instance]：RFC 発信者インスタンスの名前。

• [Source IP address]：RFC 発信者の IP アドレス。

• [RFC user]：現在のシステムで RFC ログインに使用されたユーザー

これらの値は、STAD RFC サーバー統計情報に対して評価されます。

カスタマー インタラクション センターの一致ルール

リリース 4.5.1908 以降、SAP IS-U システムでは、カスタマー インタラクション センター（CIC0）専用のルールを使用できます。これは、個々の IS-U フロントオフィスプロセスに基づいて CIC0 トランザクションをビジネストランザクションに分割できる、SAPGUI 一致ルールの拡張です。

SAPGUI 一致ルールのみを使用してカスタマー インタラクション センターをモニターすると、すべてのビジネストランザクションが CIC0 として表示されます。したがって、さらに分割する必要があります。

このタイプの一致ルールは、IS-U システムで ABAP エージェントを実行している場合にのみ有効になります。

個々のフロントオフィスプロセスを照合するには、モニターする必要がある最も重要なプロセスを選択します。

汎用 HTTP トランザクション分割

• 最初のいくつかの URI セグメント

  • 分割値：セグメント数（N）

  • トランザクション名：「/」で区切られた使用可能な URI セグメントの最初の（N）。URI セグメントが（N）個未満の場合、URI 全体が使用されます。

• 最後のいくつかの URI セグメント

  • 分割値：セグメント数（N）

  • トランザクション名：前の方法と同じですが、使用可能なセグメントの最初（N）ではなく、使用可能なセグメントの最後（N）が使用されます。

• 特定の URI セグメント

  • 分割値：「,」で区切られたセグメントのリスト（例：「1,5,4,13」）

  • トランザクション名：「/」で区切られたセグメントのリストで指定された URI セグメント。存在しない URI 位置は無視されます。

• パラメータ値

  • 分割値：GET または POST パラメータ名（大文字と小文字を区別しない）

  • トランザクション名：「<トランザクション名ベース>.」+ 指定した名前のパラメータ値（リクエストに存在する場合）

• ヘッダー値

  • 分割値：ヘッダー名（大文字と小文字を区別しない）

  • トランザクション名：「<トランザクション名ベース>.」+ 指定した名前のヘッダー値（リクエストに存在する場合）

• Cookie 値

  • 分割値：Cookie 名（大文字と小文字を区別しない）

  • トランザクション名：「<トランザクション名ベース>.」+ 指定した名前の Cookie 値（リクエストに存在する場合）

• 要求メソッド

  • 分割値を設定できません

  • トランザクション名：「<トランザクション名ベース>.」+ リクエストメソッド

いずれの分割方法も値を返さない場合は、代わりに一致ルール名で定義されたデフォルトのトランザクション名が使用されます。

OData サービスのトランザクション分割

• OData サービスディスクリプション
  • 分割値を設定できません
  • トランザクション名：英語の技術 OData サービス名と OData サービスディスクリプションのテキスト
• OData サービス技術名
  • 分割値を設定できません
  • トランザクション名：技術 OData サービス名

BSP アプリケーションのトランザクション分割

• BSP アプリケーション名
  • 分割値を設定できません
  • トランザクション名：英語の技術 BSP アプリケーション名および BSP アプリケーションの説明テキスト

この分割方法で値が返らず、一致ルール名が空の場合、フォールバック名「BSP」が使用されます。

GUI のトランザクション分割

• トランザクション名（Tcode）

  • 分割値を設定できません

  • トランザクション名：英語の技術 Tcode 名と説明テキスト

• アプリケーションコンポーネント

  • 分割値を設定できません

  • トランザクション名：英語の技術アプリケーション コンポーネント名と説明テキスト

• アプリケーション サブコンポーネント

  • 分割値を設定できません

  • トランザクション名：英語の技術アプリケーション サブコンポーネント名と説明テキスト

この分割方法が値を返さない場合は、一致ルールで定義されたデフォルトのトランザクション名が代わりに使用されます。一致ルール名が空の場合は、GUI Unassigned が使用されます。

バックグラウンドジョブのトランザクション分割

• バックグラウンドジョブ名

  • 分割値を設定できません

  • トランザクション名：SM37 に表示されるバックグラウンドジョブの技術名

• レポート

  • 分割値を設定できません

  • トランザクション名：バックグラウンドジョブで使用されたレポートの技術名

着信 RFC のトランザクション分割

• 汎用モジュール

  • 分割値を設定できません

  • トランザクション名：「RFC_<呼び出された汎用モジュール>」

• ソースインスタンス

  • 分割値を設定できません

  • トランザクション名：「RFC_<発信者インスタンス名> 」

• ソース IP アドレス

  • 分割値を設定できません

  • トランザクション名：「RFC_<発信者 IP アドレス>」

カスタマー インタラクション センター分割

• フロントオフィスプロセス
  • 分割値を設定できません
  • トランザクション名：フロントオフィスプロセス名

Exit Calls

これらのオプションは、一致ルールによって生成されたビジネストランザクションによる exit コールの処理方法を設定するために使用されます。オプションは、すべての一致ルールタイプに関連します。

• [Inactive]：結果のビジネストランザクションに exit コールは追加されません。

• [Limited]：実際の exit コールは生成されません。ビジネス トランザクション インスタンスは、リモートコールのランタイムを計算し、それらをリモートコールの詳細と組み合わせてデータコレクタにします。最初の 10 個のリモートコールのみがデータコレクタに再構築されます（Exit Call 1 ～ Exit Call 10）。このモードは GUI トランザクションでは使用できません。

  

• [Exit Call Only]：結果のビジネストランザクションには exit コールのみが追加されますが、exit コールはダウンストリームシステム/バックエンドと関連付けられません。

• [Full]：デフォルトのビジネストランザクション動作。exit コールは、結果のビジネストランザクションに追加され、可能な場合はダウンストリームティアと関連付けられます。

ABAP トレース

これらのオプションは、バージョン 740 以降の SAP システムでのみ使用できます。この設定を使用すると、グローバル ABAP トレース設定は上書きされます。「スナップショット設定の構成」を参照してください。オプションは、すべての一致ルールタイプに関連します。

• [Off]：ABAP トレースは収集されません。

• [Top 5 ABAP Statements]：上位 5 つの ABAP ステートメントがデータコレクターとして結果のビジネストランザクションのスナップショットに追加されます。

• [Call Graph]：ABAP トレースは、結果のビジネストランザクションのスナップショットにコールグラフの形式で追加されます。

• [Both]：上位 5 つの ABAP ステートメントとコールグラフの両方が結果のビジネストランザクションのスナップショットに追加されます。

SQL トレース

これらのオプションは、バージョン 740 以降の SAP システムでのみ使用できます。この設定を使用すると、グローバル SQL トレース設定は上書きされます。「スナップショット設定の構成」を参照してください。オプションは、BT コンテキストのある一致ルールタイプにのみ関連します。

• [Off]：SQL トレースは収集されません。

• [ST05]：ST05 SQL トレースが収集されると、上位 5 つの SQL ステートメントが結果のビジネストランザクションのスナップショットに追加されます。HANA DB で ST05 SQL トレースが使用できないとき、上位 5 つの SQL ステートメントは、使用可能な場合に HANA の高コストなステートメントから再構築されます。

• [HANA]（HANA DB でのみ）：上位 5 つの SQL ステートメントは、HANA の高コストなステートメントからのみ収集され、結果のビジネストランザクションのスナップショットに追加されます。ST05 SQL トレースは使用されません。HANA の高価なステートメントは、HANA の設定によって有効にする必要があり、意味のあるしきい値を t-code DB02 に設定する必要があります。

End User Monitoring Correlation

このオプションは、一致ルールによって生成されたビジネストランザクションの EUM 相関を抑制するために使用されます。このオプションは、BT コンテキストのある一致ルールタイプにのみ関連します。

• [Off]：EUM 相関をオフにします。ユーザーモニタリングで収集されたユーザーアクションは、この一致ルールに一致するビジネストランザクションに関連付けられません。

• [On]：デフォルトのビジネストランザクション動作。

エラーの伝達

このオプションは、ビジネストランザクションおよび exit コール中にエラーと例外が伝達される方法に影響します。

• [Off]：エラーの伝達をオフにします。この一致ルールに一致したビジネストランザクション中に発生したエラーと例外は、コントローラに伝達されません。BT 中の exit コールエラーは引き続き伝達されます。

• [Immediately]：BT が処理されている場合、エラーが直ちに伝達されます。このオプションをオンにすると HTTP コールが配信されますが、BT レポートの同期性により、パフォーマンスのオーバーヘッドがわずかに発生する可能性があります。

• [End]：デフォルトのオプション。BT の最後にエラーが伝達されるため、パフォーマンスのオーバーヘッドが減少します。

データベース

[Automatic DB Call]：ビジネストランザクションの全期間中、プライマリデータベースへの exit コールが自動的に開始されます。エキスパートパラメータ「BT_DATABASE_EXITCALL」をオーバーライドします。