Chat now with support
Chat with Support

Foglight for Microsoft DOT NET 5.9.13 - Installation and Configuration Guide

Installing and Configuring Foglight for Microsoft .NET Managing .NET Agent Configurations

Understanding the Nexus and agent-Nexus connections for .NET agents

Foglight for Microsoft .NET includes the Nexus, a central analytical engine that correlates data sent from multiple agents, restores and preserves the temporal order of events across all servers, and provides other basic analysis of the data. The Nexus is essential to the data management facilities of Foglight for Microsoft .NET.

Foglight creates a default Nexus as part of the installation process for Foglight for Microsoft .NET. The default Nexus controls all agent data correlation and submission unless you create another Nexus and assign agents to it instead.

 
* 
TIP: For more information about the Nexus, see the topic Understanding the Nexus in the Foglight for Application Servers Administration and Configuration Guide.

The Nexus connection is the communication link between the .NET Agent and the Nexus. It defines how the agent communicates with the Nexus and controls settings such as retry intervals and timeouts. The agent-Nexus connection is created as part of the cartridge installation process. You can also create connections, or edit existing ones, and change which agents are using a connection by switching the agent’s Nexus connection.

Managing .NET agent Nexus connections

During the process of creating a .NET Agent, you assign it to an existing Nexus, and an agent-Nexus connection is created. You can also change the connection between an agent and a Nexus, or create a connection and assign it to different agents after they have been created.

 
* 
NOTE: The Nexus is only applicable to .NET agents that are monitoring transactions.
Creating or Editing Agent-Nexus Connection Settings

The process for creating an agent-Nexus connection and the process for editing an existing one are similar. The following procedure describes both options and any differences between them.

To change agent Nexus connection settings:
1
On the navigation panel, under Dashboards, click Application Servers > Administration.
2
On the Application Servers Administration dashboard, clickthe .NET tab.
3
On the .NET view, click the Integration Configurations tab.
4
On the Integration Configurations tab, click Manage Nexus connections.
The Manage Nexus Connections page opens.
This page lists all existing agent-Nexus connections and the location of the Nexus. From here, you can edit an existing connection, or create a new one.
5
To edit an existing connection, click the name of the connection, then click Edit.
Or
To create a connection, click New.
The Nexus Connection dialog box opens.
6
On the Locations tab, you can add Nexuses that the agent should attempt to connect to, in the order that you want. The agent attempts to connect to each Nexus in turn until a successful connection is established.
Click Add Nexus location and select a Nexus from the list.
 
* 
TIP: Use the Add custom option to define a Nexus location by listen address and port.
7
Optional — Use the up and down arrows to change the order in which the agent attempts the Nexus connections.
8
Click the Advanced tab.
9
Edit the connection settings as necessary. Click the info icon to view a detailed description of the setting and its effects.
10
New Nexus connections only — If you want to reuse this connection and assign it to other agents, type a unique name in the Save as box.
11
Click Save.
The Manage Nexus Connections page refreshes. Any changes you have made to the Nexus location are listed in the Nexus Locations column. The time and date in the Last Modified column are also updated.

Updating the Nexus connection for a target application server

If you changed the Nexus Connection (see Managing .NET agent Nexus connections for details), you can update any target application servers that are using that Nexus connection through the Integration Configurations tab of the .NET Administration dashboard.

To update an application server’s Nexus connection:
1
On the navigation panel, under Dashboards, click Application Servers> Administration.
2
On the Application Servers Administration dashboard, click the .NET tab.
3
On the .NET view, click the Integration Configurations tab.
4
In the Name and Targets list, expand the configuration group that contains the target by clicking the ‘+’ sign.
5
Click the name of the target application server that you want to update.
6
In the menu that opens, click Update Nexus connection.

Switching a Nexus connection

Switching a Nexus connection

You can change the Nexus connection between an agent and a Nexus after it has been created. For example, you might switch the connection for performance reasons (divide up the agents) or to organize your environment (all agents monitoring a particular application use the same Nexus). Switching the Nexus connection affects all of the agents on that the target (host).

To switch a Nexus connection:
1
On the navigation panel, under Dashboards, click Application Servers > Administration.
2
On the Application Servers Administration dashboard, click the Java tab.
3
On the Java view, click the Integration Configurations tab.
4
In the Configuration Name and Targets list, expand the configuration group by clicking the ‘+’ sign.
5
Click the name of the target (host) that you want to switch the Nexus connection on.
6
In the list that opens, select Switch Nexus Connection.
A dialog box opens, listing all the available Nexus Connections for that host integration.
7
Select the Nexus connection towhich you want to switch.
8
Click Switch to save your changes.

All of the agents on that host now use this Nexus connection to communicate with the Nexus.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating