アプリケーションエージェント - スタンドアロンアプリケーションエレメント

standalone-applications エレメントは、app-agents エレメントの子エレメントです。インストルメンテーション用に構成する Windows サービスおよびスタンドアロン アプリケーションのコンテナエレメントです。「Windows サービスとスタンドアロン アプリケーションの .NET エージェントの構成」を参照してください。

任意のエレメント： <standalone-applications>

スタンドアロンアプリケーションエレメント

standalone-application エレメントは、standalone-applications エレメントの子エレメントです。インストルメンテーションを行うWindowsサービスまたはスタンドアロンアプリケーションを指定します。

任意のエレメント： <standalone-application executable="MyWindowsApplication.exe" command-line="">

スタンドアロンアプリケーション実行ファイル属性

standalone-application executable 属性でインストゥルメント化する Windows アプリケーションのファイル名を指定します。スタンドアロン アプリケーション エレメントの実行可能属性を次のいずれかに設定します。

  • 実行可能ファイル名：MyStandaloneApp.exe や MyWindowsService.exe など。ファイル拡張子はオプションであるため MyStandaloneApp も同様に機能します。

  • 実行可能ファイルへのフルパス：C:\Program Files\MyApplicationMyStandaloneApp.exe など。
  • 実行可能ファイルへの部分パス：MyApplication\MyStandaloneApp.exe など。異なるパスから実行している同じ実行可能ファイルのインスタンスごとに異なるティアを割り当てる場合は、実行可能ファイルへの完全パスまたは部分的なパスを使用。

タイプ：文字列

デフォルト：[なし（None）]

要否: 要

スタンドアロンアプリケーションコマンドライン属性

同じ実行可能ファイルの 2 つのインスタンスを区別するには、standalone-application command-line 属性でアプリケーションのコマンドラインの独自の部分（引数など）を指定します。

タイプ：文字列

デフォルト：[なし（None）]

必須：いいえ

スタンドアロンアプリケーションapp-domain-name属性

複数のアプリケーションドメインを持つアプリケーションの場合、app-domain-name 属性を使用してインストゥルメンテーションを特定のアプリケーションドメインに制限できます。「アプリケーション ドメイン モニタリングの構成」を参照してください。

タイプ：文字列

デフォルト：[なし（None）]

必須：いいえ

スタンドアロンアプリケーション ティア エレメント

tier エレメントは、standalone-application エレメントの子エレメントです。アプリケーションのインストゥルメンテーションを有効にする場合は、コントローラで tier エレメントを使用して、アプリケーションをティアに割り当てる必要があります。「アプリケーションモニタリングの概要」を参照してください。

必須エレメント： <tier name="Consumer" />

ティア名属性

tier name 属性は、ビジネス アプリケーション ティアを示します。

タイプ：文字列（環境変数も参照する場合があります）「環境変数の参照」を参照してください。

デフォルト：[なし（None）]

要否: 要

環境変数：APPDYNAMICS.AGENT.TIERNAME

Windowsサービスとスタンドアロンアプリケーション構成のサンプル

CODE 
<standalone-applications>
      <standalone-application executable="ExampleApplication.exe">
        <tier name="Standalone Application Tier"/>
      </standalone-application>
      <!-- Instrument a Windows service using arguments. -->
      <!-- The following example matches the command "MyWindowsService.exe -d -x -r". -->
      <standalone-application executable="MyWindowsService.exe" command-line="-x">
        <tier name="Windows Service Tier"/>
      </standalone-application>
    </standalone-applications>