---
name: "stapgraph"
section: "1"
platform: "linux"
package: "systemtap-grapher"
version: "1.7-1+deb7u1"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/stapgraph"
---

# stapgraph(1)

systemtap grapher

## 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\>**.