stripchart | ||
---|---|---|
<<< Previous | Next >>> |
The parameters displayed by the stripchart can be examined and edited using the Parameter Editor window. Although stripchart provides great potential for adding custom parameters, most users will initially be satisfied with the selecting from the list of pre-configured parameters supplied. Adding or deleting these parameters is described in the section called Parameter Editor Quickstart Guide.
To delete one of the currently active parameters:
Select the parameter to be deleted by clicking on its tab at the bottom of the Parameter Editor window;
Select the Edit menu item;
Select the Delete Parameter menu item.
To add one of the pre-defined parameters:
Select the Edit menu item;
Select either the Add Parameter Before or the Add Parameter Before menu item to insert a new empty parameter page;
Select one of the pre-defined parameters from the parameter itemlist on the "Parameter" line of the page. This will fill in the required fields for the newly created parameter, and begin plotting it.
FIX THIS
An equation used to obtain the value to be plotted for this parameter.
A value is obtained by evaluating the "equation" line using these field values. The first (or only) value is denoted by $1, the next by $2, and so forth. The difference between the field values between the last and the current iteration is denoted by ~1, ~2, and so forth. The elapsed time in seconds between the last and current iteration is ~t. The requested update interval is $i, and the delta (which will always be zero) is ~i.
The usual infix arithmetic operators — addition (+), subtraction (-), multiplication (*), division (/), and remaindering (%) — are available, along with parenthesis for grouping subexpressions.
The file from which a parameter value is read. When a filename beginning with a "|" is supplied, input lines will be read from a pipe.
On each iteration, a value to be displayed is obtained for each parameter in the configuration file. The file named in the "filename" line is opened -- either as a pipe if the filename begins with a pipe character ( | ), or as a regular file otherwise -- and a line is read.
If a pattern was specified, lines are read until one is found that contains the pattern string anywhere in the line. This line is split into a series of whitespace separated fields, each of which is interpreted as a floating point number.
The pattern which identifies the line from which a parameter value is to be extracted. If no pattern is provided, the first line of the file is used.
Normally, the stripchart program will be built with the libgtop library linked in. The libgtop library provides a portable and well-standardized method of accessing common system performance parameters. This is the preferred method of obtaining a value to be plotted.
The following libgtop parameters are available:
CPU Statistics — cpu_total, cpu_user, cpu_nice, cpu_sys, cpu_idle, and cpu_freq
Memory Statistics — mem_total, mem_used, mem_free, mem_shared, mem_buffer, mem_cached, mem_user, mem_locked
Swap Statistics — swap_total, swap_used, swap_free, swap_pagein, swap_pageout
Uptime Statistics — uptime, idletime
Loadavg Statistics — load_running, load_tasks, load_1m, load_5m, load_15m
Network Statistics — net_pkts_in, net_pkts_out, net_pkts_total, net_bytes_in, net_bytes_out, net_bytes_total, net_errs_in, net_errs_out, net_errs_total
Note that the network statistic values don't use the libgtop library. Instead, they are read directly from /proc/net/dev, and so are only available under Linux.
These are all signed long integer quantities, except for uptime, idletime, and the five load values which are floating point values.
<<< Previous | Home | Next >>> |
Preference Settings | Configuration and Parameter Files |