pmlogconf

Langue: en

Autres versions - même langue

Version: SGI (debian - 07/07/09)

Section: 1 (Commandes utilisateur)

NAME

pmlogconf - create/edit a pmlogger configuration file

SYNOPSIS

$PCP_BINADM_DIR/pmlogconf [-q] configfile

DESCRIPTION

pmlogconf may be used to create and modify a generic configuration file for the PCP archive logger, pmlogger(1).

configfile may be used with the -c option to pmlogger(1) to select performance metrics and specify logging frequencies for a PCP archive.

If configfile does not exist, pmlogconf will create a generic configuration file with the default set of enabled metrics and logging frequencies.

If configfile does exist, pmlogconf will prompt for input from the user to enable or disable groups of related performance metrics, and to control the logging frequency for each enabled group.

Group selection requires a simple y (yes) or n (no) response to the prompt Log this group?.

Other responses are supported at this point to select additional control functions as follows:

m
Report the names of the metrics in the current group.
q
Finish with group selection (quit), and make no further changes to this group or any subsequent group.
/pattern

Make no change to this group, but search for a group containing pattern in the description of the group, or the names of the associated metrics.

Logging frequency is specified by responding to the Logging interval? prompt with the keywords once or default or a valid pmlogger(1) interval specification of the form ``every N timeunits'' or simply ``N timeunits'', where every is optional, N is an unsigned integer, and timeunits is one of the keywords msec, millisecond, sec, second, min, minute, hour or the plural form of one of the above.

The -q option supresses the logging interval dialog and uses the current or the default interval.

PCP ENVIRONMENT

Environment variables with the prefix PCP_ are used to parameterize the file and directory names used by PCP. On each installation, the file /etc/pcp.conf contains the local values for these variables. The $PCP_CONF variable may be used to specify an alternative configuration file, as described in pcp.conf(4).

SEE ALSO

pmlogger(1), pcp.conf(4) and pcp.env(4).