Home  · Views  · Charts  · Time Control

Command Line Options

 

-a archive

Performance metric values are retrieved from the Performance Co-Pilot (PCP) archive log file identified by the base name archive, by default. The initial Tab created will be an archive mode Tab. Multiple -a options can be presented, and the list of archives is used for sourcing metric values. Any sources listed on the command line are assumed to be archives if this option is used.

-c configfile

configfile specifies an initial view to load, using the default source of metrics. Multiple -c views can be specified, and they will all be opened in the default Tab with the default source of metrics.

-C

Used with -c, the view(s) are parsed, any errors are reported, and the tool exits. This is primarily intended for testing purposes. If a second -C option is presented, kmchart also connects to pmcd(1) to check the semantics of metrics.

-h host

Current performance metric values are retrieved from the nominated host machine by default. Multiple -h options can be presented, and the list of hosts is used for sourcing metric values. Any sources listed on the command line are assumed to be hosts if this option is used.

-p port

Port number for connection to an existing kmtime time control process.

-s samples

Specifies the number of samples that will be retained before discarding old data (replaced by new values at the current time position). This value can subsequently be modified through the Edit Tab dialog.

-t delta

Sets the inital update interval to something other than the default 1 second. The interval argument follows the syntax described in PCPIntro(1), and in the simplest form may be an unsigned integer (the implied units in this case are seconds).

-v points

Sets the inital visible samples that will be displayed in all charts in the default Tab. This value must be less than or equal to the total number of samples retained (the -s value).

-Z

By default, kmtime reports the time of day according to the local timezone on the system where kmchart is run. The -Z option changes the timezone to timezone in the format of the environment variable TZ as described in environ(5).

-z

Change the reporting timezone to the local timezone at the host that is the source of the performance metrics, as identified via either the -h or -a options.

The -S, -T, -O and -A options may be used to define a time window to restrict the samples retrieved, set an initial origin within the time window, or specify a "natural" alignment of the sample times; refer to the PCP Introduction for a complete description of these options.


Copyright © 2007-2008 Aconex

kmchart