Process of Configuring Agent - Enterprise Manager Network Topology
Configuring agent to Enterprise Manager network topology requires these high-level steps.
- Configure the introscopenenterprisemanager.properties file if appropriate for your deployment.
- (Optional) Configure whether agents not matched by any regular expressions in loadbalancing.xml are allowed or disallowed connection to the MOM or specific Enterprise Managers.Set the introscope.apm.agentcontrol.agent.allowed property.
- (Optional) Configure a randomized duration for agent reconnection attempts to the Enterprise Manager.Set the introscope.apm.agentcontrol.agent.reconnect.wait property.
- (Optional) Configure the number of 9.1 and later agents that can passively connect to an Enterprise Manager and not send data.Set the introscope.enterprisemanager.agent.disallowed.connection.limit.
- Configure the IntroscopeAgent.profile file if appropriate for your deployment.
- (Optional) Configure whether agents disconnected from an Enterprise Manager continually attempt to reconnect to any allowed Enterprise Manager.Set the introscope.agent.enterprisemanager.failbackRetryIntervalInSeconds property.
- Configure loadbalancing.xml.
- (Optional) Configure the latch property so that specific agents always connect to specific Enterprise Managers.
- (Optional) Configure include and exclude elements to allow and disallow agent connections to specific Enterprise Managers.
- Save loadbalancing.xml.
- Perform system monitoring and reconfigure if needed.
- Reconfigure any properties as needed.
- Update loadbalancing.xml.
Plan the Agent - Enterprise Manager Network Topology
Plan your agent to Enterprise Manager or Collector topology before configuring agent connection assignments. In these assignments, you configure which agents are allowed or not allowed to connect to specific individual or groups of Collectors.
If your business practices require it, set up agents into subclusters. You can assign agents to a specific set of Collectors, and then configure loadbalancing.xml so the MOM load balances only that set of Collectors. For example, you could have the agents monitoring the applications for a specific business unit connect to three Collectors in your cluster of ten.
During your planning, ask and answer questions such as:
- Are classes or groups of agents or specific agents allowed or disallowed in the cluster or on specific Collectors?
- Should any Collector be specially protected against overloading?For example, do some Collectors need protection against direct connections from mis-configured agents? If all agents have identical agent profiles and attempt to connect, they may flood a single IP address. Too many agents connected to a Collector can crash that Collector.
Follow these steps:
- For each group or class of agent, determine which set of Collectors you want to:
- Allow access.
- Disallow access.
- Determine the default connection activity of agents that are not matched in loadbalancing.xml.Do you want to allow or disallow all agents that are not matched in loadbalancing.xml on specific Enterprise Managers?
- Will any agents be load balanced? If so, are they allowed on all the Collectors that you want them moved to?Carefully consider the effect of agent connection restrictions, as they restrict the load balancing options for the MOM. A MOM performing load balancing cannot remove an agent from an overloaded Collector when the agent is not allowed to connect to an under-loaded Collector. In this case, the MOM must load balance other agents from the overloaded Collector to an under-loaded Collector.
- Determine how agents disconnected from an Enterprise Manager will act.Do you want agents to try to reconnect continuously to any allowed Enterprise Manager?Or based on the agent CA APM version is it better for:
- Valid for pre-9.1 agents:Disconnect from an Enterprise Manager and keep trying to reconnect?
- Valid for 9.1 and later agents:Remain passively connected to the final allowed Enterprise Manager on the agent Allowed Enterprise Manager list?Passively connected agents have these characteristics:
- Do not send any metric data to the Enterprise Manager.
- Do not try to reconnect to other Enterprise Managers that become available.
- Does your CA APM environment allow agents to connect across the following CA APM components:
- Collectors and Standalone Enterprise Managers?
- Any combination of clusters, Collectors, and Standalone Enterprise Managers?