Chat now with support
Chat with Support

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

Updating integration configuration properties

Sometimes, due to monitored environment changes, it may be necessary to update the integration configuration properties, such as the target integration script location, or the agent or pre-instrumentor options.
To edit the integration configuration properties:
1
On the navigation panel, under Dashboards, click 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 Configuration Name and Targets list, click the name of the configuration that you want to edit (for example, WebLogic on Windows: startWebLogic).
5
In the menu that opens, click Properties.
6
In the Integration Task Properties dialog box, change the available values as necessary.
7
Click Save.
8
Restart the affected application servers.

Java EE agent logging properties

You can configure the following for logs that the Java EE agents produces:
•
Log targets, for forwarding log messages to different outputs
•
Log level (ALL, DEBUG, VERBOSE, INFO, WARN, ERROR, FATAL, and OFF) for each log target
•
The directory in which log files are created (if other than the default directory, <VERSIONED_SUBDIRECTORY>/logs)
•
A locale setting for changing the language in which log messages are written
You can also configure several log targets:
•
Console: Outputs to the application console
•
Text File: Outputs to a formatted text file
•
Serialized File: Outputs to a serialized object file
•
WebSphere: Forwards Agent messages to the WebSphere log system
Java EE agents normally have Console and Text File log targets active. The Serialized File target is active in all log-enabled applications, but its threshold is set to OFF normally. This can be overridden in release-mode by setting its threshold to something other than OFF, preferably ALL. WebSphere is active only for agents monitoring WebSphere.
Each target has a set of properties that can be set to modify its behavior. All targets have one common property: Threshold Log Level. Targets ignore log messages of a level below this threshold. Standard levels are ALL, DEBUG, VERBOSE, INFO, WARN, ERROR, FATAL and OFF, in descending order of verbosity. A threshold of OFF effectively disables a target. File-based targets do not create files when their threshold is OFF.
Create a basic log configuration as part of the agent installation process. You can edit that configuration, or create ones, at any other time.

Creating or editing logging properties

The process for creating a log configuration and the process for editing an existing one are similar. The following procedure describes both options and any differences between them.
To edit or create a logging 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 Integration Configurations tab.
4
Click Manage logging. The Logging page opens.
5
Click the name of the log that you want to edit. In the menu that opens, click Edit.
Or
Click New.
In either case, the 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.
6
Set the values for each of the logging target types: Console, Text File, Serialized File, WebSphere, and Other, as necessary. If you need more information about a particular setting, click the icon.
7
New configurations only — Type a unique and recognizable name in the Save as box.
8
Click Save.
The next time that you create an agent, you can assign the saved log configuration to it. You can also update any integrations that are already using the log configuration.
To update log settings for an existing 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 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 update.
5
In the list that opens, click Update logging.

Reintegrating existing targets

To keep your application servers up to date, you can edit the properties of an integration task, and then reintegrate either a single target, or all targets using that particular configuration.
To reintegrate a target:
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, click the name of the integration configuration task. For example: Generic installation only on Windows: Install Configs and Preinstrument.
5
In the list that opens, click Properties.
6
In the Integration Task Properties dialog box, update the Java Home or Preinstrumentor Options as necessary.
7
Click Save.
8
In the Integration dialog box, click OK if you want to reintegrate all targets that use the configuration.
Or
Clear the check box if you want to reintegrate only certain targets, then click OK.
9
Optional — In the list of Configuration Name and Targets, do one of the following:
•
To reintegrate a single target, expand the configuration group by clicking the ‘+’ sign, then click the name of the target you want to reintegrate (for example, appserver.example1.com: WebLogic on Windows: startWebLogic). In the menu that opens, click Reintegrate.
•
To reintegrate all targets that are using the same integration configuration, click the configuration name (for example, WebLogic on Windows: startWebLogic). In the menu that opens, click Reintegrate targets.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating