blob: a2d4aab1a017b3cc2972b16357c20f3b5d367fe6 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
|
pmclient - a sample client using the PMAPI
==========================================
pmclient is a sample client that uses the Performance Metrics
Application Programming Interface (PMAPI) to report some performance
data, collected from either a local host, a remote host, or a
Performance Co-Pilot (PCP) performance metrics archive log.
The binary is shipped as part of pcp and is typically installed in
/usr/bin/pmclient. A pmclient(1) "man" page is shipped in the pcp
package also.
The source is shipped as part of the pcp development packages and
is installed in $PCP_DEMOS_DIR/pmclient. If you have a C compiler
installed, the source and Makefile in this directory may be used to
create a functionally equivalent binary, by entering the command
% make
The source in pmclient.c demonstrates many of the PMAPI services, and
may be used as a template and style guide when creating your own PMAPI
clients. Note in particular, the use of ./pmnsmap.spec and the shipped
tool pmgenmap(1) to assist in the creation of arguments to the PMAPI
routines, and the manipulation of PMAPI data structures.
To experiment with the archives,
% rm -f mylog.*
% config=$PCP_DEMOS_DIR/pmclient/pmlogger.config
% cat $config
% pmlogger -c $config -s 6 mylog
this will collect 30 seconds of performance data into the archive
stored as the files mylog.*. To play this back,
% pmclient -a mylog
|
