Remstats Home


  About remstats
  architecture
  Release Notes
  FAQ
  Conventions
  Prerequisites
  Installation
  Configuration
  Configuration Tools
  Servers
  Collectors
  Updater
  Monitors
  pagemakers
  run-remstats2
  CGIs
      alert.cgi
      availability.cgi
      dataimage.cgi
      datapage.cgi
      graph.cgi
      log-event.cgi
      macinfo.cgi
      ping.cgi
      show-config.cgi
      showlog.cgi
      traceroute.cgi
      whois.cgi
  troubleshooting
  do-traceroutes
  Miscellany
  Thank-you
  Index


  Live Data

  Remstats was written by
  Thomas Erskine at the
  CRC in Canada and now
  at SourceWorks.

[Top] [Prev] [Next]

graph.cgi - exporting remstats graphs

The purpose of graph.cgi is to allow remstats graphs to appear on external (not part of remstats) web-pages. It's not efficient, with the graphs being generated whenever the page is reloaded, but it is portable. All you do is to create an <IMG SRC...> tag with the appropriate values, like:

	<IMG SRC="/remstats/graph.cgi?host=aaa&rrd=bbb&graph=ccc&graphtime=ddd">

and replace aaa with the name of the host, as remstats knows it, bbb with the name of the RRD, ccc with the name of the graph within that RRD, and ddd with the name of the timespan, from the times config-file. If the RRD is a wildcard RRD, e.g. snmpif-*, then you must use the specific instance, e.g. snmpif-eth0.

The graphtime specifier may be replaced by start=xxx and end=yyy or omitted altogether. If start and end are specified, the permitted formats are documented in the manpage for rrdfetch. If you use the form:

	hh:mm dd.mm.yyy OFFSET

with OFFSET being a string composed of multiple ocurrences of plus or minus, a number and the units (s|min|h|d|mon|y). E.G. +2h+40min or -20d+5h

The graph's defined size may also be overridden using width=www and height=hhh. These specify the size, in pixels, of the graph portion of the image, not the whole image, as usual with rrdtool.

That's all there is to it.


[Top] [Remstats] [SourceWorks] [RRDtool] [SourceForge]
Last updated Fri Sep 5 07:34:13 UTC 2003 by <terskine@users.sourceforge.net>.