プレビュー
この機能はまだ開発中ですが、ぜひお試しください。
質問やフィードバックがある場合、または .NET エージェントのInstrumentationエディターのプレビュー中にサポートが必要な場合は、 dotnet-li-editor-beta@newrelic.comまでメールをお送りください。
この機能は現在、弊社のプレリリース ポリシーに従ってプレビュー プログラムの一部として提供されています。
Instrumentation エディターを使用すると、.NET アプリ ユーザーは、インストゥルメントされたアプリケーションを再起動せずに、 New Relicユーザー インタフェースからカスタム インストゥルメントを実装できます。 このエディター:
- 権限のあるユーザーが、ローカルのXMLファイルではなく、New Relic UIからカスタムインスツルメンテーションを編集できるようになります。
- カスタム・インスツルメンテーション・スキーマを検証します。
- アプリケーションのコードやアプリケーションを実行するホストにアクセスできないお客様のためのオプションです。
要件
Instrumentationエディターを使用するには、次の要件を満たす必要があります。
Requirements | Comments |
|---|---|
エージェント | .NETエージェントバージョン7.0.2以上 |
オーナーまたは管理者 | |
セキュリティ | 高セキュリティ モードのユーザーは、 Instrumentationエディターを使用してアプリのインストゥルメンテーションを更新できません。 |
カスタムインストゥルメンテーションの定義
one.newrelic.com > All capabilities > APM & services > (select a .NET app) > Settings > Instrumentation: Instrumentation エディターを使用すると、 UIでカスタム インストゥルメンテーションを簡単に表示または編集できます。 この XML の例には、アセンブリ名、クラス名、およびメソッド名が表示されます。
重要
ライブインスツルメンテーションを導入すると、一時的にオーバーヘッドが大きくなります。これにより、アプリケーションのリクエストが数秒間、明らかに遅くなることがあります。
Instrumentationエディターを使用するには:
one.newrelic.com > All capabilities > APMに移動します。 アプリを見つけて、 Settings > Instrumentationをクリックします。
Instrumentationエディターを使用して、ローカルの .xml インストゥルメンテーション ファイルの編集とインストゥルメンテーションの詳細の追加について説明したのと同じ構文を使用して XML を提供します。 UI から次のいずれかのオプションを使用します。
XMLコードを直接入力します。
コードをコピーして、クリップボードから貼り付けてください。
Download Sample XML
をクリックして、開始点としてサンプル インストゥルメンテーション ファイルを作成します。
.xmlをアップロードする
Choose file
を選択してファイルを開きます。 例については、 「Example MyInstrumentation.xml」を参照してください。
Instrumentationエディターは、入力した XML コードを検証します。 エディターの外部で XML 検証を実行するには、 Download XSDを選択し、お気に入りの XML 検証ツールで XSD ファイルを使用して問題を診断します。
変更をデプロイするには、 Submitを選択します。
測定結果を見る
.NET エージェントは、数回の収集サイクル(通常は数分) 以内に新しいインストゥルメンテーションを開始します。 Instrumentation UI のCurrent instrumentationセクションには、適用された変更のステータスが表示されます。
Instrumentationエディターからの XML は、エージェントを実行しているマシン上のローカル インストゥルメンテーション ファイルに存在する XML と結合されます。 エージェントは、最終的な (結合された) XML の変更を定期的に検索し、エージェントまたはアプリケーションを再起動することなく、変更を動的に取得します。