Product Documentation
Virtuoso Studio Design Environment User Guide
Product Version IC23.1, November 2023

Health Monitor (Advanced) Form

Use this form to get a detailed performance report of your Virtuoso session and to view various scripts at different intervals to detect non-virtuoso issues, plot charts, and query historical system statistics.

Tab Description

Main

Displays all the basic information about the current Virtuoso session and the machine.

Log

Displays the information related to log files.

System

Displays all the system-related information.

Options

Provides options to update the Health Monitor settings.

Command Description

Start/Stop

When Start is selected, the Health Monitor is activated.

Freeze/Unfreeze

When Freeze is selected, the form freezes at that particular interval. When Unfreeze is selected, it resumes refreshing all the fields on the form.

Capture

Captures the pulse and generates a log file with all the data.

System Monitor

Launches the System Monitor to monitor information and statistics about the system.

Main

The following table describes the fields available on the Main tab of the Health Monitor Advanced form.

Field Description

Description

Displays information related to the entry command, call chains, and errors.

Procedure/Machine Information

Displays all the machine related information. The following fields are listed:
  • State: Displays the current state of the Virtuoso process. The following status is displayed:
    • R(running)
    • S(sleeping)
    • D(disk sleep)
    • T(stopped)
    • t(tracing stop)
    • Z(zombie)
    • X(dead)
  • VmPeak: Displays peak virtual memory size.
  • VmSize: Displays the virtual memory size.
  • Threads: Displays the number of threads used in the process.
  • loadavg: Displays the system load average figures.

Runtime Callstack

Displays the present callstack of the program.

Log

The following table describes the fields available on the Log tab of the Health Monitor Advanced form.

Field Description

Log Files

Displays the location of log files.

Last 100 lines of CDS.log

Displays the last 100 lines of CDS.log.

In addition to CDS.log, pulse event logs are generated automatically. A pulse event log includes information for the begin/end timing and a link to extra event files containing all details, for example, pulse type, brief description, call stack history, and the analysis result.

System

The following table describes the fields available on the System tab of the Health Monitor Advanced form.

Field Description

CPU

Provides graphical representation based on time and utilization (%) to calculate the CPU performance. Displays the following information:
  • Machine: Displays the CPU usage of the machine.
    • User: Displays the CPU time used by user space processes.
    • System: Displays the CPU time used by the kernel.
    • lowait: Displays the time spent waiting for input or output operations.
    • Idle: Displays the remaining CPU time that is not used actively.
  • Self: Displays the CPU usage of the Virtuoso process.
    • CPU: Displays the CPU time used by the Virtuoso process.
    • Threads: Displays the number of threads used by the Virtuoso process.

Memory

Provides a graphical representation based on time and usage (%) to calculate the memory performance. Displays the following parameters:
  • Machine: Displays the total amount of memory available in the machine.
    • Used: Displays the total amount of memory used.
    • Free: Displays the amount of unused memory.
    • Buff: Displays the amount of buffer memory.
    • Cache: Displays the amount of cache memory.
    • Avail: Displays the amount of memory available for starting new applications without swapping.
    • Self: Displays the memory usage of the Virtuoso process.
    • VIRT: Displays the total amount of virtual memory used by the Virtuoso process.
    • RES: Displays the non-swapped physical memory that is used by the Virtuoso process.
    • SHR: Displays the amount of shared memory available in the Virtuoso process.

Options

The following table describes the fields available on the Options tab of the Health Monitor Advanced form.

Field Description

Virtuoso Pulse

Specifies the settings to monitor the Virtuoso Studio pulse measurements when enabled.

Yellow Light Alert

Specifies the threshold in seconds of consecutive high similarity call chains to report a concentrated pulse.

Environment variable: virtuosoPulseYellowLightAlert

Time to Start Auto Logging

Specifies the threshold level in seconds of continuous Virtuoso Studio alerts or system event alarms to start an auto capture of logs.

Environment variable: autoLogLatency

Refresh Interval

Specifies the interval in seconds to trigger a backtrace to get a callstack.

Environment variable: virtuosoPulseRefreshInterval

System Pulse

Specifies the settings to monitor the System pulse measurements when enabled.

Yellow Light Alert

Specifies the threshold level in seconds of continuous system events to raise a system event alarm.

Environment variable: sysPulseYellowLightAlert

CPU Utilization

Specifies the threshold level in percentage of high CPU utilization to report a concentrated pulse.

Environment variable: cpuUtilization

Memory Utilization

Specifies the threshold level in percentage of high memory utilization to report a concentrated pulse.

Environment variable: memUtilization

Refresh Interval

Specifies the interval in seconds to measure the utilization of system resources.

Environment variable: sysPulseRefreshInterval

Display

Specifies the display settings for the Health Monitor form when it is pinned.

Toolbar

Specifies the settings for the Health Monitor toolbar:

  • Borderless: Displays the Health Monitor without the form header.
    Environment variable: toolbarBorderless
  • Autohide: Automatically hides the Health Monitor. The Borderless option must be selected for this option to be enabled.
    Environment variable: toolbarAutohide

Related Topics

sysPulseRefreshInterval

virtuosoPulseRefreshInterval

Monitor by Strace Form

Health Monitor Overview

Health Monitor Form

Diagnostic Center Form

Collecting Data Using Health Monitor Tool


Return to top
 ⠀
X