.NET Coreマイクロサービスエージェントのインストール

.NET Core マイクロサービス エージェントをインストールする前に、アプリケーションメトリックが表示されるコントローラへのアクセス権を持っていることを確認してください。

次のいずれかの方法を使用して、.NET Core マイクロサービス エージェントを展開できます。

  • IDE および Visual Studio を使用して、開発時に .NET Core マイクロサービス エージェントを展開する
  • .NET Core マイクロサービス エージェントを別々の開発チームに個別に展開して、制御、パイプライン、および CI/CD プロセスを分割する

開発時に .NET Core マイクロサービス エージェントを展開する

  1. AppDynamics.Agent.Windows をインストールします。NuGet パッケージをインストールする場合は、AppDynamicsConfig.json
  2. システムアプリケーションに次の環境変数を設定します。ここで、<actual_path> AppDynamics Profiler
    CODE 
    CORECLR_ENABLE_PROFILING=1CORECLR_PROFILER={39AEABC1-56A5-405F-B8E7-C3668490DB4A}CORECLR_PROFILER_PATH_32=<actual_path>\AppDynamics.Profiler_x86.dllCORECLR_PROFILER_PATH_64=<actual_path>\AppDynamics.Profiler_x64.dll
  3. ソリューション エクスプローラで、<your app>/AppDynamicsConfig.json を更新します。
    JSON 
    {
"controller": {
"host": "PUT_YOUR_VALUE_HERE",
"port": 0,
"account": "PUT_YOUR_VALUE_HERE",
"password": "PUT_YOUR_VALUE_HERE",
"ssl": false,
"enable_tls2": false
},
"application": {
"name": "PUT_YOUR_VALUE_HERE",
"tier": "PUT_YOUR_VALUE_HERE",
"node": "PUT_YOUR_VALUE_HERE"
}
}
  4. コントローラへ接続する .NET エージェントを構成する場合は、次のオプションを使用します。
    • 開発時：前のスクリーンショットに示されているように、AppDynamicsConfig.json ファイルに環境変数を入力し、ソースコントロールに保存できます。
    • ビルド時：ビルド時に AppDynamicsConfig.json ファイルに渡される msbuild パラメータまたは環境変数を定義します。AppDynamicsConfig.json ファイルはビルド時には存在しないため、msbuild パラメータまたは環境変数をビルド時に定義する場合は、新しい AppDynamicsConfig.json ファイルを作成できるように、ソースコントロールでこれを無視する必要があります。
    • ランタイム時：Azure で環境変数を入力します。
  5. アプリケーションをデプロイします。

.NET Core マイクロサービス エージェントを別々の開発チームに個別に展開する

この展開方法を使用すると、制御、パイプライン、および CI/CD プロセスを個々の開発チームに分割できます。また、プロジェクトソリューションに戻ってエージェントを追加できない場合もあります（特にソフトウェアがサードパーティによって開発された場合）。

  1. nuget.org で、NuGet パッケージ AppDynamics.Agent.Distrib.Micro.Windows を https://www.nuget.org/packages/AppDynamics.Agent.Distrib.Micro.Windows/ からダウンロードします。
  2. Nuget パッケージの dlls および AppDynamicsConfig.json 構成ファイルをフォルダに解凍（unzip）します。
  3. 必要に応じて、AppDynamicsConfig.json 構成ファイルを更新します。
    1. AppDynamicsConfig.json servicefabricapplicationname AppDynamicsConfig.json のコピーを作成します。<<executable name>>
    2. AppDynamics.Agent.dll AppDynamics.Profiler_x64.dll AppDynamicsAgentLog.config AppDynamicsConfig.json nuget_package \content\AppDynamics をコピーします。
    3. AppDynamicsConfig.json のコピーを作成して、<<executable_name>>.AppDynamicsConfig.json <<servicefabricapplicationname 各サービスプロジェクトのルートに配置します。
      注: .json ファイルの名前をアプリケーション名に変更する場合は、アプリケーション名の末尾に .exe を付けないでください。
    4. Cisco AppDynamics サブフォルダ内のファイルを右クリックし、[常にコピー（Copy Always）] を選択します。
    5. <<executable_name>>.AppDynamicsConfig.json を更新します。ノードを指定しないでください。自動的に割り当てられます。ティアの指定
      JSON 
      {
"controller":
{
"host":"",
"port":0,
"account":"",
"password":""
},
"application":
{
"name":""
}
}
      ティアの指定はオプションです。これは自動的に割り当てることができます。
  4. システムアプリケーションに次の環境変数を設定します。ここで、<actual_path> AppDynamics Profiler dll
    CODE 
    CORECLR_ENABLE_PROFILING=1CORECLR_PROFILER={39AEABC1-56A5-405F-B8E7-C3668490DB4A}CORECLR_PROFILER_PATH_32=<actual_path>\AppDynamics.Profiler_x86.dllCORECLR_PROFILER_PATH_64=<actual_path>\AppDynamics.Profiler_x64.dll
    注: IIS のインプロセスホスティングを使用する場合は、 <AppDynamicsUseCatchAllConfig>True</AppDynamicsUseCatchAllConfig> プロパティを csproject に追加します。これにより、構成は AppDynamicsConfig.json という名前になります。