.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 エージェントは構成管理に登録されません。マシン名が重複すると、予期しない結果が生じる可能性があります。

構成ファイルの識別

コントローラで構成の管理を開始するには、アップロードする構成ファイルまたは構成ファイルのセットを指定します。ユーザーが .NET エージェント構成に精通していない場合、Cisco AppDynamics ではエージェントを構成するために、各マシンでエージェント構成ユーティリティを使用することが推奨されています。 「.NET エージェントの管理」 および 「.NET エージェントの構成」を参照してください。

構成プロパティの完全なリストについては、「.NETエージェントの構成プロパティ」を参照してください。

  • Cisco AppDynamics のエージェント構成ユーティリティで構成した config.xml ファイルを、XML の有効性の確認に使用します。
  • 同様のマシンにまったく同じ構成が必要な場合は、以前に構成したマシンの config.xml ファイルをテンプレートとして使用します。

設定のインポート

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

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

マシンへの構成の割り当て

構成管理ツールを使用すると、マシンを構成に割り当てたり、その構成を別のマシンへ変更できます。コントローラで構成を割り当てると、.NETエージェントが構成ファイルを自動的にダウンロードします。

マシンに管理対象の構成がない場合、そのマシンは構成管理ツールではテンプレートが割り当てられていないマシンの後にこのマシンが表示されます。

注: Cisco AppDynamicsAgent 構成ユーティリティの [アプリケーション構成（Application Configuration）] ペインで [アプリケーションなしでマシンを登録（Register Machine with No Application）] オプションを選択すると、コントローラではこのマシンが [マシン（Machines）] セクションで割り当てられたテンプレートなしで表示されます。
  1. ドラッグアンドドロップで、マシンに構成を割り当てる。

    .NETエージェントにより、構成の更新が毎分チェックされる。

    エージェントは、古い config.xml ファイルを econfig ディレクトリのバックアップ サブディレクトリに config-<date>.xml としてバックアップします。「.NET エージェントディレクトリ構造」を参照してください。

    エージェントが無効な config.xml ファイルを検出した場合、管理対象の構成を適用せず、コントローラでエージェント構成エラーイベントを発生させます。イベントサマリに影響を受けたティアとノードを表示。

    管理された構成内のコントローラ接続情報に関わらず、エージェントは既存のコントローラ接続情報を常に保持。

    割り当てられた構成をエージェントが受信し認証すると、アプリプールのリサイクルまたはIIS再起動後、あらゆる変更が実行される。

  2. Windows サービスまたはスタンドアロン アプリケーションを再起動する必要があります。Cisco AppDynamicsAgent コーディネータ サービスを再起動する必要はありません。

構成管理のオプトアウト

コントローラから構成ファイルを受信しないようにエージェントを構成するには、enable_config_ deployment false config.xml .NET エージェント構成プロパティを設定します。

例：

<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サービス、インストゥルメント化されたスタンドアロンアプリケーションを再起動。