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

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

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

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

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

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

  1. プロジェクトで AppDynamics.Agent.Windows NuGet パッケージをインストールします。IDE ドキュメントを参照してください。

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

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

    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 への完全なパスです。

  3. AppDynamicsConfig.json ファイルを開き、AppDynamics コントローラの情報でファイルを更新します。
    AppDynamics Config.json File

  4. AppDynamics コントローラへ接続する .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 ファイルのコピーを作成して、<<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. AppDynamics サブフォルダ内のファイルを右クリックし、[Copy Always] を選択します。

    5. 設定情報が含まれる <<executable_name>>.AppDynamicsConfig.json を更新します。

      {
       "controller":
       {
       "host":"",
       "port":0,
       "account":"",
       "password":""
       },
       "application":
       {
       "name":""
       }
      }

      ノードを指定しないでください。自動的に割り当てられます。ティア の指定はオプションです。これは自動的に割り当てることができます。詳細については、AppDynamicsConfig.json Fileを参照してください。

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

    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 への完全なパスです。