On this page:

Related pages:

ビジネス トランザクション レポートを有効にするには、ビジネストランザクションの一致ルールのリストを [Instrumentation settings] で管理します。

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

一致ルールタイプ

次のタイプのマッチングルールがサポートされています。

一致ルールタイプBT コンテキスト説明
Generic HTTPyesSAP HTTP サーバーによって処理されるインバウンド HTTP トラフィック

OData service

yesOData に固有の HTTP トラフィックのサブセット
BSP applicationyesHTTP のサブセットであるが、エントリポイントが他の HTTP 一致ルールのサブセットと異なる
GUI transactionnoユーザーがコマンドフィールドに入力するトランザクションコード
Background job×バックグラウンドで実行される終了したジョブ。 
Incoming RFC×現在のシステムに対して発信された RFC コール
Customer Interaction Centernoトランザクションコード CIC0 の GUI トランザクション、フロントオフィスプロセスのサブセット（IS-U システムのみ）

ビジネス トランザクション コンテキストは、ビジネストランザクションの処理方法に関連します。コンテキストのあるビジネストランザクションはリアルタイムで処理され、コンテキストのないビジネストランザクションはログから再構築されます。どちらのカテゴリにも、いくつかの利点と制限があります。

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

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

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

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

  • 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 の高コストなステートメントメカニズムによって記録されている限り、すべてのビジネス トランザクション タイプとスナップショットで使用できます。

デフォルトの一致ルールの生成

バージョン 21.8.0 では、デフォルトの自動検出一致ルールを生成するために新しい一致ルールテーブルボタンを使用できます。この機能は、テスト環境での初期設定を高速化することを目的としています。生成された自動検出一致ルールを実稼働環境で使用することは推奨されません。

一致ルールのコピー

バージョン 23.2.0 では、既存の一致ルールをコピーするための新しい一致ルールテーブルボタンを使用できます。この機能により、カスタム一致ルールをより柔軟に作成できます。テーブルの行の 1 つを選択して [Copy match rule] ボタンを押すだけで、一致ルールとそのすべての内容および設定が新しい一致ルールにコピーされます。

一致ルールの追加

指定したタイプのカスタム一致ルールまたは自動トランザクション検出を定義します。自動トランザクション検出は、選択したタイプのすべてのインバウンドトラフィックを自動的に照合する特別な一致ルールで、除外オプションと一致詳細オプションはありません。

Automatic Discovery in Production Environments

自動トランザクション検出の一致ルールは、主に非実稼働環境を対象としています。実稼働システムでは、カスタム一致ルールの対象を絞ったセットを定義することをお勧めします。「ビジネストランザクションの制限」および「ビジネストランザクションの整理」を参照してください。


一致ルールの概要

一致ルールは複数の設定で構成されます。[Match Rule Type] は表示されますが、この時点では変更できません。一致ルールは、ビジネストランザクションを含めるか除外するかを設定できます。包含ルールは、優先順位に関係なく、常に除外ルールの前に評価されます。

次の表に、その他の設定をまとめます。

フィールド説明
名前

一致ルールを指定します。

このルールに一致するビジネストランザクションには、デフォルトで一致ルール名が付けられます。[Name] フィールドが空の場合、デフォルトの命名方法は選択したルールタイプによって異なります。ビジネストランザクション名が解決されない場合は、フォールバック トランザクション名として「UNRESOLVED」が使用されます。これらの命名規則では、ビジネストランザクション分割のベース名を定義します。

優先度

一致ルール評価の順序を定義します。優先順位が最も高い番号が最初に評価されます。

優先順位を指定しない場合、一致ルールは一致ルールのリストに表示される順序で評価されます。

評価の順序：

  1. 包含ルール（優先順位が高いものから）

  2. 包含ルール（優先順位の指定がない場合は、リストの順序）

  3. 除外ルール（優先順位が高いものから）

  4. 除外ルール（優先順位の指定がない場合は、リストの順序）

一致基準の設定

