立即与支持人员聊天
与支持团队交流

Foglight for Java EE Technologies 5.9.7.5 - Installation Guide

Installing and Configuring Foglight for Java EE Technologies Integrating with JBoss Integrating with Tomcat Integrating with WebLogic Domain Startup Scripts Integrating with WebSphere Integrating with Oracle AS Creating a Generic Installation for Manual Java EE Agent Integration Managing Java EE Agent Installations, Integrations, and Configurations Managing Java EE Agent Configurations Managing Java EE Installations Foglight for Java EE Integration Configuration FAQ and Troubleshooting Performing Manual Application Server Integrations Appendix: Managing Permissions for the Java EE Integration Agent Appendix: Foglight for Java EE Application Methods

Reusing a Previous Integration Configuration

The first time you install a Java EE agent, you must create an integration configuration that is specific to the type of application server you are integrating with. During the process of creating the integration, you can choose to save it as a reusable task. Reusing a saved integration configuration allows you to quickly set up multiple agents with the same configuration.
To reuse an integration configuration:
1
On the navigation panel, under Dashboards, click Application Servers > Administration > Application Servers Administration.
2
On the Application Servers Administration dashboard, in the Monitoring Agents section, click Setup agents.
3
In the menu that opens, select Java. The wizard opens.
4
On the Setup Options page of the wizard, click Reuse previous application server integration details.
Click Next.
5
On the Integration Configuration page, select a saved integration task from the list.
Click Next.
6
On the Nexus Connection page, select or create the connection that the agent should use to connect to the Nexus.
* 
TIP: For more information about the Nexus, see Understanding the Nexus and Agent-Nexus Connections .
Select a Nexus connection from the list and click Next.
7
On the Logging page, select or create a logging configuration to control how logs are written, including retention policies and rollovers.
•
Select an existing log configuration from the list. The default log provides a basic log configuration that you can use to get started quickly.
•
Click New log configuration. The New Log Configuration dialog box opens.
* 
TIP: If you are uncertain about how to adjust these settings, click Help for an overview of log targets and their purposes. For more information, see Creating or Editing Logging Properties.
Click Next.
8
On the Integration Hosts page, select the host that you want to integrate with. By default, only eligible hosts (that is, hosts that have an active Foglight Agent Manager of a compatible version installed and running) are listed.
Select the host and click Next.
9
On the Agent Configuration page, select the configuration that you want the agent to use. The configuration controls request monitoring and collection details information.
* 
TIP: For more information, see Managing Java EE Agent Configurations.
Select the configuration and click Next.
10
On the Installation Directory page, define the location for the directory that contains all installation components and log files. To accept the default directory, leave the Installation Directory box blank.
* 
IMPORTANT: If you have previously configured the host for agent installation, the existing installation directory is used.
To specify a custom directory, type a path in the Directory name box.
Click Next.
11
On the Review page, verify the details of the integration.
Click Finish.
The Application Servers Administration dashboard refreshes, and the integration task appears in the Task History list, where you can monitor its progress.
12
Restart your application server.
The agent starts collecting data after the application server has restarted and the agent is successfully integrated.
Use the Application Servers Monitor dashboard to view the application servers status. For more information about the Application Servers Monitor dashboard, see the Monitoring Application Servers User and Reference Guide.

Managing Java EE Agent Configurations

The agent configuration controls what data the agent collects. These settings are stored in a file called instrumentation.config. You can edit the instrumentation settings through a GUI editor that is available on the Agent Configurations tab of the Java Administration dashboard.
To manage agent configurations:
1
On the navigation panel, under Dashboards, click Application Servers > Administration > Application Servers Administration.
2
On the Application Servers Administration dashboard, click Java Administration.
3
On the Java Administration dashboard, click the Agent Configurations tab.
From here, you can create a new agent configuration or edit an existing one (instrumentation.config), or edit version-specific agent configuration files.
For more information, see:
•
Creating Agent Instrumentation Configurations
•
Editing Agent Instrumentation Configurations
•
Managing Other Java EE Agent Configuration Files

Creating Agent Instrumentation Configurations

Foglight for Java EE Technologies includes a default, basic configuration for the Java EE agent that is defined in the instrumentation.config file settings. Java EE agents use the default configuration unless you explicitly create and assign a new one to them. You can create new configurations by copying settings from the default configuration.
* 
IMPORTANT: If you want to edit the default configuration, it is recommended that you create a copy of it and edit the copy instead, then assign it to the appropriate agents.
To create a new agent configuration:
1
On the navigation panel, under Dashboards, click Application Servers > Administration > Application Servers Administration.
2
On the Application Servers Administration dashboard, click Java Administration.
3
On the Java Administration dashboard, click the Agent Configuration tab.
4
On the Agent Configuration tab, click New configuration. The New Java Agent Configuration dialog box opens.
5
Optional — To use an existing configuration as the basis for your new configuration, select the Copy settings from check box and select an existing configuration from the list.
6
Type the identifier (ID) for this configuration in the first box. The ID can contain the following types of characters: alphanumeric, hyphens, periods, and underscores. No other characters are allowed.
7
Optional — Type a descriptive name for the configuration in the Display Name box.
* 
IMPORTANT: If you leave this box empty, the display name is the same as the ID.
8
Optional — Type a short description for the configuration in the Description box.
9
Click Create.
The Agent Configuration tab refreshes and the new configuration appears in the list.
* 
TIP: Any new configuration that was not copied from an existing configuration contains the default monitoring settings.
To view and edit the instrumentation settings, see Editing Agent Instrumentation Configurations .

Editing Agent Instrumentation Configurations

The agent configuration editor provides a GUI for editing instrumentation settings. This simplifies the process for users.
* 
NOTE: In previous versions of Foglight for Java EE Technologies, you had to manually edit these settings in the instrumentation.config file. If you prefer this method, see Manually Editing Instrumentation Settings .
To edit an agent instrumentation configuration:
1
On the navigation panel, under Dashboards, click Application Servers > Administration > Application Servers Administration.
2
On the Application Servers Administration dashboard, click Java Administration.
3
On the Java Administration dashboard, click the Agent Configuration tab.
4
On the Agent Configuration tab, click the name of the agent configuration that you want to edit.
5
On the menu that opens, click Edit instrumentation settings.
The Edit – <configuration name> dialog box opens.
For information about the settings available on each tab, see the following topics:
•
Managing General Instrumentation Settings
•
Managing Long Running Methods Settings
•
Managing Named Methods Settings
•
Managing Object Tracking Settings
•
Managing Requests Settings
•
Managing Advanced Settings
* 
IMPORTANT: If you make changes to the instrumentation, you must restart the affected application servers.
相关文档

The document was helpful.

选择评级

I easily found the information I needed.

选择评级