pmrepconf may be used to create and modify a generic
configuration file for pmrep(1) and related utilities in the
If configfile does not exist, pmrepconf will create a generic
configuration file with a set of discovered metrics in a
Once created, configfile may be used with the -c option to
pmrep(1) and related utilities such as pcp2elasticsearch(2) and
If configfile does exist, pmrepconf will prompt for input from
the user to enable or disable groups of related performance
Group selection requires a simple y (yes) or n (no) response to
the prompt Log this group?.
Other responses at this point may be used 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.
When run from automated setup processes, the -c option is used to
indicate that pmrepconf is in auto-create mode and no interactive
dialog takes place. The output configfile has an additional
comment message and timestamp indicating this fact, so that it
can be identified and subsequently updated using -c again. This
option is not appropriate for interactive use of the tool.
More verbose output may be enabled with the -v option.
When an initial configfile is created, the default specifications
come from a set of group files below the groupsdir specified with
the -d option (the default groupsdir is
$PCP_VAR_DIR/config/pmlogconf which is most commonly correct, so
the -d option is rarely used in practice).
The directory structure and format of files below groupsdir is
shared with the pmlogconf(1) utility, and described in detail on
that manual page. When used by pmrepconf all interval settings
The available command line options are:
-c Enable non-interactive, auto-create mode.
-d groupdir, --groups=groupdir
Specify the path to the groupsdir directory.
-g grouptag, --group=grouptag
Query logging state for the specific group named grouptag.
-h host, --host=host
Performance metrics source is pmcd(1) on host, rather than
on the default localhost.
-o option, --option=option
Specify an option to be added to the [option] secton of the
generated pmrep.conf(5) file. This command line option can
be presented multiple times in order to added multiple lines
in the [option] section.
Reconsider every group for inclusion in the configfile.
Enable verbose mode.
Display version number and exit.
Display usage message and exit.
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
pmrepconf overrides any $PCP_DERIVED_CONFIG environment variable
to an empty string, for performance reasons.
pmrepconf honours the $PMCD_WAIT_TIMEOUT environment variable
when probing and creating new pmrep configuration files. It uses
a default timeout value of 10 seconds for this, in the absence of
an environment setting.
This page is part of the PCP (Performance Co-Pilot) project.
Information about the project can be found at
⟨http://www.pcp.io/⟩. If you have a bug report for this manual
page, send it to firstname.lastname@example.org. This page was obtained from the
project's upstream Git repository
⟨https://github.com/performancecopilot/pcp.git⟩ on 2021-08-27.
(At that time, the date of the most recent commit that was found
in the repository was 2021-08-27.) If you discover any rendering
problems in this HTML version of the page, or you believe there
is a better or more up-to-date source for the page, or you have
corrections or improvements to the information in this COLOPHON
(which is not part of the original manual page), send a mail to
Performance Co-Pilot PCP PMREPCONF(1)