.NETの複数ビジネスアプリケーションサポートの構成

デフォルトでは、単一の Windows ホスト上のアプリケーションは、コントローラ内の 1 つのビジネスアプリケーションにマップされます。必要に応じて、手動で .NET エージェントを構成し、コントローラで同一の Windows ホスト上の複数のアプリケーションを、様々なビジネスアプリケーションにマップできます。

単一のホスト上のアプリケーションを別のビジネスアプリケーションにマップするには、 config.xml を手動で編集する必要があります。Splunk AppDynamics エージェント構成ユーティリティでは、この構成オプションは使用できません。

複数のアプリケーションサポートを構成すると、後で構成ユーティリティを使用して構成を変更することはできません。複数のアプリケーションサポートを構成したサーバで構成ユーティリティを起動すると、ユーティリティは構成を削除するよう促すプロンプトを表示します。

複数のビジネスアプリケーションを構成するための準備

.NET エージェントを構成する前に、エージェントをインストールする必要があります。Splunk AppDynamics エージェント構成ユーティリティを使用して、基本的な構成タスクを実行します。

ビジネスアプリケーションの整理方法を指定し、ビジネスアプリケーション名を指定します。たとえば、IIS を実行している Windows ホストがあるとします。IIS インスタンスは、Ticket Search と Travel Search という 2 つの異なる顧客に対して 2 つのアプリケーションを提供します。アプリケーションは同様の機能を実行しますが、個別に機能するため、それぞれモニタすることは理にかなっています。この場合は、アプリケーション名（Ticket Search Engine と Travel Search Engine）に基づいて 2 つのビジネスアプリケーションを作成します。
Windows マシンで IIS コンソールを開き、[接続（Connections）] > <アプリケーション名> > [サイト（Sites）] に移動します。
各サイトで、IIS アプリケーションまたはアプリケーションプール、Windows サービス、スタンドアロンアプリケーションをさまざまなビジネスアプリケーションの階層にマッピングします。たとえば、TicketSearch サイトを Ticket Search Engine ビジネスアプリケーションの Ticket Search Web ティアにマップします。TravelSearch サイトを Travel Search Engine ビジネスアプリケーションの Travel Search Web ティアにマップします。
まだインストールしていない場合は、.NET エージェントをインストールします。「Windows 用 .NET エージェントのインストール」を参照してください。
Splunk AppDynamics エージェント構成ユーティリティを実行して config.xml を生成し、コントローラ接続を構成します。「.NET エージェントの構成」を参照してください。
プロンプトが表示されたら、ティア生成と割り当ての方法として [手動（Manual）] を選択します。
注: 構成ユーティリティは 1 つのサーバにつき 1 つのビジネスアプリケーションのマッピングのみをサポートします。

.NETエージェントの手動構成

.NET エージェントのコントローラのプロパティを構成したら、config.xml で .NET アプリケーションをインストゥルメント化します。

管理者として config.xml ファイルを開き、ファイルを編集します。「.NET エージェントの管理」の「エージェントプロパティの構成場所」を参照してください。
controller applications ブロックをコピーして、controller エレメントの子要素として貼り付けます。既存の <applications> または <application> エレメントを置き換えます。
```

<applications>
<application name="ApplicationName1" default ="true"/>
<application name="ApplicationName2"/>
</applications>
```
コントローラで各ビジネスアプリケーションの application エレメントを追加します。
- application エレメントの name 属性を、コントローラのビジネスアプリケーション名と一致するように編集します。アプリケーションがまだ存在しない場合は、コントローラがそのアプリケーションを作成します。
- 1 つの application エレメントで default 属性を true に設定します。エージェントにより、IIS アプリケーション、Windows サービス、またはスタンドアロンアプリケーション構成にビジネスアプリケーション名と一致する名前が見つからない場合、ティアがデフォルトのビジネスアプリケーションにレポートします。
次の例では、Ticket Search がデフォルトのビジネスアプリケーションです。
```
<?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">
<account name="customer1" password="changeme" />

<applications>
<application name="Ticket Search" default ="true"/>
<application name="Travel Search"/>
</applications>
</controller>
...
```
IIS アプリケーションまたはアプリケーションプール、インストルメンテーションを行う Windows サービス、またはスタンドアロンアプリケーションの構成エレメントを追加します。IIS アプリケーションの場合は、applications ブロックを IIS エレメントの子として追加します。既存の applications エレメントを置き換えます。「IIS アプリケーションエレメント」を参照してください。
```
<applications>
<application path="/" site="FirstSite" controller-application="Application1">
<tier name="FirstSite Tier"/>
</application>
<application path="/" site="SecondSite" controller-application="Application2">
<tier name="SecondSite Tier"/>
</application>
</applications>
```
IIS アプリケーションプールの場合は、application pools ブロックを IIS エレメントの子として追加します。既存の <application-pools> エレメントを置き換えます。「IIS アプリケーションプールエレメント」を参照してください。
```
<application-pools>
<application-pool name="MyAppPool1" controller-application="Application1">
<tier name="App1 AppPool Tier"/>
</application-pool>
<application-pool name="MyAppPool2" controller-application="Application2">
<tier name="App2 AppPool Tier"/>
</application-pool>
</application-pools>
```
Windows サービスまたはスタンドアロンアプリケーションの場合は、standalone-applications ブロックを app-agents エレメントの子として追加します。「スタンドアロンアプリケーションエレメント」を参照してください。
```
<standalone-applications>
<standalone-application executable="MyStandaloneApp.exe" controller-application="ApplicationName1">
<tier name="Standalone App Tier"/>
</standalone-application>
<standalone-application executable="MyWindowsService.exe" command-line="-x" controller-application="ApplicationName2">
<tier name="Windows Service Tier"/>
</standalone-application>
</standalone-applications>
```
次のように、アプリケーションエレメントを構成します。
- インストゥルメント化する各 IIS アプリケーション/アプリケーションプール、Windows サービスまたはスタンドアロンアプリケーションに対応するエレメントを追加。「.NET エージェントの構成プロパティ」を参照してください。
- アプリケーションエレメントそれぞれについて、controller-application 属性を対応するビジネスアプリケーションの名前に設定。controller-application属性を省略すると、エージェントはアプリケーションを構成済みのデフォルトビジネスアプリケーションのティアに追加。
- tier エレメントの name 属性をビジネスアプリケーションの階層名に設定。
構成を完了したら、変更内容を config.xml ファイルに保存。
AppDynamics.Agent.Coordinator サービスを再起動します。
IIS アプリケーション/アプリケーションプール、Windows サービス、およびスタンドアロンアプリケーションを再起動。
アプリケーションがトラフィックの処理を開始すると、エージェントがコントローラにそれらを登録。コントローラにログインして、アプリケーションが対応するビジネスアプリケーションに登録されたことを確認。

