.NET Agentは、1 つの構成ファイルを使用して、エージェントの動作と .NET マシンエージェントの動作を制御します。構成ファイルを使用して、コントローラの接続、.NET マシンエージェントの動作、および IIS アプリケーション、Windows サービス、およびスタンドアロン アプリケーション用のアプリケーション エージェント機能を指定します。単一の構成ファイルを使用すると、次のことが可能になります。

  • web.config ファイルとは独立してエージェント構成を管理。
  • 環境変数なしの Windows サービスとスタンドアロン アプリケーションのインストゥルメント化。
  • 階層的な構成を持つ特定のアプリケーションのエージェント動作を管理。

AppDynamics コントローラを使用すると、.NET エージェント構成ファイルのアップロードおよび管理ができます。エージェントをインストールするマシンまたは複数のマシンにコントローラから構成をデプロイできます。詳細については、.NET構成の管理を参照してください。

エージェントプロパティの構成

エージェントの Config ディレクトリの config.xml ファイルでエージェントプロパティを構成します。config.xml を編集するには、管理者としてエディタを起動する必要があります。.NET エージェント構成ユーティリティを実行すると、次のいずれかの場所に config.xml ファイルが書き込まれます。

  • Windows Server 2008以降
    %ProgramData%\AppDynamics\DotNetAgent\Config\config.xml
  • Windows Azure
    Windows Azure の展開の場合、.NET エージェント NuGet パッケージには config.xml ファイルが含まれています。
    サンプル config.xml ファイルを次の場所にインストールします。
    %ProgramFiles%\AppDynamics\AppDynamics .NET Agent\SampleConfigurations

    config.xml ファイルを編集したら、AppDynamics.Agent.Coordinator サービスを再起動する必要があります。次に IIS サービス、Windows サービスまたはスタンドアロン アプリケーションを再起動して、インストゥルメンテーションの変更を有効にします。

次のファイルでの .NET エージェント動作のカスタマイズ: config.xml

一部の .NET Agent構成では config.xml の編集が必要な場合があります。

  1. AppDynamics.Agent.Coordinator サービスをシャットダウン。
  2. 管理者として config.xml ファイルを編集。

  3. 構成の指示に従ってXMLファイルを修正。

  4. config.xml ファイルを保存。

  5. AppDynamics.Agent.Coordinator サービスを開始します。
  6. 場合によって、IIS、インストゥルメント化された Windows サービス、またはインストゥルメント化されたスタンドアロン アプリケーションの再起動が必要。個々の .NET Agent管理のトピックを参照してください。

最小の例: config.xml

最も基本的な構成によって、エージェント構成に必須のセクションがわかります。この例では、自動エレメント(<automatic />)を使用してすべての IIS アプリケーションをインストゥルメント化します。この例の場合、AppDynamics は Windows サービスやスタンドアロン アプリケーションをインストゥルメント化しません。

<?xml version="1.0" encoding="utf-8"?>
<appdynamics-agent xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <controller host="mycontroller.mycompany.com" port="8090" ssl=false">
    <application name="MyDotNetApplication" />
	<account name="customer1" password="changeme" />
  </controller>
  <machine-agent />
  <app-agents>
 
    <IIS>
      <automatic />
    </IIS>
 
  </app-agents>
</appdynamics-agent>
CODE

エージェントログファイル

次に示すのは、 .NET Agentのログファイルを制御する構成ファイルの場所です。

%ProgramFiles%\AppDynamics\AppDynamics .NET Agent\AppDynamicsAgentLog.config
CODE

構成ファイルは、NLog 構成フォーマットを使用します。