How Agent Connection Information Propagates Across Introscope

Introscope provides control over agent to Enterprise Manager connection information, which you can define on the MOM. The MOM ensures that any associated configuration is carried out across the Collectors and agents in a cluster.
apmdevops106
Introscope provides control over agent to Enterprise Manager connection information, which you can define on the MOM. The MOM ensures that any associated configuration is carried out across the Collectors and agents in a cluster.
The MOM periodically sends loadbalancing.xml to all the Collectors, synchronizing loadbalancing.xml across the cluster. Introscope ignores any Collector or CDV loadbalancing.xml configurations.
If the MOM goes down after a Collector has received loadbalancing.xml, the Collector uses the loadbalancing.xml allow or disallow configurations it received from the MOM. If a Collector has never connected to the MOM, the Collector uses its introscope.apm.agentcontrol.agent.allowed property in its IntroscopeEnterprismanager.properties file to allow agent connections. When the MOM connects to a Collector for the first time, the MOM transfers its introscope.apm.agentcontrol.agent.allowed property value to the Collector. The MOM value overrides the Collector value.
Collectors also use the introscope.apm.agentcontrol.agent.allowed property for allow or disallow instructions for agents not defined in loadbalancing.xml.
The MOM also provides agents with a list of Enterprise Managers to which the agents are allowed to connect and are available. This list is named the Allowed Enterprise Manager list. The Allowed Enterprise Manager list is based on Enterprise Manager IP address, so can include Enterprise Managers in different clusters.
The Allowed Enterprise Manager list tells the agent to which Enterprise Manager to connect when any of these computers fails:
  • MOM
  • Standalone Enterprise Manager
  • Initial Collector to which the agent is connected.
When both of these factors occur, then the Enterprise Manager prepares the Allowed Enterprise Manager list based on loadbalancing.xml instructions:
  • A standalone Enterprise Manager goes down.
  • Your environment contains both standalone Enterprise Managers and a cluster
The Allowed Enterprise Manager list directs agents to another standalone Enterprise Manager or a Collector.
When an agent restarts, it gets initial Collector connection information from the introscope.agent.enterprisemanager.connectionorder property in its IntroscopeAgent.profile file. The allowed Collectors are automatically supplied to this property in addition to the defined value. A list of allowed available Collectors or Standalone Enterprise Managers remains in the agent memory until agent restart. Upon restart, the list of allowed available Enterprise Managers is sent from the Collector to the agent.