.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
    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 を更新します。
    {
    "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 を更新します。ノードを指定しないでください。自動的に割り当てられます。ティアの指定
      {
      "controller":
      {
      "host":"",
      "port":0,
      "account":"",
      "password":""
      },
      "application":
      {
      "name":""
      }
      }
      ティアの指定はオプションです。これは自動的に割り当てることができます。
  4. システムアプリケーションに次の環境変数を設定します。ここで、<actual_path> AppDynamics Profiler dll
    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 という名前になります。