Process ID

This section provides options to specify the process ID to track its performance.

Refresh

Refreshes the Process ID drop down list.

Copy

Copies the process ID to the clipboard.

This ID can be used in conjunction with UNIX commands in Expert mode.

Search

Selects a frozen application window to bring up the Health Monitor form with the process ID of this window.

Pin

Pins the minimized version of the form at the top of the screen.

Program Execution Tracing

This section provides options to specify the time for recording the performance of the selected process ID.

Recording Time

Specifies the time for which you want to collect the callstacks for the specified Process ID. Move the slider to the specified time on the Recording Time bar.

If you move the slider to Custom, additional options are displayed to let you specify the Interval and Time out information.

Latency (sec)

Specifies the time to wait before recording starts.

Print All Threads

Prints all threads in the results. By default, only the main thread is printed.

File Tags

Specifies the keywords to be appended to the log file name for categorization.

Environment Variable: fileTag

Ready

Attaches GDB and prepares the tracker to capture minor slowness issues before recording the callstacks. This option is visible only when Print all threads is enabled or the value in Process ID is set for a non-Virtuoso process.

Start Recording / Stop Recording

Records the callstacks to collect the performance data of the specified process ID. The default recording time is 180 seconds.

You can check the remaining recording time in the progress bar available next to the Start Recording button or stop recording when the issue disappears.

Tool Appears Frozen

This section provides options to terminate a frozen tool or application.

Terminate Virtuoso

Displays the Terminate Virtuoso form.

Click the Send CTRL-C button to interrupt the program causing the issue. If it is still unresponsive, specify the reason for exiting Virtuoso (for example, describe how you ran into this issue) and then click the Terminate button.

The Performance Diagnostic tool records 10 seconds of callstacks, if possible, generates a hangReport, and then closes the current Virtuoso session.

Expert

Displays the Advanced Debugging section.

Environment Variable: enableExpertMode

Advanced Debugging

This section provides a UNIX expert with more options to apply advanced debugging techniques.

Enable

Enables the advanced debugging options.

Pstack (Gstack)

Invokes the pstack or gstack UNIX command to print a callstack of the specified PID

Environment Variable: pstackPath

Strace

Opens the Monitor by Strace form, where you can specify the data analysis mode to trace system calls of the specified process ID.

Environment Variable: stracePath

Debugger (gdb)

Invokes the gdb UNIX command to attach a GNU Debugger to the specified process ID.

Environment Variable: gdbPath

Open Terminal

Opens the UNIX shell terminal window.

Status Indicator

Indicates the health status of your current session. These are the indicators:

• Off : Indicates the Health Monitor is off. Click to activate the Health Monitor.
• Idle : Indicates the Health Monitor is on and the current Virtuoso session is idle.
• Green : Indicates the pulse is vibrant, which means the current Virtuoso session is busy but running, and the system resources are allocated as expected.
• Yellow : Indicates that the pulse is concentrated, which means Virtuoso is busy running a specific sub-feature or the system resource usage is high.
• Red : Indicates the pulse is low, which means Virtuoso is calling the same leaf function or the majority of the system resources are occupied.
• Flash : Indicates that the status change is unlikely to have been caused by Virtuoso and is related to other factors outside the Virtuoso environment.

Health Monitor (Advanced)

Opens the Health Monitor (Advanced) form.

Entry command

Displays the user command for the current session.

Call chain

Displays the calling relationship of the software packages. A call chain is an abstract of a callstack. This information helps understand the purpose of the program.