Command Line Utility

In addition to the main GUI application, SysGauge provides a command line utility allowing one to perform system monitoring operations, save various types of system monitoring reports, automatically analyze the system status and save system status analysis reports. The SysGauge command line utility is located in the product 'bin' directory.

Command Line Syntax:

sysgauge -monitor [ -profile <Profile Name> ]

Starts a system monitoring operation.

sysgauge -analyze

Performs an automated system analysis operation.

Optional Parameters:

-time <Seconds> - specifies the maximum monitoring time in seconds.

-silent - disables the command output, which is useful for silent generation of reports.

-save_html_report [ <Dir Name> or <File Name> ] - saves an HTML system monitoring report.

-save_excel_report [ <Dir Name> or <File Name> ] - saves an Excel system monitoring report.

-save_text_report [ <Dir Name> or <File Name> ] - saves a text system monitoring report.

-save_pdf_report [ <Dir Name> or <File Name> ] - saves a PDF system monitoring report.

-save_csv_report [ <Dir Name> or <File Name> ] - saves a CSV system monitoring report.

-save_xml_report [ <Dir Name> or <File Name> ] - saves an XML system monitoring report.

Profile Management Commands:

sysgauge -show_profiles - shows configured system monitoring profiles.

sysgauge -show_profile <Profile Name> - shows the specified system monitoring profile.

sysgauge -add_profile <Profile Name> [ -mode <Profile Mode> ]

Adds a new system monitoring profile.

The profile mode may be set to one of the following values:

  • DEFAULT - adds a default system monitoring profile.
  • CPU - adds a CPU usage monitoring profile.
  • MEMORY - adds a memory usage monitoring profile.
  • DISK - adds a disk activity monitoring profile.
  • NETWORK - adds a network activity monitoring profile.
  • EMPTY - adds an empty system monitoring profile.

sysgauge -copy_profile <Profile Name> -to <Copy Profile Name>

Copies the specified system monitoring profile.

sysgauge -rename_profile <Profile Name> -to <New Profile Name>

Renames the specified system monitoring profile.

sysgauge -delete_profile <Profile Name>

Deletes the specified system monitoring profile.

Counter Management Commands:

sysgauge -show_supported_counters

Shows all supported system monitoring counters.

sysgauge -show_counter_instances [ -computer <Computer Name> ]

Shows a list of instances for the specified system monitoring counter.

sysgauge -add_counter <Counter Name> -profile <Profile Name>
[ -instance <Counter Instance> -computer <Computer Name> ]

Adds a system monitoring counter to the specified profile.

sysgauge -delete_counter <Counter Name> -profile <Profile Name> [ -id <Counter ID> ]

Deletes a system monitoring counter from the specified profile.

SysGauge Server Commands:

sysgauge -server_status

This command shows the status of the SysGauge Server.

sysgauge -server_start_monitor

This command starts the SysGauge Server monitor.

sysgauge -server_reset_monitor

This command resets the SysGauge Server monitor.

sysgauge -server_stop_monitor

This command stops the SysGauge Server monitor.

sysgauge -server_show_counter <Counter ID> [ -history <History Length> ]

This command shows the specified system monitoring counter.

sysgauge -server_export_config [ -file <File Name> or -dir <Directory Name> ]

This command exports the SysGauge Server configuration to the specified file or directory.

sysgauge -server_import_config -file <Config File Name>

This command imports the SysGauge Server configuration from the specified file.

sysgauge -server_debug_log

This command shows the SysGauge Server debug log.

sysgauge -server_clear_debug_log

This command clears the SysGauge Server debug log.

sysgauge -server_about

This command shows the SysGauge Server about information.

Optional Arguments for SysGauge Server Commands:

-host

This parameter specifies the host name or an IP address of the SysGauge Server to connect to. If the host name is not specified, the command line utility will connect to the local host.

-port

This parameter specifies the SysGauge Server TCP/IP port number (default is 9221).

-user

This parameter specifies the SysGauge Server user name (default is admin).

-password

This parameter specifies the SysGauge Server password (default is admin).