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

Windows 上で実行されているアプリケーションをモニターする場合は、Windows 用 Splunk AppDynamics .NET Core マイクロサービスエージェントをプロジェクトにインストールします。また、MSI インストーラを使用して、.NET スタンドアロンサービスまたは IIS サービスをインストゥルメント化できます。次に、コントローラの環境変数を設定します。

エージェントが機能することを確認するには、<appfolder>\<appdll>.AppDynamicsConfig.json、<appfolder>\AppDynamicsConfig.json、または <profilerpath>\AppDynamicsConfig.json のいずれかの .NET エージェントのプロービングパスにあるデフォルトの AppDynamicsConfig.json ファイルが必要です。アプリケーションの dll 名には、.dll または .exe 拡張子を付けないでください。AppDynamicsConfig.json ファイルをアプリケーションフォルダに配置すると、そのアプリケーションをモニターする必要があることがプロファイラに通知されます。この制限は、Windows マシン上で複数のアプリケーションがインストゥルメント化されないようにするために設けられています。現在、Linux ではこの制限はありません。

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

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

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

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

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

プロジェクトで AppDynamics.Agent.Windows NuGet パッケージをインストールします。IDE ドキュメントを参照してください。
NuGet パッケージをインストールすると、AppDynamicsConfig.json ファイルがプロジェクトのルートディレクトリにコピーされます。プロジェクト名から始まるリンクファイルは、プロジェクトにコンテンツとして含まれています。すべてのファイルは、ビルド後にアプリケーションの出力ディレクトリにコピーされます。

システムアプリケーションに次の環境変数を設定します。

CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={39AEABC1-56A5-405F-B8E7-C3668490DB4A}
CORECLR_PROFILER_PATH_32=<actual_path>\AppDynamics.Profiler_x86.dll
CORECLR_PROFILER_PATH_64=<actual_path>\AppDynamics.Profiler_x64.dll

<actual_path> は、AppDynamics.Profiler dll への完全なパスです。

ソリューションエクスプローラで、コントローラ情報を使用して <your app>/AppDynamicsConfig.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"
  }
}

JSON

コントローラへ接続する .NET エージェントを構成する場合は、次のオプションを使用します。
- 開発時：前のスクリーンショットで示したように、AppDynamicsConfig.json ファイルに環境変数を入力し、ソースコントロールに保存できます。
- ビルド中：ビルド時に AppDynamicsConfig.json ファイルに渡される msbuild パラメータまたは環境変数を定義します。AppDynamicsConfig.json ファイルはビルド時には存在しないため、msbuild パラメータまたは環境変数をビルド時に定義する場合は、新しい AppDynamicsConfig.json ファイルを作成できるように、ソースコントロールでこれを無視する必要があります。
- ランタイム時：Azure で環境変数を入力します。
アプリケーションをデプロイします。

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

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

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

IIS のインプロセスホスティングを使用する場合は、<AppDynamicsUseCatchAllConfig>True</AppDynamicsUseCatchAllConfig> プロパティを csproject に追加します。これにより、構成は AppDynamicsConfig.json という名前になります。

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

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

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

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

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