一致ルールの設定は、一致ルールタイプによって異なります。

汎用 HTTP 一致ルール

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

  1. HTTP 要求メソッド（GET、POST、PUT、DELETE）で照合するか、空のままにして、どの HTTP 要求メソッドでも照合しないようにします。
    この値には大文字/小文字の区別はありません。
  2. 次から一致オプションを選択します。
    • 次と等しい(Equals)
    • 次の値で始まる
    • 次の文字列で終わる（Ends With）
    • 記載内容

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

Optional

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

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

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

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


レガシー HTTP SDK

レガシー HTTP SDK には、SAP バックグラウンドジョブ BT をバックグラウンドタスクとして自動的に登録する機能は含まれていません。HTTP SDK のレガシービルドを使用している場合は、コントローラ UI を使用して、対応するビジネストランザクションをバックグラウンド タスク タイプに手動で切り替えてください。


ジョブ名（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 service description
    • 分割値を設定できません
    • トランザクション名：英語のテクニカル OData サービス名と OData サービスの説明テキスト
  • OData service technical name
    • 分割値を設定できません
    • トランザクション名：テクニカル OData サービス名

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

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

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

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

  • Transaction name (Tcode)

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

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

  • Application component

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

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

  • Application sub-component

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

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


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

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

  • Background job name

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

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

  • Report

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

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

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

  • Function module

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

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

  • Source instance

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

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

  • Source IP address

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

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

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

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

一致ルールの設定

リリース 21.11.0 では、各一致ルールの設定をカスタマイズするオプションが追加されました。これにより、ユーザーは、一致ルールと一致するビジネストランザクションに何を追加するかを指定できます。exit コールまたはコールグラフをビジネストランザクションに関連させるかどうかを変更したり、ABAP/SQL トレースオプションを詳細に指定したり、エンドユーザーモニタリング相関を無効にしたりできます。

設定は、[Rule Settings] タブの下にあります。次の 2 つのオプションを使用できます。

  • Global Settings：デフォルト設定。一致ルール固有の設定は非アクティブ化され、結果のビジネストランザクションはスナップショット設定に従ってグローバル設定を使用します。exit コールと相関がオンになります。
  • Custom Settings：カスタム設定を選択すると、ユーザーはこの一致ルールと一致するビジネストランザクションに追加する情報を設定できます。

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 - デフォルトのビジネストランザクション動作。

特定のユーザーのトランザクション検出の制限

テスト目的で、ビジネストランザクション検出が有効になっているユーザーの許可リストを設定できます。

AppDynamics 設定ツールバーの [BT user filter] をクリックします。次の図に、ユーザー名のサンプルリストを示します。

ビジネストランザクションの制限

コントローラとアプリケーション サーバー エージェントのビジネストランザクション制限を考慮することは重要です。ビジネストランザクションの制限は、ビジネストランザクションのリストが際限なしに増加するのを防ぎます。デフォルトの制限は、アプリケーション サーバー エージェント（ノード）あたり 50 のビジネストランザクションと、アプリケーションあたり 200 のビジネストランザクションです。「ビジネストランザクションの制限」を参照してください。

ビジネストランザクションの登録制限に達するか、トランザクション ロックダウンが有効になると、新しく検出されたトランザクションはビジネストランザクションとして登録されません。ただし、それらは AppDynamics によってモニターされ、レポートされます。トランザクションは、「All Other Traffic - tier_name」と命名された仮想ビジネス トランザクション グループに配置されます。[All Other Traffic] グループは、制限に達したティアごとに存在します。詳細については、「ビジネストランザクションの整理」を参照してください。

着信トラフィックとの自動ダウンストリーム相関

バージョン 4.4.1812.0 以降、有効な相関ヘッダーを含む着信 HTTP 要求は自動的に相関され、汎用 HTTP、OData、または BSP の一致ルールがなくてもビジネストランザクションが続行されます。以前のバージョンでは、これを実現するために一致ルールが必要でした。