マシンエージェントのインストールのシナリオ

このページでは、新しいマシンエージェントのインストールのシナリオについて説明します。

Machine Agent Installation Scenario

This scenario contains a host server running one or more instrumented applications and one Machine Agent. When you install the Machine Agent on the same server with any app agent, do not specify the application name and tier name. The one Machine Agent reports the hardware metrics to each node where the app agent and the Machine Agent have matching host IDs.

If you plan to enable Server Visibility on a Windows server where .NET Agent is installed, you must enable .NET Compatibility Mode on both the Controller and the Machine Agent. See .NET Compatibility Mode.

注: Licensing Note>= 4.3 includes one Machine Agent license with each APM app agent. You can install this Machine Agent only on the same server with the app agent.

Independent Machine Agent Installation

This scenario contains a host server running only the Machine Agent without app agents. You do not need to specify an application or tier. You can view the Machine Agent metrics from the Servers list or the metric browser. This scenario requires a Server Visibility license.

注: Licensing Note>= 4.3 requires a Server Visibility license for a Machine Agent installation.

If you are doing an Independent Machine Agent installation and you want the hardware metrics reported to nodes in an application, then you must configure the application name, tier name, and node name where you want the metrics to appear.

Using the values for the application name, tier name, and node where you want to see the metrics reported, configure these properties:

  • Application name
  • Tier name
  • Node name
  • uniqueHostId for both the Machine Agent and app agent (use the same value)

「一意のホスト ID プロパティ」を参照してください。

このプロパティは必須です。uniqueHostId ただし、uniqueHostId を定義しない場合、マシンエージェントは Java API を使用してホスト ID を取得します。API の結果に一貫性がない場合があります。マシンエージェントを再起動するたびに、同じ JVM が同じマシンに対して異なる値を返す可能性があります。回避策として、UI に表示するホスト ID に uniqueHostId の値を設定することを推奨しています。アプリケーション エージェントには、uniqueHostId の同じ値を使用します。