ビジネストランザクションの記録

エージェントレコーダの用途は、1 つのビジネストランザクションをキャプチャして確認し、次のビジネストランザクションに進むことです。これにより、長い記録セッションの間にクリックの厳密な順序を覚えていなくても、トランザクションを個々に分析することが可能になります。

ヒント：エージェント記録の便宜上、ビジネストランザクションは Web ブラウザのクリックの単位で考えます（たとえば、ログインのためのクリック、製品購入のためのクリックなど）。

エージェントレコーダを使用する際は、以下のトランザクションをキャプチャする必要があります。

適切に命名されたトランザクション -- 適切に命名されていない場合、トランザクションが実際に何を実行しているか把握できず、業務における目的を理解できない可能性があります。
本当に必要とされているトランザクション -- 必要な識別トランザクションでなければ、メトリックに表示されるアクティビティが多すぎるか少なすぎることになり、実際のユーザトランザクションがアクティビティに正確に反映されないことになります。

以下に、エージェント記録セッションの例を簡単に示します。

CEM コンソールでエージェントレコーダを開始します。
別のブラウザで、アプリケーションにログインします。
CEM コンソールに切り替えて、エージェントレコーダを停止します。
結果のビジネストランザクションシグネチャを確認します。ビジネストランザクションの名前がわかりづらいと思われる場合は、より意味のある名前に変更します。
エージェントレコーダを再開します。
アプリケーションで製品の購入をクリックします。
エージェントレコーダを停止します。
結果のビジネストランザクションシグネチャを確認します。このとき、識別ビジネストランザクション（購入）が最初に表示されていない可能性があります。たとえば、リダイレクトが最初に表示されている場合があります。
識別ビジネストランザクションでない最初のトランザクションを削除します（正しい識別ビジネストランザクションがリストの先頭にくるようにします）。最初のビジネストランザクションを識別トランザクションとして記録するためにチェックボックスをオンにします。

必要なトランザクションがすべて記録されるまで、上記のステップを続行します。

ビジネストランザクション情報をキャプチャするには、対象のユーザアクティビティを実行できるクライアントコンピュータから記録を実行する必要があります。たとえば、対象のアプリケーションにアクセスできないクライアントコンピュータから作業している場合、そのアプリケーションからのトランザクションは記録できません。

既知の制限

エージェント記録を設定するときに正規表現を使用する場合、いくつかの既知の制限があります。既知の制限は以下のとおりです。

POST パラメータ

POST パラメータの既知の制限は以下のとおりです。

出力不可能な文字は POST パラメータでサポートされていないため、予期しない結果が生じる可能性があります。
POST パラメータの定義がビジネストランザクション定義に依存している場合、ビジネストランザクションコンポーネントに提供されるのは 3 つのメトリックのみです。提供されるメトリックは以下のとおりです。
- Average Response Time
- Responses Per Interval
- Errors Per Interval
詳細については、「CA APM .NET Agent 実装ガイド」または「CA APM Java Agent 実装ガイド」のプロパティに関する付録を参照してください。
ビジネストランザクション定義が POST パラメータ定義に依存する場合、ビジネストランザクション追跡コンポーネントのビジネスコンポーネント名は、汎用的な名前となります。ビジネスサービス、ビジネストランザクション、ビジネストランザクションコンポーネントの特定の名前にはなりません。また、これは、照合しない POST パラメータの定義に依存しているビジネストランザクション定義にも適用されます。
JBoss および Tomcat の一部のバージョンは、ヘッダキーを小文字の値として保存する場合があるため、HEADER_TYPE で caseSensitiveName 属性が正しく機能しません。

HTTP パスパラメータ

エージェントでは、HTTP パスパラメータが TIM とは異なる方法で処理されます。パスパラメータは、URL パスにセミコロン（;）区切りのペアで表されるパラメータです。たとえば以下のようなものです。

http://mysite.mydomain.com/some/path;param1=value1

注：これはクエリパラメータとは異なります。クエリパラメータは通常疑問符（?）によって区切られます。

エージェントはパスパラメータを URL パスの一部と見なすため、個別に照合することはできません。

TIM でも、パスパラメータを URL パスの一部と見なしますが、個別のパスパラメータに基づいてビジネストランザクションコンポーネントを照合することができます。ビジネストランザクションコンポーネントに個別のパスパラメータのルールが含まれている場合、TIM ではこれらのルールに基づいて照合が実行されます。ただし、エージェントでは、これらのルールは存在しないものとして無視されます。

ビジネストランザクションコンポーネントが、パスパラメータによってエージェントで識別される必要がある場合は、個別のパスパラメータではなく正規表現を使用して、URL パスの一部として照合します。

重要：エージェントが WebLogic アプリケーションサーバ上で実行されている場合、JSESSIONID という名前のパスパラメータは URL パス内でエージェントによって認識されません。これは、このパスパラメータが WebLogic アプリケーションサーバで特別な意味を持っているためです。

エージェントがホスト名を正しく処理しない場合がある

.NET エージェントによって監視されるビジネストランザクションが、IP アドレスのホスト名に基づいて照合するよう定義されている場合には認識されません。ただし、同じ条件で Java エージェントによって監視されるビジネストランザクションは認識され、Investigator ツリーに適切に表示されます。

この問題を回避するには、IP アドレスの代わりに、大文字のホスト名で照合されるようホスト名を変更します。この設定変更を行うには、CEM コンソールで、［ビジネスサービス］-［ビジネストランザクション］-［トランザクション］-［コンポーネント］-［識別］を選択します。

IPv6

IPv6 を使用した環境では、エージェント記録が使用できない場合があります。 IPv6 および CA CEM の詳細については、「CA APM 設定および管理ガイド」を参照してください。