GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  RTGPLOT (1)

NAME

rtgplot - generate plots of RTG data

CONTENTS

Synopsis
Description
Options
Version
Author

SYNOPSIS

rtgplot -h[elp]
rtgplot -t tablename(s) -i interface(s) [options] begin end
rtgplot.cgi ?t1=tablename &t‘_name=descname &t2=tablename &t2_name=descname &iid=interface &begin=unixtime &end=unixtime &[options]

DESCRIPTION

rtgplot generates traffic plots of RTG data in PNG format. It operates in two modes: either taking command line arguments or parsing stdin from a web page CGI. An RTG plot can be embedded in any HTML page simply with an IMG tag and appropriate arguments. Unless otherwise specified, it outputs the PNG plot to stdout. rtgplot minimally requires MySQL table name, MySQL interface id and UNIX epoch start and end arguments. In addition, there are several optional arguments that modify the plot appearance or logic.

OPTIONS

-o file Output file, PNG format. Defaults to stdout. Command line only.
-f factor | factor=<factor>
  Multiply all values by this integer <factor> e.g. to covert bytes to bits.
-u label | units=<units>
  Y-axis units label.
-g | gauge=yes
  For gauge type plots. I.e. continuous gauge data such as CPU or temperature plots.
-p | impulses=yes
  For impulse type plots. I.e. non-continuous data such as error plots.
-a | aggr=yes
  Aggregate values of each interface into a single line.
-x | scalex=yes
  Scale X-axis to current time.
-y | scaley=yes
  Scale Y-axis to interface speed.
-l | filled=yes
  Fill in area beneath first plotted line.
-d percent | percentile=<percent>
  Add a <percent> percentile line.
-v | debug=<level>
  Increase verbosity. Can be used multiple times. Use debug argument when debugging a CGI call; debug output is placed in /tmp directory. <level> is between 0 and 3, 3 being the most verbose debugging.
-m size | xplot=<size>
  Set plot width to <size> pixels.
-n size | yplot=<size>
  Set plot height to <size> pixels.
-b size | borderb=<size>
  Set plot bottom border to <size> pixels.
title=<title>
  Set graph title to <title>

EXAMPLES

Example HTML IMG TAG:

<IMG SRC="rtgplot.cgi? t1=ifInOctets_2& t1_name=Input& t2=ifOutOctets_2& t2_name=Output& iid=4& begin=1046754000& end=1046840399& units=bits/s& factor=8& scalex=yes& title=Bandwidth+Graph">

will plot two lines from the MySQL tables ifInOctets_2 and ifOutOctets_2 corresponding to interface 4 on router 2 for the time span 1046754000 to 1046840399 (UNIX epoch seconds). The factor argument allows for bits per second; the units argument is displayed as the Y-axis label on the plot. The scalex argument auto-adjusts the X time axis according to the available data samples rather than according to the actual time span given. It will have a graph title of "Bandwidth Graph" and legend tags of "Input" and "Output" for t1 and t2 respectively.

Draw a 95th percentile line:

<IMG SRC="rtgplot.cgi? t1=ifInOctets_2& t2=ifOutOctets_2& iid=4& begin=1046754000& end=1046840399& units=bits/s& factor=8& percentile=95> percentile=95>

Draw input and output bits per second for three different interfaces on the same plot. Enlarge the plot bottom border to fit extra legends:

<IMG SRC="rtgplot.cgi? t1=ifInOctets_2& t2=ifOutOctets_2& iid=4& iid=5& iid=7& xplot=500& yplot=150& borderb=150& begin=1046754000& end=1046840399& units=bits/s& factor=8>

As last example, but aggregate input and output bits per second for the three different interfaces.

<IMG SRC="rtgplot.cgi? t1=ifInOctets_2& t2=ifOutOctets_2& iid=4& iid=5& iid=7& begin=1046754000& end=1046840399& units=bits/s& factor=8& aggr=yes>

SEE ALSO

rtgpoll(1)

VERSION

This manual page documents rtgplot version 0.7.4

AUTHOR

(c) 2002-2003 by Robert Beverly

Search for    or go to Top of page |  Section 1 |  Main Index


Manual page for rtgplot RTGPLOT (1) August 2003

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.