Tools pmlc pmafm pmlogger pmdumplog mpvis mkaf
This chapter of the Performance Co-Pilot tutorial covers PCP tools for creating and managing PCP archive logs.
For an explanation of Performance Co-Pilot terms and acronyms, consult the PCP glossary .
The Performance Co-Pilot includes many facilities for creating and replaying archive logs that capture performance information.
For all PCP monitoring tools, metrics values may come from a real-time feed (i.e. from pmcd on some host), or from an archive log.
Users have complete control of what metrics are collected, how often and in which logs. These decisions can be changed dynamically.
The primary instance of the PCP archive logger ( pmlogger ) may be started on a collector system each time pmcd is started.
This action is controlled by the chkconfig option `pmlogger'. To turn it on, as root do the following:
# chkconfig pmlogger on
# $PCP_RC_DIR/pcp start
The specification for hosts to log, and pmlogger options is given in the $PCP_PMLOGGERCONTROL_PATH file, and (optionally) files in the $PCP_PMLOGGERCONTROL_PATH.d directory.
This has a default entry for the local host, which specifies the metrics to be logged, and the frequency of logging - by default, using the file $PCP_CONFIG_DIR/pmlogger/config.default.
Additional instances of pmlogger may be started at any time, running on either a collector system or a monitor system.
In all cases, each pmlogger instance will create an archive log for metrics from a single collector system.
The initial specification of what to log is given in a configuration file; the syntax is fully described in the pmlogger (1) man page.
Some configuration files are supplied, e.g. to create archive logs suitable for the PCP visualization tools. These may be found in the directory $PCP_CONFIG_DIR/pmlogger.
A simple example has been provided to illustrate the creation of an archive log, and subsequent playback using mpvis . (All of the PCP monitoring tools accept the command line arguments -a archivename to replay from an archive).
In a command shell enter:
$ source /etc/pcp.conf $ cd /tmp $ rm -f myarchive.* $ $PCP_BINADM_DIR/pmlogger -T 30sec -t 1sec \ -c $PCP_CONFIG_DIR/pmlogger/config.mpvis myarchive $ ls myarchive.* $ mpvis -a myarchive
$ pmdumplog -L myarchiveFor more information on pmdumplog refer to the pmdumplog (1) man page.
An archive folio is a named collection of PCP archives. These are typically used to provide a convenient way of processing multiple, correlated PCP archives.
Archive folios are created with mkaf .
The contents of an archive folio can be processed using the pmafm utility.
A simple example has been provided to illustrate the creation and subsequent processing of a folio.
In a command shell enter:
$ source /etc/pcp.conf $ cd /tmp $ tar xzf $PCP_DEMOS_DIR/tutorials/pmie.tar.gz $ tar xzf $PCP_DEMOS_DIR/tutorials/cpuperf.tar.gz $ $PCP_BINADM_DIR/mkaf pmie/babylon.perdisk.0 \ cpuperf/babylon.percpu.0 > myfolio $ pmafm myfolio list $ pmafm myfolio pmdumplog -l
For more information on folios refer to the mkaf (1) and pmafm (1) man pages.
The pmlc utility may be used to interrogate any pmlogger instance running either locally or remotely. Use pmlc to
The line-oriented command interface to pmlc (1) is fully described in the man page.
PCP includes a suite of scripts and tools to automate the collection and management of archives.
Briefly, these facilities include: