Foglight for Java EE Technologies 5.9.13 - Installation Guide

Requests settings

The Requests instrumentation settings for a Java EE agent determine how the agent splits requests based on methods. Changing any of these settings can have performance implications. Review the provided information before changing any settings.

Setting the Maximum Request Fragment cache size

In the period between requests, the Java EE agent caches the data structures used to collect the data for request fragments. The MaxRequestFragmentCacheSize setting determines the maximum number of request fragments that are stored in the cache. The default value is 50. Set the value to zero (0) to disable the cache.

NOTE: This setting is only valid for FullDetail, ComponentDetail and BasicDetail Instrumentation Levels. Changing its value has no effect if the Instrumentation Level is NoDetail. For more information about setting instrumentation levels, see Configuring instrumented simple method settings .

TIP: To review how to access the instrumentation settings editor, see Editing agent instrumentation configurations .

If you manually edit the instrumentation.config file, use the following syntax to specify the maximum request fragment cache size.

MaxRequestFragmentCacheSize = 50;

Setting the Request Recursion Limit

The RecursionLimit configuration setting adjusts the number of recursive calls for which the Java EE agent collects detailed performance information. Beyond this number, the Java EE agent collects and aggregates timing information for the entire recursive sequence.

If you need to see more detail for each method call in a recursive sequence, you can increase this value. Set the value to zero (0) to see only the first method call, but none of the recursive calls. The default value is 5.

NOTE: This setting is only valid for FullDetail, ComponentDetail and BasicDetail Instrumentation Levels. Changing its value has no effect if the Instrumentation Level is NoDetail. For more information about setting instrumentation levels, see Configuring instrumented simple method settings .

TIP: To review how to access the instrumentation settings editor, see Editing agent instrumentation configurations .

If you manually edit the instrumentation.config file, use the following syntax to specify the recursion limit.

RecursionLimit = 5;

Setting the Request Remote Invocation Limit

The RemoteInvocationLimit determines the maximum number of calls that the Java EE agent follows from a single method to a remote system. Beyond this number, the Java EE agent only collects and aggregates overall performance information for the remote system invocations. This is done for two reasons:

The default value is 10. If this limit is exceeded, the Java EE agent logs a WARN message that identifies the method where the remote invocations are taking place.

If you are receiving WARN log messages and you require more detail on the remote invocations, you can increase this setting.

IMPORTANT: Increasing this value also increases the amount of CPU and memory that the Nexus uses.

Decrease this value if you are receiving the WARN log messages, but the Nexus is exhibiting symptoms of excessive memory use.

NOTE: This setting is only valid for FullDetail, ComponentDetail and BasicDetail Instrumentation Levels. Changing its value has no effect if the Instrumentation Level is NoDetail. For more information about setting instrumentation levels, see Configuring instrumented simple method settings .

TIP: To review how to access the instrumentation settings editor, see Editing agent instrumentation configurations .

If you manually edit the instrumentation.config file, use the following syntax to specify the remote invocation limit.

RemoteInvocationLimit = 50;