AppDynamics .NET エージェントをインストールした後、モニタリングするアプリケーションの種類に応じてエージェントを構成します。

単一サーバーで、IISアプリケーション、Windowsサービス、スタンドアロンアプリケーションの任意の組み合わせをインストゥルメント化できます。最初に構成ユーティリティを実行して IIS を構成し、その後に Windows サービスおよびスタンドアロン アプリケーション用の手順に従います。

AppDynamics エージェント構成ユーティリティを使用して、インストール後すぐにエージェントを構成するか、既存のエージェント構成に変更を加えます。ユーティリティは、一度に 1 台のマシンに対してエージェントを構成します。

.NETエージェント構成の準備

  • Windows 用 .NET エージェントのインストールを使用して無効にすることができます。
  • インストールタイプに基づいて、次のアカウントログイン情報が必要です。
    • シングルテナント:ライセンス表示レベルのアカウント権限を持つロールのメンバーシップ。詳細については、Create and Manage Custom Rolesを参照してください。
    • マルチテナントまたは SaaS:自分のアカウントのログイン情報が含まれている AppDynamics ウェルカムメール。
  • Ant、VS 2010パフォーマンスツールなど、既存のプロファイラをアンインストールします。既存のプロファイラがある場合、構成ユーティリティによってアラートが表示されます。
  • ティアの命名スキームを決定します。

構成を適用するには、構成ユーティリティによって IIS を再起動する必要があります。ユーティリティからIISを再起動するかが確認されます。再起動しない場合、次回IISを再起動させると構成が適用されます。

ファイルシステムセキュリティ設定

次の Windows アカウントには、特別なファイルシステム権限が必要です。

  • アプリケーションプールまたは Windows サービスアカウントで定義された、Web アプリケーションの実行に使用するアカウント。
  • AppDynamicsエージェントコーディネータの実行に使用するアカウント。デフォルトは、ローカルシステムアカウントです。

必要な権限は次のとおりです。

  • .NET アプリケーション エージェント ログのディレクトリへの書き込み権限。
    デフォルト:Windows Server 2008 以降: %ProgramData%\AppDynamics\DotNetAgent\Logs
  • .NET アプリケーション エージェントのインストールディレクトリへの読み込み権限と実行権限。
    デフォルト:C:\Program Files\AppDynamics\AppDynamics .NET Agent
  • Web アプリケーションのインストールディレクトリへの読み込み権限と実行権限。
    例: C:\inetpub\wwwroot\myapp

.NETエージェントの構成

  1. エージェント構成ユーティリティを開始します。[Windows] ペインで、AppDynamics > .NET Agent > AppDynamics Agent Configuration を選択します。
    警告メッセージが表示される場合、[Yes] をクリックして終了し、既存のプロファイラをアンインストールします。

    レジストリエディタを使用し、Windows レジストリでアンインストールプロセスによってレジストリエントリがクリーンアップされたことを確認します。警告メッセージを確認して、削除されなかったプロファイラ環境変数を特定します。「.NET エージェントの問題のトラブルシューティング」を参照してください。

  2. 構成ユーティリティが、.NET エージェント 3.7.7 以前のレガシーエージェント構成を検出した場合、[Upgrade Configuration] ペインが表示されます。次のいずれかを選択します。
    • Yes を選択し、レガシー構成を削除します。「Windows 用 .NET エージェントのアップグレード」を参照してください。

      レガシー構成を削除すると web.config ファイルが変更されるため、IIS は影響を受けるアプリケーションを再起動します。

    • [No] を選択し、レガシー構成を保持します。
    ユーティリティによって、競合するプロファイラはないと判断された場合、または構成クリーンアップの後、[Welcome] ペインが表示されます。
  3. [Log directory permissions] ペインで、ログディレクトリの場所を変更することもできます。[Change] をクリックして、新しい場所を選択します。
  4. 必要に応じて、ログディレクトリの権限を付与するアカウントを入力します。Add をクリックします。警告メッセージが表示された場合は、システムでアカウントが有効であることを確認します。ウィザードによって、アカウントのリストが確認されます。
  5. [Controller Configuration] ペインで、コントローラアクセス情報とログイン情報を入力します。
    • AppDynamics エージェント構成ユーティリティがサポートするのは、1 つのサーバにつきコントローラ 1 つとビジネスアプリケーションの構成のみです。
      • ティアを使用して、単一のサーバーでインストゥルメント化するさまざまなアプリケーションを編成します。または
      • 複数のビジネスアプリケーションへのサポートを手動で構成します。詳細については、.NETの複数ビジネスアプリケーションサポートの構成を参照してください。
    • コントローラのサーバ名または IP とポート番号を入力します。
    • シングルテナントアカウントの場合は、アカウントのアクセスキーを入力します。ログイン情報は、コントローラの Settings > License で表示できます
    • マルチテナントアカウントの場合は、[Multi-Tenant Controller] をクリックします。 AppDynamics 用のアカウント名とアカウントのアクセスキーを入力します。 
    • 安全な接続を確立するには、[Enable SSL] をクリックします。
      • 信頼できる証明書でコントローラを確実に保護します。詳細については、.NETエージェント用SSLの有効化を参照してください。
      • SSL を有効化すると、エージェントはアプリケーションで ServicePointManager.SecurityProtocol に設定されたプロトコルを使用してコントローラへの通信を保護します。
      • デフォルトで構成ユーティリティは TLS 1.2 を有効化するため、安全なプロトコルリストの最初の選択肢になっています。これはAppDynamicsコントローラへのリクエストだけでなく、アプリケーションからの安全な通信すべてに影響。TLS 1.2 を無効にするには、このオプションの選択を解除します。
    • 必要に応じて、HTTP プロキシ情報を入力します。認証を使用するプロキシの場合は、追加の構成が必要になります。 
  6. Test Controller Connection をクリックして、接続を確認します。
    [Application Configuration] ペインに、コントローラの既存のビジネスアプリケーション情報とコントローラ接続ステータスが表示されます。
  7. 次のように、コントローラのビジネスアプリケーションを構成します。
    • すでにコントローラにビジネスアプリケーションがある場合は、Existing Applications from the Controller をクリックして、該当するビジネスアプリケーションをクリックします。コントローラでビジネスアプリケーションを定義していない場合、ユーティリティには空のリストが表示されます。
    • New Application をクリックして、新しいビジネスアプリケーションを定義します。スペリングと大文字小文字について注意し、正確な名前をメモしてください。アンパサンドは、アプリケーション名に使用できません。
    • コントローラで構成管理を使用する場合、[ Register Machine with No Application] をクリックします。
  8. [Next ] をクリックし、[Assign IIS applications to tiers] に進むと、ティア命名オプションのいずれかを使用できます。

IISティアに自動的に名前を付ける

  1. [Assign IIS applications to the tiers] ペインで、[Automatic] をクリックします。
  2. プロンプトが表示されたら、OK をクリックして自動構成の確認を行います。構成ユーティリティは構成設定を要約します。
  3. デフォルトでは、[Next] をクリックすると、構成ユーティリティによって IIS が再起動されます。

    すぐには構成を適用しない場合、ボックスのチェックマークを外します。エージェント構成ユーティリティによって情報が保存され、次回IISが再起動されるときに適用されます。

  4. 先に進み、Next をクリックすると、構成ユーティリティは、IIS の停止や再起動などのアクティビティを記録し、問題を報告します。赤い文字で示される問題のサマリを確認します。緑の文字は、記録されたイベントを示します。サマリは警告(W)とエラー(E)を表示します。
  5. Done をクリックします。 

IIS ティアの手動命名

  1. [Assign IIS applications to the tiers] ペインで、[Manual] をクリックして、[Next] をクリックします。
  2. IIS アプリケーションを AppDynamics ティアに割り当てるには、右側のティアと左側のビジネスアプリケーションを選択します。ユーティリティによって、割り当てられたティアが太字で強調表示します。

    大規模なIISインストレーションには、Max IISツリー構造プルダウンを使用してすべてのプロジェクトを表示します。大規模なツリー構造の場合、表示されるまで多少時間がかかることがあります。

    新しいティアを作成するには、名前を入力し Add Tier をクリックします。

  3. 作業が完了したら、Next をクリックします。 
  4. IIS をすぐには再起動しない場合、[Configuration Summary] ペインで [Restart IIS] のチェックマークをオフにします。後で再起動して変更を適用することも、リブート後に自動的に変更が適用されるようにすることもできます。
  5. 先に進み、Next をクリックすると、構成ユーティリティは、IIS の停止や再起動などのアクティビティを記録し、問題を報告します。
  6. 構成ログのサマリを確認します。構成を適用すると、AppDynamicsは構成アクティビティのログを生成し、サマリを表示します。赤い文字で示される問題のサマリを確認します。緑の文字は、記録されたイベントを示します。サマリは警告(W)とエラー(E)を表示します。
  7. 完了したら、[Next] をクリックします。ウィザードが終了します。

構成管理の使用

  1. [Assign IIS applications to the tiers] ペインで、[Register Machine with No Application] をクリックして、[Next] をクリックします。
  2. IIS をすぐには再起動しない場合、[Configuration Summary] ペインで [Restart IIS] のチェックマークをオフにします。後で再起動して変更を適用することも、リブート後に自動的に変更が適用されるようにすることもできます。
  3. .NET構成の管理」の手順に従って、コントローラから構成を割り当てます。.NET エージェントや .NET マシンエージェントは、構成管理ツールを使用して構成を割り当てない限り、メトリックをコントローラへ報告しません。

.NET エージェントの問題のトラブルシューティング」を参照してください。