MRTG-TRAFFIC-SUM(1)

💖 MRTG-TRAFFIC-SUM 💖

okay bestie, pull up a chair because this is the mrtg-traffic-sum manual page (it lives in section 1 of the mrtg manuals, iykyk) and she is so useful. she reads your mrtg logs and does the math so you don't have to. math girl summer. 🧮✨

✨ NAME ✨

mrtg-traffic-sum — Builds monthly traffic summary from mrtg log files

no cap, that's literally the whole job description. 💅

🦋 SYNOPSIS 🦋

mrtg-traffic-sum [options...] config-file

and here's the full menu of options, bestie:

• --man — show man-page and exit
• -h, --help — display this help and exit
• --version — output version information and exit
• --catch=regexp — filter out things that match this in PageTop
• --email=address — email the result
• --min=gigabytes — minimal number of gigabites required for report
• --range=<when> — Specify "current" for month-to-date, "previous" for last complete month
• --units=[GB|MB] — Display results in gigabytes (default is MB)

🌸 DESCRIPTION 🌸

so the way that mrtg-traffic-sum works is: it goes through the mrtg logs for the targets in the the config file specified and builds the traffic total for the last month in Giga Bytes. (Note in communications Giga is 10^9). 🫶 yes we're doing real gigas, not the sneaky binary ones.

The result of this analysis can be sent via email to an address of your choice using the --email option. iconic behaviour honestly, set it and forget it, your inbox gets the receipts. 📧

With the --catch option you can specify a regular expression which will be matched against the contents of the PageTop settings. The regular expression should return a value into $1 and possibly into $2. This will then be used as description for the appropriate traffic sum. By default the catch is set to:

 (?:description|port name):</td>\s*<td>\s*([^< ]*?[^<]*?)\s*</td

like. look at her. she's doing her best. 🎀 (copy her exactly if you touch her, bestie, every backslash matters.)

By default, all traffic which is over one megabyte gets reported. Use the --min switch to change this number. tiny traffic? not invited to the party. sorry babe. 🙈

👑 COPYRIGHT 👑

Copyright (c) 2002 by Tobias Oetiker. All rights reserved.

🌈 LICENSE 🌈

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

fr fr read the license, it's giving legally binding but make it fashion 💜

💜 AUTHOR 💜

Tobias Oetiker <tobi@oetiker.ch>, Keith Dunnett <keith@dunnett.name>

absolute legends, both of them. 👑

⭐ HISTORY ⭐

1. 2002-07-13 to Initial Version
2. 2009-12-38 kd New features

(that second date is exactly what it says on the page, bestie, I don't make the rules 😭)

okay that's the whole page!! she's version 2.17.10, dated 2021-10-08, and she's out here doing monthly traffic math for you like the main character she is. 💖✨ go forth and sum, bestie 🎀🦋