1PMDASYSTEMTAP(1)             Performance Co-Pilot             PMDASYSTEMTAP(1)
2
3
4

NAME

6       pmdasystemtap - Systemtap performance metrics domain agent (PMDA)
7

DESCRIPTION

9       pmdasystemtap is a Performance Metrics Domain Agent (PMDA) which
10       exports metric values from the Linux Systemtap dynamic tracing toolkit.
11
12       This implementation uses the stap(1) tool, which is a front-end to the
13       Systemtap toolkit.
14

INSTALLATION

16       In order to access performance data exported by Systemtap from with
17       PCP, it is necessary to perform two configuration steps:
18
19       1.  Configure Systemtap probes, and verify them with stap(1).  These
20           should be produced in a format that is easily parsed, and then
21           stored in the $PCP_PMDAS_DIR/systemtap/probes.stp file.
22
23       2.  Configure pmdasystemtap to extract the values from the text
24           produced by stap.  Two example probes are implemented in the
25           default systemtap PMDA script - readdir and sync traces (see
26           $PCP_PMDAS_DIR/systemtap/pmdasystemtap.pl for details).
27
28               # cd $PCP_PMDAS_DIR/systemtap
29               # [ edit probes.stp, test /usr/bin/stap probes.stp ]
30               # [ edit pmdasystemtap.pl ]
31
32       Once this is setup, you can access the names and values for the
33       systemtap performance metrics by doing the following as root:
34
35               # cd $PCP_PMDAS_DIR/systemtap
36               # ./Install
37
38       If you want to undo the installation, do the following as root:
39
40               # cd $PCP_PMDAS_DIR/systemtap
41               # ./Remove
42
43       pmdasystemtap is launched by pmcd(1) and should never be executed
44       directly.  The Install and Remove scripts notify pmcd(1) when the agent
45       is installed or removed.
46

FILES

48       $PCP_PMDAS_DIR/systemtap/probes.stp
49           probe configuration file for stap(1), run by pmdasystemtap
50
51       $PCP_PMDAS_DIR/systemtap/Install
52           installation script for the pmdasystemtap agent
53
54       $PCP_PMDAS_DIR/systemtap/Remove
55           undo installation script for the pmdasystemtap agent
56
57       $PCP_LOG_DIR/pmcd/systemtap.log
58           default log file for error messages from pmdasystemtap
59

SEE ALSO

61       pmcd(1) and stap(1).
62
63
64
653.3.3                        Performance Co-Pilot             PMDASYSTEMTAP(1)
Impressum