| 1 |
<?xml version='1.0'?> |
| 2 |
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ |
| 3 |
]> |
| 4 |
|
| 5 |
<chapter id="useful-systemtap-scripts"> |
| 6 |
<title>Useful SystemTap Scripts</title> |
| 7 |
<indexterm> |
| 8 |
<primary>SystemTap scripts</primary> |
| 9 |
<secondary>useful examples</secondary> |
| 10 |
</indexterm> |
| 11 |
|
| 12 |
<indexterm> |
| 13 |
<primary>examples of SystemTap scripts</primary> |
| 14 |
</indexterm> |
| 15 |
|
| 16 |
<indexterm> |
| 17 |
<primary>useful examples of SystemTap scripts</primary> |
| 18 |
</indexterm> |
| 19 |
|
| 20 |
<indexterm> |
| 21 |
<primary>systemtap-testsuite package</primary> |
| 22 |
<secondary>sample scripts</secondary> |
| 23 |
</indexterm> |
| 24 |
|
| 25 |
<para>This chapter enumerates several SystemTap scripts you can use to monitor and investigate different subsystems. All of these scripts are available at <filename>/usr/share/systemtap/testsuite/systemtap.examples/</filename> once you install the <filename>systemtap-testsuite</filename> RPM.</para> |
| 26 |
<!-- |
| 27 |
<para><ulink url="http://sourceware.org/systemtap/examples/subsystem-index.html">http://sourceware.org/systemtap/examples/subsystem-index.html</ulink></para> |
| 28 |
|
| 29 |
--> |
| 30 |
<remark> |
| 31 |
short intro, reference to online source (http://sourceware.org/systemtap/examples/subsystem-index.html); "always updated" |
| 32 |
</remark> |
| 33 |
|
| 34 |
<remark>short description of gnuplot (?) for better GUI of results</remark> |
| 35 |
|
| 36 |
<remark>case studies and more info on some scripts here - http://sourceware.org/systemtap/wiki/WarStories</remark> |
| 37 |
|
| 38 |
<!-- <xi:include href="Useful_Scripts-Disk.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> --> |
| 39 |
<section id="mainsect-network"> |
| 40 |
<title>Network</title> |
| 41 |
<para>The following sections showcase scripts that trace network-related functions and build a profile of network activity.</para> |
| 42 |
<xi:include href="Useful_Scripts-nettop.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 43 |
<xi:include href="Useful_Scripts-sockettrace.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 44 |
<xi:include href="Useful_Scripts-tcp_connections.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 45 |
<xi:include href="Useful_Scripts-tcpdumplike.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 46 |
<xi:include href="Useful_Scripts-dropwatch.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 47 |
</section> |
| 48 |
<section id="mainsect-disk"> |
| 49 |
<title>Disk</title> |
| 50 |
<para>The following sections showcase scripts that monitor disk and I/O activity.</para> |
| 51 |
|
| 52 |
<xi:include href="Useful_Scripts-disktop.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 53 |
<!-- <xi:include href="Useful_Scripts-IO.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> --> |
| 54 |
<xi:include href="Useful_Scripts-iotime.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 55 |
<xi:include href="Useful_Scripts-traceio.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 56 |
<xi:include href="Useful_Scripts-traceio2.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 57 |
<!-- <xi:include href="Useful_Scripts-Kernel.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> --> |
| 58 |
<xi:include href="Useful_Scripts-inodewatch.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 59 |
<xi:include href="Useful_Scripts-inodewatch2.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 60 |
<xi:include href="Useful_Scripts-ioblktime.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 61 |
</section> |
| 62 |
|
| 63 |
<section id="mainsect-profiling"> |
| 64 |
<title>Profiling</title> |
| 65 |
<para>The following sections showcase scripts that profile kernel activity by monitoring function calls.</para> |
| 66 |
<xi:include href="Useful_Scripts-functioncalls.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 67 |
<xi:include href="Useful_Scripts-paracallgraph.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 68 |
<xi:include href="Useful_Scripts-threadtimes.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 69 |
<xi:include href="Useful_Scripts-timeout.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 70 |
<xi:include href="Useful_Scripts-topsys.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 71 |
<xi:include href="Useful_Scripts-syscallsbyprocpid.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 72 |
</section> |
| 73 |
<!-- removed; handler function no longer working as expected |
| 74 |
<xi:include href="Useful_Scripts-kernelprofiling.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> --> |
| 75 |
|
| 76 |
|
| 77 |
<xi:include href="Useful_Scripts-futexes.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 78 |
|
| 79 |
<!-- <xi:include href="Useful_Scripts-Network.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 80 |
<xi:include href="Useful_Scripts-Signals.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 81 |
<xi:include href="Useful_Scripts-Syscalls.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 82 |
<xi:include href="Useful_Scripts-Others.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />--> |
| 83 |
<!-- |
| 84 |
<xi:include href="" xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 85 |
--> |
| 86 |
</chapter> |
| 87 |
|