NAME
pmdatrivial - trivial performance metrics domain agent
(PMDA)
SYNOPSIS
$PCP_PMDAS_DIR/trivial/pmdatrivial [-d domain] [-l log
file]
DESCRIPTION
pmdatrivial is the simplest possible Performance Metrics
Domain Agent (PMDA) which exports a single performance
metric, the time in seconds since the 1st of January,
1970.
The trivial PMDA is shipped as source code and is designed
to be an aid for PMDA developers.
A brief description of the pmdatrivial command line
options follows:
-d It is absolutely crucial that the performance metrics
domain number specified here is unique and consis
tent. That is, domain should be different for every
PMDA on the one host, and the same domain number
should be used for the same PMDA on all hosts.
-l Location of the log file. By default, a log file
named trivial.log is written in the current directory
of pmcd(1) when pmdatrivial is started, i.e.
$PCP_LOG_DIR/pmcd. If the log file cannot be created
or is not writable, output is written to the standard
error instead.
INSTALLATION
If you want access to the names, help text and values for
the trivial performance metrics, do the following as root:
# cd $PCP_PMDAS_DIR/trivial
# ./Install
If you want to undo the installation, do the following as
root:
# cd $PCP_PMDAS_DIR/trivial
# ./Remove
pmdatrivial is launched by pmcd(1) and should never be
executed directly. The Install and Remove scripts notify
pmcd(1) when the agent is installed or removed.
FILES
command line options used to launch pmdatrivial
$PCP_PMDAS_DIR/trivial/help
default help text file for the trivial metrics
$PCP_PMDAS_DIR/trivial/Install
installation script for the pmdatrivial agent
$PCP_PMDAS_DIR/trivial/Remove
undo installation script for the pmdatrivial
agent
$PCP_LOG_DIR/pmcd/trivial.log
default log file for error messages and other
information from pmdatrivial
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
PCPIntro(1), pmcd(1), pmdasample(1), pmdasimple(1),
pmdatxmon(1) and PMDA(3).
CAVEATS
On Irix the trivial PMDA is part of the pcp.sw.demo sub
system and is not installed by default, it must be explic
itly installed using inst(1) or swmgr(1).
Since the trivial PMDA is shipped as source, the installa
tion requires the pmdatrivial binary to be created, which
means the C compiler and development environment must also
be installed.
Man(1) output converted with
man2html