This topic covers the Standalone Machine Agent. It does not cover the embedded machine agent included with the App Agent for .NET.
The Standalone Machine Agent uses a built-in hardware monitor to report metrics and hardware utilization data. The hardware monitor is a script that writes data to STDOUT of a process. The Machine Agent is always running and reports to the Controller once a minute.
The agent automatically collects the following performance data:
The Standalone Machine Agent monitors a particular machine and not a particular application server. The agent can therefore refer to multiple nodes running on the same machine. A flow map, on the other hand, displays the communication between different nodes during application execution, or the business transaction flow from tier to tier. A Standalone Machine Agent cannot be a part of the flow and therefore is not shown in the flow map.
Metrics monitored by the agent are included in the infrastructure health indicator in the dashboards.
The health indicator is driven by health rule violations in the given time period and health rule violations are configured on hardware metrics collected by the Standalone Machine Agent. Health rules for all possible metrics are not configured out-of-the-box, so you might want to configure additional health rule according to your requirements. For details see Configure Health Rules.
AppDynamics lists all agents for all business applications.
The reset operation purges all existing metrics for an agent and starts gathering them again. It stops the agent and starts it again.
1. In the Machine Agents window, select a machine agent.
2. Click Reset Selected Machine Agent.
If no configuration details are provided during installation, or if the node has been moved to another application, then the Standalone Machine Agent will appear in the System -> Agents tab as "not associated with any applications". To have the Machine Agent start sending metrics or executing workflow tasks, manually associate it with an application.
The following message in the agent log (<machine_agent_home>/logs/machine-agent.log) indicates that there is no application associated with the agent:
Received Metric Registration request for a machine id:<NNNNN> that is NOT registered to any nodes yet, sending back null response!
1. In the AppDynamics Agents window, select an agent.
2. Click Associate with an Application.
If the machine is hosting servers that belong to multiple business applications, you may need multiple Standalone Machine Agents.
If there are nodes belonging to multiple business applications, you can run multiple Standalone Machine Agents each configured to report metrics for a different node, tier, and application.
Background information: You cannot "assign" a single Standalone Machine Agent to multiple business application per se. A Standalone Machine Agent on a specific machine is automatically associated with all nodes running on that machine. A node is associated with a single business application. Therefore an application is associated with the Standalone Machine Agents of its nodes. By default Standalone Machine Agents inherit the application/tier/node names of the App Agents installed on the same hardware.