NAME¶
stapgraph - systemtap grapher
SYNOPSIS¶
stapgraph [
OPTIONS ]
FILENAME [
ARGUMENTS ]
stapgraph [
OPTIONS ]
- [
ARGUMENTS ]
stapgraph [
OPTIONS ]
-e SCRIPT [
ARGUMENTS ]
DESCRIPTION¶
The
stapgraph program is a simple frontend to
stap that produces
graphs from the output of
stap scripts.
This manual corresponds to version 1.7.
OPTIONS¶
stapgraph accepts all options accepted by
stap. They are passed
through to the
stap process running the script or probe points.
USER INTERFACE¶
The script that produces results can be started from a dialog within the
program, in addition to being launched using the program's command line
arguments. This dialog allows arguments to be passed to
stap and to the
script.
When running, a mouse left click on a graph pauses the display of data, even
though it is still collected by the program. Dragging the mouse scrolls the
graph backwards and forwards in time; clicking the displayed pause button
restarts the display of new data.
The scroll wheel can be used to zoom in and out on the graph.
SCRIPT OUTPUT SYNTAX¶
Scripts can output Comma Separated Values (CSV) which will be interpreted by
stapgraph. The first value is the X coordinate of the graph, usually a
time value.
stapgraph assumes that this value is constantly increasing.
A different syntax allows the script to specify many details of the graph's
appearance.
- %DataSet: DATA-SET-NAME SCALE COLOR
GRAPHSTYLE
The data set name identifies a data set that will be emitted by the script.
"SCALE" is the overall vertical scale of the graph for this data
set. "COLOR" is a red-green-blue hex color. "GRAPHSTYLE"
is one of bar - a traditional bar graph dot - plotted points discreet - An
event style timeline that records that an event happened at a certain time.
- %Title: TITLE
- A title for the whole graph.
- %XAxisTitle: TITLE
- The legend for the X axis
- %YAxisTitle: TITLE
- The legend for the Y axis.
- %YMax: MAX VALUE
- The maximum value displayed on the graph.
GRAPH DATA¶
DATA SET TIME
VALUE Each data point that is to be plotted is
tagged with the data set name, followed by the time and value of the point.
SEE ALSO¶
stap(3stap),
staprun(3stap),
BUGS¶
Use the Bugzilla link off of the project web page or our mailing list.
http://sourceware.org/systemtap/,
<systemtap@sourceware.org>.