New Relicの.NETエージェントには、カスタムインストゥルメンテーション向けに複数のオプションがあります。カスタムインストゥルメンテーションを使用すると、自動でインストゥルメントされないアプリケーションの部分をインストゥルメントできます。このドキュメントでは、アプリケーションコードのメソッドを属性で装飾してアプリケーションをインストゥルメントする方法について説明します。
Transaction属性を使用して、カスタムトランザクションを作成します。また、属性のWebプロパティを使用して、カスタムトランザクションをウェブトランザクションとしてマークすることもできます。Trace属性を使用して、既存のトランザクション内で呼び出されるメソッドにカスタムインストゥルメンテーションを追加します。
要件および推奨
要件は、以下のとおりです。
- .NETエージェントのバージョン6.16.178.0またはそれ以降。
- ソースコードの修正が必要であることを了解しておいてください。ソースコードを変更できないか、またはそれを望まない場合は、XMLによるカスタムインストゥルメンテーションを使用します。
- プロジェクトには、
NewRelic.Api.Agent.dllへの参照が必要です（たとえば、パッケージをインストールし、コードにNewRelic.Api.Agent; を使用して配置します）。このパッケージは、NuGetギャラリーにあります。 Transaction属性とTrace属性は、メソッドの具体的な実装に適用する必要があります。インタフェースまたはスーパークラスのメソッド定義には適用できません。
トランザクション内で呼び出されたトランザクション
Transaction属性で装飾されたメソッドで新規トランザクションを作成するのは、既に存在するものがない場合に限られます。[Transaction]で装飾されたメソッドが、以前開始されたトランザクション内から呼び出された場合、[Trace]属性として処理され、既存トランザクションに関するより詳しい情報を提供します。
非ウェブトランザクションを新規作成する
Transaction属性を使用して、非ウェブトランザクション（バックグラウンド要求とも呼ばれます）を開始するには：
[Transaction]
public void Run()
{
// your background task
}ウェブまたは非ウェブのどちらを使用するか、およびその理由については、ウェブまたは非ウェブとして分類するをご覧ください。
ウェブトランザクションを新規作成する
非ウェブタスクをウェブブラウザのトランザクションとしてマークするようにエージェントに指示するには、以下のいずれかのオプションを使用します。
Transaction属性のWebプロパティをtrueに設定します。SetTransactionUri()を使用してトランザクションのURIを設定します。
[Transaction(Web = true)]
public void Run()
{
var uri = new Uri("http://www.mydomain.com/path");
NewRelic.Api.Agent.NewRelic.SetTransactionUri(uri);
// your web task
}以前開始されたトランザクション内で使用すると、これは[Trace]属性として処理されます。
ウェブまたは非ウェブのどちらを使用するか、およびその理由については、ウェブまたは非ウェブとして分類するをご覧ください。
Traceで既存のトランザクションに詳細を追加する
トランザクショントレースにインストゥルメントされていない時間のブロックが大量にあり、トレース内にメソッドを追加したい場合は、Trace属性を使用できます：
[Trace]
protected void MethodWithinTransaction()
{
// your app code
}[Transaction]のプロパティ
Transaction属性は、以下のプロパティをサポートします。
インストゥルメンテーションに関するフォーラムの投稿を読む
より具体的な推奨事項については、Explorers Hubコミュニティで以下の投稿を参照してください：
他のAPI機能を使用する
.NETエージェントAPIおよびその関数の詳細については、New Relicの.NETエージェントAPIガイドをご覧ください。ソースコードを変更しないカスタムインストゥルメンテーションについては、XMLによるトランザクションの作成とXMLによるトランザクションへの詳細の追加をご覧ください。