.NET構成の管理

大きくスケーリング拡大された環境では、同じ .NET アプリケーションを実行する複数のマシンに同じ .NET エージェント構成が使用されることが多くなります。複数のマシンに対して手動で構成を更新すると、手間がかかり、エラーが発生しやすい可能性があります。

.NET エージェントの ファイルのアップロードと管理には、コントローラの構成管理ツールを使用します。

ご使用のマシンの .NET エージェント構成に関するすべてのファイルの管理は、[Settings] > [Agent Management] > [Manage Agents] > [Config Management] をクリックして行います。

要件

  • 「ユーザー、グループ、役割、認証などの管理」などアカウントレベルの権限を伴う役割におけるメンバーシップ。
  • 有効な config.xml 構成ファイル。構成管理ツールは config.xml ファイルを検証しない。
  • 構成を展開するマシンにインストールされた .NET エージェント 4.1 以降。

Web ロールと Worker ロールのマシン名が必ずしも固有ではないため、Splunk AppDynamics の NuGet パッケージを使用して Azure Cloud Services に展開された .NET エージェントは構成管理に登録されません。マシン名が重複すると、予期しない結果が生じる可能性があります。

Identify the Configuration File

To start managing your configurations in the Controller, identify a configuration file or set of configuration files to upload. If you are not familiar with .NET Agent configuration, Cisco AppDynamicsrecommends you use the Agent Configuration Utility on each machine to configure the agent. See Administer the .NET Agent and Configure the .NET Agent.

For a full list of configuration properties, see .NET Agent Configuration Properties.

  • Use config.xml files configured with the Cisco AppDynamics Agent Configuration Utility to help ensure the XML is valid.
  • Use the config.xml file from a previously configured machine as a template for similar machines that need the exact same configuration.

設定のインポート

[設定のインポート（Import Config）] ダイアログで、config.xml をアップロードできます。

  • 命名規則を使用して、構成するマシンのタイプを識別。
  • 構成名には、日付とバージョンのスキームを使用すると有用。
  • 構成をクリックして、[設定の編集（Edit Config）] をクリックし、構成名を変更します。
  • 構成をダブルクリックしてXMLを表示。XMLはコピー可、変更は不可。

Assign Configuration to Machines

The Config Management tool enables you to assign machines to a configuration, or change the configuration from one to another. After you assign the configuration in the Controller, the .NET Agent automatically downloads the configuration file.

If a machine does not have a managed configuration, the Config Management tool displays it following Machine with no assigned templates

注: If you select the Register Machine with No Application option on the Application Configuration pane in the Cisco AppDynamicsAgent Configuration utility, the Controller lists the machine in the Machines section with no assigned templates.
  1. Drag and drop to assign a machine to a configuration.

    The .NET Agent checks for updated configurations every minute.

    The agent backs up the old config.xml file as config-<date>.xml in the backup subdirectory of the econfig directory. See .NET Agent Directory Structure.

    If the agent detects an invalid config.xml file , it does not apply the managed configuration and it raises an Agent Configuration Error event in the Controller. The event summary indicates the affected tiers and nodes.

    Regardless of the Controller connection information in the managed configuration, the agent always retains existing Controller connection information.

    After the agent receives and validates the assigned configuration, any changes take effect after the app pools recycle or IIS restarts.

  2. You must restart Windows services or standalone applications. It is unnecessary to restart the Cisco AppDynamicsAgent Coordinator service.

Opt Out of Configuration Management

To configure an agent so that it does not receive configuration files from the Controller, set the enable_config_ deployment false config.xml .NET Agent Configuration Properties.

For example:

<controller host="mycontroller.saas.appdynamics.com" port="443" ssl="true" enable_config_deployment="false">

古い構成の復元

誤って構成を割り当ててしまった場合、次の手順で前バージョンの config.xml を復元できます。

  1. [設定の管理（Config Management）] ペインで、現在割り当てられている構成から [テンプレートが割り当てられていないマシン（Machine with no assigned templates）] にマシンをドラッグ。
  2. そのマシン上で、既存の構成ファイルの名前 config.xml を config.old.xml などに変更します。
  3. バックアップのサブディレクトリから Config ディレクトリにバックアップ構成ファイルをコピーします。バックアップファイルの名前は、config-<date>.xml のフォーマットで指定します。
  4. バックアップ構成ファイルの名前を config.xml に変更します。
  5. オプションで、config.xml を編集して構成管理からオプトアウトできます。
  6. Cisco AppDynamicsAgent コーディネータサービスを再起動。
  7. Windowsサービス、インストゥルメント化されたWindowsサービス、インストゥルメント化されたスタンドアロンアプリケーションを再起動。