How do I change configuration settings to suit my system needs?

The Configuration page lets you enable instrumentation and sampling, as well as change certain configuration settings.

back to Oracle WebCenter Portal Performance Pack Online Help

You can change the following configuration settings.

Configuration Setting Description
Enable Instrumentation Select to enable method instrumentation. Unselect to disable method instrumentation.
Enable Sampling Select to enable method sampling. Unselect to disable method sampling.

Note: You can only change this setting if Instrumentation is enabled.

Sleep When Idle Defines how frequent to wake the internal thread to process instrumentation events. Default is 5 seconds.

Note that if you set the frequency to a greater value, you may see a delay with events appearing in the events list. A frequency less than the default time means the events list is more up-to-date but there’s a cost with system overhead.

Log Level Defines the log-level. The default is INFO. Valid values are:
  • NONE — No logging

  • ERROR — A PerfSense system error has occurred and must be fixed

  • WARNING — A problem has occurred but it shouldn’t affect the PerfSense system functionality

  • INFO — Provides informational messages regarding the state of the PerfSense system

  • PERF — Provides informational messages regarding instrumentation

  • DEBUG — Provides detailed messages to assist in the diagnosis of a problem with the PerfSense system

Event Cache Size Defines the cache size of the monitored event. The default is 3.

The greater the cache size, the faster the reload time but with more memory required.

Max Parallel Threads Defines the maximum number of threads to be monitored in parallel. Default value is 10.

For a heavily loaded system you may want to increase this setting to avoid missing instrumentation. However, the greater the number, the more memory required.

Collection Timing (ms) Defines the minimum method timing to be collected for profiling. Methods that spend less than this timing are not recorded or reported. Default value is 1 millisecond.

This setting lets you reduce the amount of data that’s collected so you can concentrate on slower methods.

Sampling Interval (ms) Defines the interval between two consecutive samplings. Default is 50 milliseconds.

The smaller the sampling interval, the more precise the sampling but with greater system overload.

Start Delay (ms) Defines the delay time before instrumentation and sampling starts. Default is 50 milliseconds.

This setting lets you ignore any small and fast events.

Write Quick Event Report? Defines whether or not to produce a separate event report using text format. Default is False.

Valid values are True or False.

After you make changes, you can:

  • Update — Saves the changes but does not update the configuration file.

  • Save — Saves the changes and updates the configuration file.

    Here’s the location of the configuration file: <domain_home>/tahoe/<server_name>/tahoe.cfg

  • Revert to Saved — Removes your changes and restores the last saved configuration settings.