Provided by: argus-client_3.0.8.2-3build1_amd64 bug


       ragraph - graph argus(8) data.


       ragraph metric [object] [-M mode] [options] [raoptions] [-- filter-expression]


       Ragraph  reads  argus(8)  data  from  an  argus-file,  and  graphs fields of interest from
       matching  argus  flow  activity  records.   You  must  specify  the  metric(s),  the  flow
       object/identifier(s)  and the time granularity required for the graph.  Standard raoptions
       are available to filter input and specify the time range of interest, and graphing options
       are  provided  to  specify  x and y axis labels, titles, upper and lower range limits, and
       plot sizes.  Support for logorithmic scaling, object  stacking,  and  split  graphing  are
       provided to provide some flexibility in the graphs you can produce.

       Ragraph supports graphing most metrics that are available in argus data, including, bytes,
       packet counts, average duration, loss, jitter, load,  and  rate.   These  metrics  can  be
       graphed  in  association  with  flow  identifiers,  such as source or destination address,
       network address, source identifier, protocol, port numbers, services, vlan id,  mpls  tag,
       ttl,  and  tos  values.   Currently, there are limits to the number of metrics and objects
       that can be graphed at one time, so assume that ragraph is a simple graphing tool.

       By default ragraph writes its output to ragraph.png, in the current  directory.   Use  the
       '-w' raoption to specify an alternate output filename.

       Ragraph  is  implemented  as  a  perl script front-end to the routine rabins and rrd-tool,
       which is used to generate PNG formatted graphs. As  a  result  ragraph  supports  all  the
       raoption and most of the options to the rrd-tool graphing functions.


       Ragraph, like all ra based clients, supports a number of ra options including filtering of
       input argus records through a terminating filter  expression,  and  specifying  an  output
       filename using the -w option.

       See ra(1) for a complete description of ra options.


       Ragraph,  when  using rrdtool as the graphing backend, will pass rrdgraph specific options
       to the appropriate rrdtool module.  These  are  the  specific  rrdtool  options  that  are


           Turn off area fill.

           Turn off data stacking.

           Turn off axis splitting for src/dst(in/out) traffic.

           Invert a split graph, so that src and dest data are flipped.

           Pass rrdtool rigid parameter to rrdgraph.


       -title string
           Specify a graph title.

       -vertical-label string
           Specify a vertically placed yaxis label.


       -height pixels
           Specify height in pixels for the graph (275 pixels)

       -width pixels
           Specify width in pixels for the graph (800 pixels)

           Generate only the graph with out any borders, title, labels, legend.


       -upper value
           Specify upper bounds for graphing data (automatic).

       -lower value
           Specify  lower  bounds for graphing data (automatic).  When data is split, you need to
           specify the value as a negative number.


           Use  rrdtool  alternate  y-axis  autoscale  algorithm.   See  rrdgraph   manpage   for

           Disable  rrdtool  grid  scale  modification  strategies.   See  rrdgraph  manpage  for


       -x-grid GTM:GST:MTM:MST:LTM:LST:LPR:LFM | none
           Modify rrdtool x-axis label definition.  See rrdgraph manpage for information.

       -y-grid 'grid step:label factor' | none
           Modify rrdtool y-axis label definition.  The use of '  is  important  to  parsing  the
           option correctly. See rrdgraph manpage for information.

           Modify rrdtool default y-grid behavior.  See rrdgraph manpage for information.

           Use logarithmic scale for y-axis.

       -units-exponent value
           Set the 10** exponent scaling of the y-axis.  See rrdgraph manpage for information.

       -units-length value
           Set the width of the y-axis border.  See rrdgraph manpage for information.

           Turn  off  expoenential  notation  for  logarithmic  graphs.  See rrdgraph manpage for


       -imginfo printfstr
           Adds img information to the graph.  See rrdgraph manpage for information.

       -zoom factor
           Zoom the graphics by the given factor.  See rrdgraph manpage for information.

       -font FONTTAG:size:[font]
           Modify rrdgraph default font.  See rrdgraph manpage for information.

       -font-render-mode {normal,light,mono}
           Modify rrdgraph font smoothing strength.  See rrdgraph manpage for information.

       -font-smoothing-threshold size
           Modify rrdgraph font smoothing font size.  See rrdgraph manpage for information.

           Modify rrdgraph slope-mode option.  See rrdgraph manpage for information.

           Supress generation of the legend.

       -watermark string
           Adds the given string as a watermark.  See rrdgraph manpage for information.

           Disables the default rrdtool watermark from appearing on the graph.


       To graph the total load for the data in an argus-file at 10 second intervals:
              ragraph bytes -M 10s -r -title "Total Load"

       To graph the rate (pkt/sec) on a destination port basis for the data from a specific probe
       in an argus-file at 1 minute intervals:
              ragraph bytes dport -M 1m -r - srcid


       Copyright (c) 2000-2016 QoSient. All rights reserved.


       Carter Bullard (


       rrdtool ragraph(5), ra(1), rarc(5), argus(8)