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 con
figuration 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 frequen
cies 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 per
formance 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 Log
ging 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.
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).
Man(1) output converted with
man2html