1RAGRAPH(1) General Commands Manual RAGRAPH(1)
2
6 ragraph - graph argus(8) data.
7
9 ragraph metric [object] [-M mode] [options] [raoptions] [-- filter-
10 expression]
11
13 Ragraph reads argus(8) data from an argus-file, and graphs fields of
14 interest from matching argus flow activity records. You must specify
15 the metric(s), the flow object/identifier(s) and the time granularity
16 required for the graph. Standard raoptions are available to filter
17 input and specify the time range of interest, and graphing options are
18 provided to specify x and y axis labels, titles, upper and lower range
19 limits, and plot sizes. Support for logorithmic scaling, object stack‐
20 ing, and split graphing are provided to provide some flexibility in the
21 graphs you can produce.
22 Ragraph supports graphing most metrics that are available in argus
24 data, including, bytes, packet counts, average duration, loss, jitter,
25 load, and rate. These metrics can be graphed in association with flow
26 identifiers, such as source or destination address, network address,
27 source identifier, protocol, port numbers, services, vlan id, mpls tag,
28 ttl, and tos values. Currently, there are limits to the number of met‐
29 rics and objects that can be graphed at one time, so assume that
30 ragraph is a simple graphing tool.
31 By default ragraph writes its output to ragraph.png, in the current
33 directory. Use the '-w' raoption to specify an alternate output file‐
34 name.
35 Ragraph is implemented as a perl script front-end to the routine rabins
37 and rrd-tool, which is used to generate PNG formatted graphs. As a
38 result ragraph supports all the raoption and most of the options to the
39 rrd-tool graphing functions.
40
43 Ragraph, like all ra based clients, supports a number of ra options
44 including filtering of input argus records through a terminating filter
45 expression, and specifying an output filename using the -w option.
46 See ra(1) for a complete description of ra options.
48
51 Ragraph, when using rrdtool as the graphing backend, will pass rrdgraph
52 specific options to the appropriate rrdtool module. These are the spe‐
53 cific rrdtool options that are supported.
54
56 -fill
57 Turn off area fill.
58 -stack
60 Turn off data stacking.
61 -split
63 Turn off axis splitting for src/dst(in/out) traffic.
64 -invert
66 Invert a split graph, so that src and dest data are flipped.
67 -rigid
69 Pass rrdtool rigid parameter to rrdgraph.
70
72 -title string
73 Specify a graph title.
74 -vertical-label string
76 Specify a vertically placed yaxis label.
77
79 -height pixels
80 Specify height in pixels for the graph (275 pixels)
81 -width pixels
83 Specify width in pixels for the graph (800 pixels)
84 -only-graph
86 Generate only the graph with out any borders, title, labels, leg‐
87 end.
88
90 -upper value
91 Specify upper bounds for graphing data (automatic).
92 -lower value
94 Specify lower bounds for graphing data (automatic). When data is
95 split, you need to specify the value as a negative number.
96 -alt-autoscale
98 -alt-autoscale-max
100 Use rrdtool alternate y-axis autoscale algorithm. See rrdgraph
101 manpage for information.
102 -no-gridfit
104 Disable rrdtool grid scale modification strategies. See rrdgraph
105 manpage for information.
106
108 -x-grid GTM:GST:MTM:MST:LTM:LST:LPR:LFM | none
109 Modify rrdtool x-axis label definition. See rrdgraph manpage for
110 information.
111 -y-grid 'grid step:label factor' | none
113 Modify rrdtool y-axis label definition. The use of ' is important
114 to parsing the option correctly. See rrdgraph manpage for informa‐
115 tion.
116 -alt-y-grid
118 Modify rrdtool default y-grid behavior. See rrdgraph manpage for
119 information.
120 -log
122 Use logarithmic scale for y-axis.
123 -units-exponent value
125 Set the 10** exponent scaling of the y-axis. See rrdgraph manpage
126 for information.
127 -units-length value
129 Set the width of the y-axis border. See rrdgraph manpage for
130 information.
131 -units=si
133 Turn off expoenential notation for logarithmic graphs. See rrd‐
134 graph manpage for information.
135
137 -imginfo printfstr
138 Adds img information to the graph. See rrdgraph manpage for infor‐
139 mation.
140 -zoom factor
142 Zoom the graphics by the given factor. See rrdgraph manpage for
143 information.
144 -font FONTTAG:size:[font]
146 Modify rrdgraph default font. See rrdgraph manpage for informa‐
147 tion.
148 -font-render-mode {normal,light,mono}
150 Modify rrdgraph font smoothing strength. See rrdgraph manpage for
151 information.
152 -font-smoothing-threshold size
154 Modify rrdgraph font smoothing font size. See rrdgraph manpage for
155 information.
156 -slope-mode
158 Modify rrdgraph slope-mode option. See rrdgraph manpage for infor‐
159 mation.
160 -no-legend
162 Supress generation of the legend.
163 -watermark string
165 Adds the given string as a watermark. See rrdgraph manpage for
166 information.
167 -norrdwmark
169 Disables the default rrdtool watermark from appearing on the graph.
170
173 To graph the total load for the data in an argus-file argus.data at 10
174 second intervals:
175 ragraph bytes -M 10s -r argus.data -title "Total Load"
176 To graph the rate (pkt/sec) on a destination port basis for the data
178 from a specific probe in an argus-file argus.data at 1 minute inter‐
179 vals:
180 ragraph bytes dport -M 1m -r argus.data - srcid 192.168.0.10
181
184 Copyright (c) 2000-2016 QoSient. All rights reserved.
185
187 Carter Bullard (carter@qosient.com).
188
190 rrdtoolhttp://oss.oetiker.sh/rrdtool ragraph(5), ra(1), rarc(5),
191 argus(8)
192ragraph 3.0.8 21 July 2001 RAGRAPH(1)