Azure Service Fabricへの.NETエージェントのインストール

このドキュメントでは、Azure Service Fabric 用の .NET エージェントをインストールする方法について説明します。注: これは、Microsoft Azure のインフラストラクチャ統合をインストールすることと同じではありません。

Azure Service Fabricへの.NETエージェントのインストール

Service Fabric 環境でコンテナーを使用している場合は、Docker のインストール手順を参照してください。

また、NuGet を使用して Service Fabric 環境にエージェントをインストールすることもできます。エージェントはアプリケーションと一緒にデプロイされるため、開発者にとっては NuGet が良い選択肢となります。ただし、NuGet を使用するには、手動でのインストール手順が必要です。 NuGetによるインストール を参照してください。

NuGetによるインストール

NuGetを使って.NETエージェントをインストールするには、以下の手順で行います。

1. 標準の NuGet install の手順に従ってください。

2. NuGetを使用する場合は、いくつかの環境変数を設定する必要があります。これは、アプリケーションのServiceManifest.xmlファイルで実行できます。以下の関連する手順を参照してください。

   .NET Framework

   プロジェクトのServiceManifest.xmlファイルで、 CodePackageノードの下に次のファイルを含めます。

   <CodePackage Name="Code" Version="1.0.0">  </CodePackage>
   <CodePackage>
     ...
     <EntryPoint>
       <ExeHost>
         ...
         <!-- It is important for the WorkingFolder to be set to CodePackage -->
         <!-- This is because the environment variables set below rely on this being the working folder for the agent to work -->
         <WorkingFolder>CodePackage</WorkingFolder>
         ...
       </ExeHost>
     </EntryPoint>
     ...
     <EnvironmentVariables>
       ...
       <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" />
       ...
     </EnvironmentVariables>
     ...
   </CodePackage>

   コピー

   .NET Core for Windows

   プロジェクトのServiceManifest.xmlファイルで、 CodePackageノードの下に次のファイルを含めます。

   <CodePackage>
     ...
     <EntryPoint>
       <ExeHost>
         ...
         <!-- It is important for the WorkingFolder to be set to CodePackage -->
         <!-- This is because the environment variables set below rely on this being the working folder for the agent to work -->
         <WorkingFolder>CodePackage</WorkingFolder>
         ...
       </ExeHost>
     </EntryPoint>
     ...
     <EnvironmentVariables>
       ...
       <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" />
       ...
     </EnvironmentVariables>
     ...
   </CodePackage>

   コピー

   .NET Core for Linux

   プロジェクトのServiceManifest.xmlファイルで、 CodePackageノードの下に次のファイルを含めます。

   <CodePackage>
     ...
     <EntryPoint>
       <ExeHost>
         ...
         <!-- It is important for the WorkingFolder to be set to CodePackage -->
         <!-- This is because the environment variables set below rely on this being the working folder for the agent to work -->
         <WorkingFolder>CodePackage</WorkingFolder>
         ...
       </ExeHost>
     </EntryPoint>
     ...
     <EnvironmentVariables>
       ...
       <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" />
       ...
     </EnvironmentVariables>
     ...
   </CodePackage>

   コピー

3. .NET Frameworkの場合のみ： app.configファイルを編集し、 NewRelic.AgentEnabledアプリ設定を追加します。

   <appSettings>
     ...
     <add key="NewRelic.AgentEnabled" value="true" />
     ...
   </appSettings>

   コピー

アプリケーションがトラフィックを生成している場合、データは数分で APM アカウントに表示されます。

データが表示されない場合は、次のトラブルシューティング手順を試してください。

• アプリのルートにあるnewrelicディレクトリ内のすべてのファイルがAzureに公開されていることを確認してください。
• 環境変数が正しく設定されているか確認してください。
• 一般的なエラーを確認するには、一般的な トラブルシューティングのドキュメント を参照してください。