マシンエージェントの FAQ とトラブルシューティング

このセクションでは、マシンエージェントに関するよく寄せられる質問とトラブルシューティングの手順について説明します。

sma_unique_id_of_app_agentマシンエージェントとアプリケーション エージェントが同じマシン上にあるが、別のノードにレポートする

問題

マシンでマシンエージェントとアプリケーション サーバ エージェントが一緒に実行されていますが、エージェントが異なるノードにレポートします。メトリックブラウザで確認すると、たとえば、アプリケーションメトリックはノード abc の下に表示され、一方マシンメトリックはノード abc.mydomain.com の下に表示されます。

解像度

ホスト名が一致しているかどうかを確認します。一致していない場合は、次の手順を実行します。

  1. マシンエージェントの <unique-host-id> をアプリケーション サーバ エージェントと同じ <unique-host-id> に設定します。
  2. 前の変更を適用するために、マシンエージェントを再起動します。

マシンエージェントの <unique-host-id> とアプリケーション サーバ エージェントの <unique-host-id> は正確に一致している必要があります。これらの設定では、大文字と小文字が区別されます。両方のエージェントが同じノードにメトリックをレポートしていることを確認します。

ホスト名が一致していることを確認するには、次のようにします。

  1. コントローラメニューの歯車アイコン（）をクリックし、Agent Management > Manage Agents の順に選択します。
  2. [Machine Agents] タブを選択します。

  3. エージェント名の [Applications] フィールドを確認します。

    注: また、[Servers] タブで命名の一貫性のために、<machine path> 属性を使用してホスト名を設定します。マシンパスを使用することで、一部のエージェントの完全修飾ドメイン名（FQDN）とその他のエージェントのホスト名は使用する必要がなくなります。レポート対象のホスト名は、[Agents Admin] ビューでオプションをオンにすることで引き続き表示できます。
  4. アプリケーション サーバ エージェントの ID を確認します。
    1. [App Server Agents] タブに移動します。
    2. マシンエージェントを関連付けるアプリケーション サーバ エージェントを検索します。
    3. そのマシンにインストールされているアプリケーション サーバー エージェントの [Unique Host ID] フィールドを確認します。
  5. マシンエージェントの <unique-host-id> をアプリケーション サーバ エージェントと同じ <unique-host-id> に設定します。
  6. 前の変更を適用するために、マシンエージェントを再起動します。数分後にエージェントが関連付け済みとして表示されます。

.NET Agent Doesn't Appear on Machine Agent List

Although .NET Agents can report Machine Agent metrics, they are not considered Machine Agents. .NET Agent-instrumented machines are not included under the list of Machine Agents in the Controller UI.

Identify the Machine Agent Process

Linux and Unix-like Systems

To identify which process is running the Machine Agent, enter:

ps -ef | grep machine

Windows Systems

In the Windows Services Application, search for the Machine Agent service.

Metric Values for Disk and Network are Zero

When a 32-bit JRE is used with a 64-bit operating system, you may see values of zero for disk and network metrics. To solve this problem, use a 64-bit JRE with the 64-bit operating system.

Flow Maps and the Machine Agent

The Machine Agent monitors a particular machine (also called "host server") and not a particular application server; therefore, the Machine Agent can report to multiple nodes running on the same machine. However, a flow map displays the communication between different nodes during application execution, or the business transaction flow from tier to tier. A Machine Agent cannot be a part of the flow and is not shown in the flow map.

Server Health Indicator

Health rule violations based on metrics monitored by the Machine Agent are included in the health indicator on the various application, tier, and node dashboards. The health indicator is driven by health rule violations in the given time period configured on hardware metrics collected by the Machine Agent. Some health rules are configured by default. To configure additional health rules, see Configure Health Rules to Monitor Servers.