このドキュメントでは、Azure Service Fabric 用の .NET エージェントをインストールする方法について説明します。注: これは、Microsoft Azure のインフラストラクチャ統合をインストールすることと同じではありません。
Azure Service Fabricへの.NETエージェントのインストール
重要
ほとんどの場合、Azure Service Fabric 環境への .NET エージェントのインストールは、Windows または Linux の標準的なインストール手順を使用して実行できます。このドキュメントでは、エージェントをインストールするいくつかの代替方法について説明します。
クラスタ内のすべてのノードにエージェントがインストールされていることを確認する必要があります。複数のノードを監視する場合は、インストールをデプロイメントプロセスに統合するとよいでしょう。
Service Fabric 環境でコンテナーを使用している場合は、Docker のインストール手順を参照してください。
また、NuGet を使用して Service Fabric 環境にエージェントをインストールすることもできます。エージェントはアプリケーションと一緒にデプロイされるため、開発者にとっては NuGet が良い選択肢となります。ただし、NuGet を使用するには、手動でのインストール手順が必要です。 NuGetによるインストール を参照してください。
NuGetによるインストール
NuGetを使って.NETエージェントをインストールするには、以下の手順で行います。
標準の NuGet install の手順に従ってください。
NuGetを使用する場合は、いくつかの環境変数を設定する必要があります。これは、アプリケーションのServiceManifest.xml
ファイルで実行できます。以下の関連する手順を参照してください。
プロジェクトのServiceManifest.xml
ファイルで、 CodePackage
ノードの下に次のファイルを含めます。
<CodePackage Name="Code" Version="1.0.0"> </CodePackage>
<WorkingFolder>CodePackage</WorkingFolder>
<EnvironmentVariable Name="COR_ENABLE_PROFILING" Value="1" />
<EnvironmentVariable Name="COR_PROFILER" Value="{71DA0A04-7777-4EC6-9643-7D28B46A8A41}" />
<EnvironmentVariable Name="COR_PROFILER_PATH" Value=".\newrelic\NewRelic.Profiler.dll" />
<EnvironmentVariable Name="NEWRELIC_HOME" Value=".\newrelic" />
<EnvironmentVariable Name="NEW_RELIC_LICENSE_KEY" Value="YOUR_LICENSE_KEY" />
<EnvironmentVariable Name="NEW_RELIC_APP_NAME" Value="YOUR_APP_NAME" />
プロジェクトのServiceManifest.xml
ファイルで、 CodePackage
ノードの下に次のファイルを含めます。
<WorkingFolder>CodePackage</WorkingFolder>
<EnvironmentVariable Name="CORECLR_ENABLE_PROFILING" Value="1" />
<EnvironmentVariable Name="CORECLR_PROFILER" Value="{36032161-FFC0-4B61-B559-F6C5D41BAE5A}" />
<EnvironmentVariable Name="CORECLR_PROFILER_PATH" Value=".\newrelic\NewRelic.Profiler.dll" />
<EnvironmentVariable Name="CORECLR_NEWRELIC_HOME" Value=".\newrelic" />
<EnvironmentVariable Name="NEW_RELIC_LICENSE_KEY" Value="YOUR_LICENSE_KEY" />
<EnvironmentVariable Name="NEW_RELIC_APP_NAME" Value="YOUR_APP_NAME" />
プロジェクトのServiceManifest.xml
ファイルで、 CodePackage
ノードの下に次のファイルを含めます。
<WorkingFolder>CodePackage</WorkingFolder>
<EnvironmentVariable Name="CORECLR_ENABLE_PROFILING" Value="1" />
<EnvironmentVariable Name="CORECLR_PROFILER" Value="{36032161-FFC0-4B61-B559-F6C5D41BAE5A}" />
<EnvironmentVariable Name="CORECLR_PROFILER_PATH" Value="./newrelic/libNewRelicProfiler.so" />
<EnvironmentVariable Name="CORECLR_NEWRELIC_HOME" Value="./newrelic" />
<EnvironmentVariable Name="NEW_RELIC_LICENSE_KEY" Value="YOUR_LICENSE_KEY" />
<EnvironmentVariable Name="NEW_RELIC_APP_NAME" Value="YOUR_APP_NAME" />
.NET Frameworkの場合のみ: app.config
ファイルを編集し、 NewRelic.AgentEnabled
アプリ設定を追加します。
<add key="NewRelic.AgentEnabled" value="true" />
アプリケーションがトラフィックを生成している場合、データは数分で APM アカウントに表示されます。
データが表示されない場合は、次のトラブルシューティング手順を試してください。
- アプリのルートにある
newrelic
ディレクトリ内のすべてのファイルがAzureに公開されていることを確認してください。 - 環境変数が正しく設定されているか確認してください。
- 一般的なエラーを確認するには、一般的な トラブルシューティングのドキュメント を参照してください。