設定例

この config.xml ファイルのサンプルは、コントローラの複数のビジネスアプリケーションの構成を示しています。Windows サービスの TicketService では controller-application 属性が指定されないため、デフォルトのビジネスアプリケーションである Ticket Search Engine にレポートされます。TravelAPIPool プール内のすべてのアプリケーションは、Travel Search Engine にレポートされます。

クリックして展開

<?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">
<!--Configure multiple business applications-->
<applications>
<application name="Ticket Search Engine" default ="true"/>
<application name="Travel Search Engine"/>
</applications>
</controller>
<machine-agent />
<app-agents>
<IIS>
<automatic enabled="false" />
<application-pools>
<application-pool name="TravelAPIPool" controller-application="Travel Search Engine">
<tier name="Travel APIs"/>
</application-pool>
</application-pools>
<applications>
<application path="/" site="TicketSearch" controller-application="Ticket Search Engine">
<tier name="Ticket Search Web"/>
</application>
<application path="/" site="TravelSearch" controller-application="Travel Search Engine">
<tier name="Travel Search Web"/>
</application>
</applications>
</IIS>
<standalone-applications>
<standalone-application executable="StandaloneApp.exe" controller-application="Ticket Search Engine">
<tier name="Ticket Standalone Tier"/>
</standalone-application>
<standalone-application executable="WindowsService.exe" command-line="-x" controller-application="Travel Search Engine">
<tier name="Travel Windows Service Tier"/> </standalone-application>
</standalone-applications>
</app-agents>
</appdynamics-agent>

複数アプリケーションのサポート用エージェント構成プロパティ

複数のビジネスアプリケーションサポートには、.NET エージェントの構成プロパティが含まれています。これらの構成プロパティは「.NETエージェントの構成プロパティ」に記載されているプロパティよりも優先されます。

コントローラアプリケーションエレメント

applications 要素は、controller 要素の子要素です。コントローラ内のビジネスアプリケーションにマップするすべてのコントローラアプリケーション要素に対するコンテナ要素です。

必須要素：<applications>

コントローラアプリケーションエレメント

controller application 要素は、controller applications 要素の子要素です。コントローラ内に表示される論理ビジネスアプリケーションの名前を示しています。複数のコントローラアプリケーション要素がある場合は、そのうちのいずれかのデフォルト属性を true に設定する必要があります。

必須要素：<application name="MyDotNetApplication" default="true"/>

アプリケーション名属性

アプリケーション名属性をコントローラのビジネスアプリケーション名に設定します。アプリケーション名が存在しない場合、エージェントが登録された時にコントローラがそれを作成します。

タイプ：文字列

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

要否: 要

アプリケーションのデフォルト属性

1 つの controller application 要素でアプリケーションの default 属性を true に設定します。controller application 属性を持たないインストルメント化されたアプリケーションは、コントローラのデフォルトビジネスアプリケーションに登録されます。

型：ブール型

デフォルト：false

必須：複数のアプリケーション構成の 1 つのアプリケーションに必須

コントローラアプリケーション属性

IIS application、IIS application-pool、windows-service、および standalone-application の各要素には、controller-application 属性を指定できます。この値を controller application 要素名に設定します。controller-application 属性を含めない場合、そのアプリケーションはデフォルトビジネスアプリケーションに登録されます。

例えば、IISアプリケーションの場合：

<application path="/" site="MySite" controller-application="My Business Application">

タイプ：文字列

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

必須：いいえ