Configure .NET Agent Connection Metrics

By default, Introscope generates metrics on the connection status of agents connected to an Enterprise Manager, which you can monitor. You can monitor agent connection metrics to determine the current state of the connection between an agent and the Enterprise Manager.
apmdevops106
By default, Introscope generates metrics on the connection status of agents connected to an Enterprise Manager, which you can monitor. You can monitor agent connection metrics to determine the current state of the connection between an agent and the Enterprise Manager.
Agent connection metrics appear in the browser tree under the Enterprise Manager process (the custom metric host):
Custom Metric Host (Virtual) \ Custom Metric Process(Virtual) \ Custom Metric Agent (Virtual) (*SuperDomain*) \ Agents \ <HostName> \ <Agent Process Name> \ <Agent Name> \ ConnectionStatus
Connection metrics have these values:
  • 0 -- No data about the agent is available
  • 1 -- agent is connected
  • 2 -- agent is slow to report
  • 3 -- agent is disconnected
An agent disconnecting also generates a
What’s Interesting
event. As with other events, users can query for agent disconnects using the historical query interface. Agent disconnect events are part of the data that is used in assessing application health. The health data display in the Workstation and WebView 
Overview
tab.
Once an agent disconnects from the Enterprise Manager, Introscope continues to generate disconnected state metrics until the agent is timed out. When an agent times out, no additional connection metrics are generated or reported to the Enterprise Manager.
Follow these steps:
  1. On the computer that the Enterprise Manager is installed on, open the IntroscopeEnterpriseManager.properties file in the <
    EM_Home
    >/config directory.
  2. Modify this property:
    introscope.enterprisemanager.agentconnection.metrics.agentTimeoutInMinutes
    The time increment is in minutes.
  3. Save the IntroscopeEnterpriseManager.properties file.
Restricting Socket Metric Collection
Socket metric collection is enabled by default. Monitored applications or services that create many transient sockets might generate a larger than usual increase in memory. The increase is due to the socket information that CA APM collects. Processor or I/O time might also increase in managed and NIO sockets and regular sockets.
You can turn off socket metrics collection to prevent memory overhead issues, or to target more relevant information.
Follow these steps:
  1. Navigate to the
    <Agent_Home>
    directory and open the IntroscopeAgent.profile file in a text editor.
  2. Locate the Agent Socket Rate Metrics section.
  3. Set the
    introscope.agent.sockets.reportRateMetrics
    property to false. For example:
    introscope.agent.sockets.reportRateMetrics=false
  4. Save and close the IntroscopeAgent.profile.
You can also control metric collection by turning tracer groups on or off.