RAGRAPH(1)

✨ ragraph — graph argus(8) data ✨

okay bestie, this is the ragraph page from the General Commands Manual, and it is literally the tool that turns your argus flow data into actual pictures. graphs. visuals. we're not just staring at numbers anymore, we're curating them. 💅

---

🌸 NAME 🌸

ragraph — graph argus(8) data.

---

🦋 SYNOPSIS 🦋

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

---

✨ DESCRIPTION ✨

Okay so here's the vibe. Ragraph reads argus(8) data out of an argus-file, and then it graphs the fields you care about from the matching argus flow activity records. That's the whole personality. 📊

But you do have to tell it three things, no skipping:

1. the metric(s) you want
2. the flow object/identifier(s)
3. the time granularity required for the graph

The standard raoptions are all there to filter input and set the time range you're interested in, and then there's a whole set of graphing options for specifying x and y axis labels, titles, upper and lower range limits, and plot sizes. Support for logarithmic scaling, object stacking, and split graphing is provided so you get 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
• rate

And 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
• tos values

⚠️ real talk: 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. she's cute, she's not infinite. 🙈

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. slay. 👑

---

🌈 RA OPTIONS 🌈

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. iykyk 💖

---

💜 RRDTOOL GRAPH 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 supported.

---

🎀 Appearance 🎀

• -fill — Turn off area fill.
• -stack — Turn off data stacking.
• -split — Turn off axis splitting for src/dst(in/out) traffic.
• -invert — Invert a split graph, so that src and dest data are flipped.
• -rigid — Pass rrdtool rigid parameter to rrdgraph.

---

🏷️ Labels 🏷️

• -title string — Specify a graph title.
• -vertical-label string — Specify a vertically placed yaxis label.

---

📐 Size 📐

• -height pixels — Specify height in pixels for the graph (275 pixels)
• -width pixels — Specify width in pixels for the graph (800 pixels)
• -only-graph — Generate only the graph with out any borders, title, labels, legend.

---

🚧 Limits 🚧

• -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.
• -alt-autoscale
• -alt-autoscale-max — Use rrdtool alternate y-axis autoscale algorithm. See rrdgraph manpage for information.
• -no-gridfit — Disable rrdtool grid scale modification strategies. See rrdgraph manpage for information.

---

📏 Grid 📏

• -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.
• -alt-y-grid — Modify rrdtool default y-grid behavior. See rrdgraph manpage for information.
• -log — 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.
• -units=si — Turn off exponential notation for logarithmic graphs. See rrdgraph manpage for information.

---

🧚 Miscellaneous 🧚

• -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.
• -slope-mode — Modify rrdgraph slope-mode option. See rrdgraph manpage for information.
• -no-legend — Supress generation of the legend.
• -watermark string — Adds the given string as a watermark. See rrdgraph manpage for information.
• -norrdwmark — Disables the default rrdtool watermark from appearing on the graph.

---

🍓 EXAMPLES 🍓

Exhibit A. To graph the total load for the data in an argus-file argus.data at 10 second intervals:

ragraph bytes -M 10s -r argus.data -title "Total Load"

Exhibit B. To graph the rate (pkt/sec) on a destination port basis for the data from a specific probe in an argus-file argus.data at 1 minute intervals:

ragraph bytes dport -M 1m -r argus.data - srcid 192.168.0.10

---

👑 COPYRIGHT 👑

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

---

🫶 AUTHORS 🫶

Carter Bullard (carter@qosient.com).

---

💖 SEE ALSO 💖

rrdtool http://oss.oetiker.sh/rrdtool ragraph(5), ra(1), rarc(5), argus(8)

---

okay that's the whole page bestie, go make some graphs 💅✨

this was ragraph 5.0.3, dated 21 July 2023, from the RAGRAPH(1) page in the General Commands Manual. mwah, stan. 💖🌸