.NET 互換モード

このページでは、.NET エージェントの互換モードを設定する方法について説明します。互換モードでは、マシンエージェントと .NET エージェントがインストールされているサーバで、マシンメトリックまたはサーバメトリックを収集して表示できます。

はじめる前に

互換モードに関する要件と一般的な情報のリストを確認します。

同じサーバ上のマシンエージェントと .NET エージェントからのメトリックを、コントローラ UI で同じノードに明確に関連付けるために、.NET 互換モードが必要です。
平均レートと測定方法が異なるため、マシンエージェントと .NET エージェントによってレポートされるメトリック値に違いがある場合があります。
マシンエージェントで .NET 互換モードを有効にする必要があります。
.NET 互換モードを有効にすると、次のようになります。
- サービスの可用性とカスタム拡張機能からのイベントは [Servers] タブに表示されますが、コントローラ UI で .NET アプリケーションには関連付けられません。
- コントローラ UI には、ホスト ID に「-java-MA」が付加されたサーバ名が表示される場合があります。したがって、<unique-host-id> が「ABC」に設定されたマシンエージェントは、コントローラ UI で「ABC-java-MA」として表示される場合があります。これは正常な動作です。「-java-MA」サフィックスは、ホストに .NET 互換モードで稼働しているマシンエージェントがあることを示します。
マシンエージェントに対して <application-name>、<tier-name>、または <node-name> プロパティは指定しないでください。これらのプロパティは、他の AppDynamics エージェントがインストールされていないホスト上のマシンエージェントで使用されます。

互換モードの有効化

.NET 互換モードを有効にするには

次の 2 つの方法のいずれかを使用して、エージェントで .NET 互換モードを有効にします。
- <machine_agent_home>/conf/controller-info.xml で次のオプションを設定します。
  1. <dotnet-compatibility-mode>true</dotnet-compatibility-mode>
    この行を controller-info.xml ファイルに追加する必要がある場合があります。
  2. <unique-host-id><unique-host-id-of-dot-net-agent></unique-host-id>
    両方のエージェントが同じノードにメトリックをレポートするようにするために、マシンエージェントで、.NET エージェントが使用するのと同じ大文字と小文字が区別された一意のホスト ID を使用する必要があります。「FAQ およびトラブルシューティング」を参照してください。
- ./bin/machine-agent システムプロパティを次のように設定します。./bin/machine-agent -Dappdynamics.machine.agent.dotnetCompatibilityMode=true
controller-info.xml ファイルを保存します。
変更を適用するために、マシンエージェントを起動または再起動します。