Chat now with support
Chat with Support

Foglight for Java EE Technologies 5.9.12 - Installation Guide

Installing and Configuring Foglight for Java EE Technologies Integrating with JBoss Integrating with Apache Tomcat Integrating with WebLogic Domain Startup Scripts Integrating with WebSphere Integrating with WebSphere Liberty Integrating with Oracle AS Integrating with Spring Boot for Embedded Tomcat 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 Installation Java EE Integration Configuration FAQ and Troubleshooting Manually Integrating Application Server Appendix A: Java EE Application Methods AppendixB: Managing Permissions for the Java EE Integration Agent

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.
2
On the Application Servers Administration dashboard, click the Java tab.
3
On the Java vew, click the Agent Configurations tab.
4
On the Agent Configurations 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, these settings were manually edited 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.
2
On the Application Servers Administration dashboard, click the Java ab.
3
On the Java view, click the Agent Configurations tab.
4
On the Agent Configurations 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:
•
General instrumentation settings
•
Customizing Long Running Methods
•
Named Methods settings
•
Object Tracking settings
•
Requests settings
•
Customizing instrumented classes
* 
IMPORTANT: If you change the instrumentation, restart the affected application servers.

Manually editing instrumentation settings

It is possible to manually edit the settings in the instrumentation.config file instead of using the GUI editor. If you are comfortable and familiar with these settings from previous versions of Foglight for Java EE Technologies, you may prefer to use the text editor.

To manually edit the instrumentation settings:
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 Agent Configurations tab.
4
On the Agent Configurations tab, click the name of the agent configuration that you want to edit.
5
In the menu that opens, click Manage.
The Java Agent Configuration: <configuration name> view opens.
6
From the Version list, select the version of the Java EE agent (for example 5.9.2 or 5.8) that you want to work with.
7
Click the name of the file that you want to edit. In this case, click instrumentation.
8
In the menu that opens, select Text edit.
9
Type the required information in the text editor.
10
After you set all the required values, click Save.
11
Restart the application server.

General instrumentation settings

The General instrumentation settings for a Java EE agent include instrumentation levels, simple methods, user classes, custom components, and custom component callbacks. Changing any of these settings can have performance implications. Review the provided information before changing any settings.

Related topics
•
Changing the instrumentation level for Request Metric data collection
•
Configuring instrumented simple method settings
•
Changing user classes settings
•
Changing custom component settings
•
Changing custom component callbacks settings
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating