NAME
pmtrace - command line performance instrumentation
SYNOPSIS
pmtrace [-q] [-c value | -e command | -v value] [-h host]
tag
DESCRIPTION
pmtrace provides a simple command line interface to the
trace Performance Metrics Domain Agent (PMDA) and the
associated pcp_trace library.
The default pmtrace behavior is to provide point trace
data to the trace PMDA, using the tag argument as the
identifying name associated with each trace point. The
tag then becomes an instance identifier within the set of
trace.point metrics.
The -e option allows an arbitrary command to be executed.
This command will be measured as a transaction since it
has well defined start and end points. The information is
made available through the trace.transact metrics.
Trace data can be sent to the trace PMDA running on host,
rather than the localhost, using the -h option. This
overrides use of the environment variable PCP_TRACE_HOST.
The -q option suppresses messages from a successful trace,
so that pmtrace runs quietly.
The -c option allows an arbitrary counter value to be
exported through the trace.count metrics, while the -v
option allows an arbitrary floating point value to be
exported through the trace.observe metrics
ENVIRONMENT
Since pmtrace uses the libpcp_trace library routines, the
environment variables PCP_TRACE_HOST, PCP_TRACE_PORT, and
PCP_TRACE_TIMEOUT are all honored. Refer to pmdatrace(3)
for a detailed description of the semantics of each.
FILES
$PCP_DEMOS_DIR/trace/pmtrace.c
source code for pmtrace
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,
SEE ALSO
file:$PCP_VAR_DIR/Tutorial/trace.html, pcp.man.tutorial,
pmcd(1), pmdatrace(1), pmprobe(1), PMAPI(3), pmdatrace(3),
Tutorial. Provided the, subsystem from the PCP images has
been installed, access the URL, For IRIX users, relevant
information is also available from the on-line PCP and
from your web browser.
DIAGNOSTICS
All are generated on standard error and are intended to be
self-explanatory.
The pmtrace exit status is always zero except when the -e
option is in use, in which case the exit status of command
is returned.
Man(1) output converted with
man2html