4.5.9 からは、コントローラ UI を介して、.NET Agent for Linux の簡単な POCO または ASP.NET ビジネストランザクションを設定できます。

.NET Agent for Linux 4.5.9 はコントローラ 4.4.1 以降と連動しますが、カスタマイズ可能なトランザクション検出および設定機能には 4.5.2 以降が必要です。コントローラ 4.4.2 ~ 4.5.1 および .NET Agent for Linux の場合、AppDynamics は ASP.NET ビジネストランザクション命名の URI の最初の 2 つのセグメントを使用するようにデフォルト設定されます。

コントローラ UI を使用したカスタム ASP.NET ビジネストランザクションの定義

以下に対して HTTP リクエストに一致する条件を持つ ASP.NET ビジネストランザクション検出の包含ルールまたは除外ルールを作成できます。

この HTTP リクエスト条件では、トランザクション分割がサポートされています。 

  • メソッド
  • URI
  • HTTP パラメータ
  • ヘッダー
  • Cookie

これらの HTTP リクエストオプションはドロップダウンリストに表示されますが、.NET Agent for Linux ではサポートされていません。UI で設定されている場合は、影響はありません。 

  • ホスト名
  • [ポート(Port)]
  • クラス名

他のエージェントと同様に、.NET Agent for Linux のビジネストランザクションをカスタマイズします。[Configure > Instrumentation > Add Rule] をクリックし、包含ルールまたは除外ルールのいずれかの作成を選択します。  

ASP.NET ビジネストランザクション検出ルールの例

この例では、ASP.NET エントリポイントを使用して、URI が /healthcheck であるすべての要求を除外する .NET エージェントのカスタム一致ルールを作成する方法を示しています。 
Custom Match Rule

このルール概要は、除外一致ルールを指定します。除外ルールを作成して、包含ルールによってモニタされるトランザクションの一部を省略する前に、包含ルールを作成する必要があります。 

Exclude Rule

HTTP リクエストの URI 属性を使用して比較することで、HTTP リクエスト条件を指定します。有効な条件はMethodURIHTTP ParameterHeader、および Cookie です。これらの要求の一致基準に基づいてトランザクションを分割できます。

HTTP Request Criteria

この HTTP リクエストの一致基準は、URI が /healthcheck であることを指定しています。 

Split Transaction Using Request

コントローラ UI を使用したカスタム POCO ビジネストランザクションの定義

.NET Agent for Linux を使用して、同期または非同期トランザクションと一致する POCO ビジネス トランザクション ルールを次の方法で作成できます。

  • メソッド名:
  • クラス名
これらの [Match Classes] オプションはドロップダウンリストに表示されますが、サポートされていません。ただし、UI で設定されている場合は、影響はありません。
  • that implements an interface which
  • that extends a super class that
  • that has an Annotation which
また、次の基準はサポートされていません。
  • メソッド/クラスデータを使用したトランザクション分割
  • バックグラウンドジョブ
  • インターフェイス、基本クラス、または注釈の POCO 条件

POCO ビジネストランザクション検出ルールの例

この例では、POCO エントリポイントを使用して、クラスが MyCompanyJobs.JobProcessor であり、メソッド名が OnEvent であるすべての要求を含める .NET エージェントのカスタム一致ルールを作成する方法を示しています。 

Custom Match Rule

このルール概要は、包含一致ルールを指定します。除外ルールを作成して、包含ルールによってモニタされるトランザクションの一部を省略する前に、包含ルールを作成する必要があります。 
Include Rule

[Match Classes] オプションの [with a Class Name that] を使用してクラスが一致するようにルールを設定できます。これは、.NET Agent for Linux でサポートされている [Match Classes] オプションのみです。 
Match Classes

この [Match Class & Method] は、クラス名が MyCompanyJobs.JobProcessor であり、メソッド名が OnEvent であるクラスと一致するように、一致基準を指定しています。 

トランザクション分割は、.NET Agent for Linux ではサポートされていません。