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).