On this page：

Related pages:

モバイルネットワークのリクエストをビジネストランザクションと関連付けることができます。実際には、ネットワークリクエストのインスタンス（ネットワークリクエストのスナップショット）とビジネストランザクションのインスタンス（トランザクション スナップショット）の間で関連付けが行われます。

この相関により、モバイルアプリケーションによって作成されたネットワークリクエストを、基盤となるバックエンド アプリケーションとマッピングすることができます。ビジネストランザクションの相関は、デフォルトでは無効になっています。

要件

ビジネストランザクションを関連付けるには、次の手順を実行する必要があります。

  • アプリケーション パフォーマンス モニタリング（APM）およびエンドユーザモニタリング（EUM）のライセンスの購入
  • アプリケーション エージェントを使用したアプリケーションのインストゥルメント化
  • モバイルエージェントを使用したモバイルアプリケーションのインストゥルメント化
  • コントローラ UI でのビジネストランザクション相関の有効化

App Server Agents Supporting Business Transaction Correlation

ビジネストランザクションを関連付けるには、ビジネスアプリケーションに次のアプリケーション サーバ エージェントのいずれかがインストールされている必要があります。

Benefits of Correlating Business Transactions

ビジネストランザクションとネットワークリクエストのスナップショットを関連付けることにより、ユーザエクスペリエンスの低下につながっているバックエンド アプリケーションの潜在的な問題を特定できます。たとえば、サーバエラーまたはデータベースクエリによって低速または非常に低速なユーザエクスペリエンスが発生していることが判明することがあります。

動作

ネットワークリクエストを必要とするモバイルアプリケーションでエンドユーザがアクションを実行する場合は、次のようになります。

  1. アプリケーション エージェントは次のことを実行します。
    • ビジネストランザクションを識別する HTTP ヘッダーをエンドユーザのモバイルデバイスに送信します。
    • バックエンドメトリックを集約し、ビジネストランザクション識別子とともに the Controller.This serves as the content for the transaction snapshot.
  2. モバイルエージェントは、（HTTP ヘッダーから）メトリックとビジネストランザクション識別子を EUM Server に送信します。これは、ネットワークリクエストのスナップショットのコンテンツとして機能します。

  3. Controller は、EUM Server からメトリックとビジネストランザクション識別子を取得し、このビジネストランザクション識別子を使用して、ネットワークリクエストのスナップショットをトランザクション スナップショットと関連付けます。

ビジネストランザクション相関の有効化

You need to configure the Controller to correlate business transactions. Controller は、上記の「動作」で説明したプロセスに基づいて、ビジネストランザクションをネットワークリクエストのスナップショットにマッピングします。

To enable business transaction correlation:

  1. From the Application Dashboard, click Configuration.
  2. User Experience App Integration > をクリックします。

  3. Business Transaction Correlation  タブで、Enable Business Transaction Correlation チェックボックスをオンにします。

相関ヘッダーを含めるビジネストランザクションを指定する

相関ヘッダーを含める、または除外するビジネストランザクションを指定することもできます。リクエストマッチルールまたはリクエスト除外ルールを追加しない場合、相関ヘッダーはすべてのリクエストに追加されます。

To add a request rule:

  1. plus アイコンをクリックし、Create HTTP Request Match Rule ダイアログを開きます。
  2. Create HTTP Request Match Rule ダイアログで、次の操作を実行します。
    1. Check the Method checkbox and select an HTTP method that you want to match. If you do not select an HTTP method, the rule will be applied to all HTTP requests.
    2. Check the URI checkbox and enter your criteria.
    3.  Save to save the match rule.
  3. From the Business Transaction Correlation tab, click Save.

View Business Transaction Correlation

ブラウザスナップショットから関連付けられたビジネストランザクションに移動する方法は複数あります。次の手順は、可能な 1 つの方法を示しています。

  1. From the Mobile App Dashboard, click Network Requests.
  2.  Snapshots.
  3. 次に示すように、ネットワーク トランザクションのスナップショットが表示されます。


  4. いずれかのブラウザスナップショットをダブルクリックし、Network Request Snapshot Details ダイアログを開きます。関連付けられたトランザクション スナップショットが存在する場合は、次に示すように Business Transactions セクションにリンクが表示されます。
  5. その後、トランザクション スナップショットのリンクまたはトランザクション スナップショット自体をクリックすると、APM 内の対応するページを表示できます。

Business Transaction Correlation HTTP Headers

モバイルエージェントおよびビジネスアプリケーションは、HTTP ヘッダーを交換し、ビジネストランザクションをネットワークリクエストと関連付けます。To ensure the business transactions are correlated, be sure that the HTTP headers are not blocked.

モバイルエージェントの HTTP ヘッダー

モバイルエージェントは、次の HTTP ヘッダーをビジネスアプリケーションに送信します。HTTP ヘッダーは小文字または大文字にすることができるため、ADRUM_1 と adrum_1 は両方とも有効です。

HTTP HeaderSupported Values説明
ADRUMisAjax:true, isAjax:falseネットワークリクエストが Ajax で実行されたかどうかを示します。
ADRUM_1isMobile:true, isMobile:falseネットワークリクエストがネイティブまたは Web ビューのどちらで実行されたかを示します。

Business Application HTTP Headers

ビジネスアプリケーションは、次のシンタックスの HTTP ヘッダーで応答します。ADRUM_<number> For example: ADRUM_0, ADRUM_1, ADRUM_2. ビジネスアプリケーションは通常、約 5 個の HTTP ヘッダーを返しますが、最大 15 個を送信できます。The values assigned to the HTTP headers are string identifiers used for correlation purposes.

次に、ビジネスアプリケーションによってモバイルエージェントに送信される HTTP ヘッダーのセットの例を示します。

ADRUM_0: g:325e6a4b-72e1-4a57-8da8-3c0ffccsdd
ADRUM_1: n:customer1_3fdf4d56-f805-4a85-bf1a-ass
ADRUM_2: i:2224122
ADRUM_3: e:449
ADRUM_4: d:198
TEXT