Chatta subito con l'assistenza
Chat con il supporto

Foglight for Java EE Technologies 5.9.9 - Installation Guide

Install and Configure Foglight for Java EE Technologies Integrate with JBoss Integrate with Apache Tomcat Integrate with WebLogic Domain Startup Scripts Integrate with WebSphere Integrate with Oracle AS Create a Generic Installation for Manual Java EE Agent Integration Manage Java EE Agent Installations, Integrations, and Configurations Managing Java EE Agent Configurations Java EE Installation Management Java EE Integration Configuration FAQ and Troubleshooting Manual Application Server Integrations AppendixB: Managing Permissions for the Java EE Integration Agent Appendix A: Java EE Application Methods

Deleting and undoing an integration

There are two options for removing integrations from targets:
•
Delete only — use to remove integrations on decommissioned hosts or to delete stale integrations that have been superseded. Deletion permanently removes all records of the integration target.
•
Delete and undo integration — use to restore the target host to its pre-integration state. This option is useful when the integration is still active on the target.
To delete an integration:
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 Integration Configurations tab.
4
In the list of Configuration Name and Targets, expand the configuration group by clicking the ‘+’ sign, then click the name of the target you want to delete.
5
In the list that opens, select either Delete only, or Delete and undo integration, as necessary.

Reusing an integration configuration

The first time you install a Java EE agent, 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 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 Foglight for Application Servers User 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 an 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 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 an 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 .
Related Documents

The document was helpful.

Seleziona valutazione

I easily found the information I needed.

Seleziona valutazione