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