MRTG-FAQ(1)

πŸ“¦
version 2.17.10 Β· 2 versions
  • 2.17.10 Β· alpine 3.22, alpine 3.23, alpine 3.24, centos-stream 10, debian bookworm, debian trixie, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 2.17.7 Β· centos-stream 9
, in alpine 3.22, alpine 3.23, alpine 3.24, centos-stream 10, debian bookworm, debian trixie, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

🌸 NAME 🌸

mrtg-faq β€” literally the "how do I get help when MRTG is being MRTG" page πŸ’–


✨ SYNOPSIS ✨

okay so bestie, real talk: MRTG raises a lot of questions. Like, a lot a lot. And there are a bunch of resources besides the documentation where you can go find help for mrtg. This page is your little map πŸ—ΊοΈβœ¨


πŸŽ€ FAQ πŸŽ€

In the sections below you'll find some extra Frequently Asked Questions, with Answers. yes we're doing this, sit down, grab a snack πŸ“

πŸ’… Why is there no "@#$%" (my native language) version of MRTG?

Because nobody has contributed a @#$%.pmd file yet, bestie. That's it, that's the whole reason 😭

So here's the move: go into the mrtg-2.17.10/translate directory and create your own translation file. When you're happy with it, send it over so it can be included with the next mrtg release. You'd be the main character of localization, fr fr πŸ‘‘

πŸ¦‹ I need a script to make mrtg work with my xyz device.

ngl, probably this has already been done. Check the stuff in the mrtg-2.17.10/contrib directory πŸ’– There's a file called 00INDEX in there that tells you what you can find in it. go read it, it's giving treasure map πŸ—ΊοΈ

🌈 How does this SNMP thing work

There are many resources on the net that explain SNMP. Take a look at this article from the Linux Journal by David Guerrero:

http://www.david-guerrero.com/papers/snmp/

And at this rather long document from CISCO:

http://www.cisco.com/univercd/cc/td/doc/cisintwk/ito_doc/snmp.htm

yes the second one is long. no I will not apologize. it's iconic for a reason πŸ“šβœ¨

🧚 The images created by MRTG look very strange.

Bestie, just remove the *-{week,day,month,year}.png files and start MRTG again. periodt πŸ’…

And heads up: if you're using MRTG for the first time, you might have to do this twice. This will also help when you introduce new routers into the cfg file πŸ”₯

πŸ’œ What is my Community Name?

Ask the person in charge of your Router 🫢 or just try 'public', because that's the default Community Name. iykyk ✨

😭 My graphs show a flat line during an outage. Why ?

Okay so the short answer is: when an SNMP query goes out and a response doesn't come back, MRTG has to assume something to put in the graph, and by default it assumes that the last answer we got back is probably closer to the truth than zero. This assumption is not perfect (as you have noticed, bestie, we see you). It's a trade-off that happens to fail during a total outage πŸ’€

If this is an unacceptable trade-off, use the unknaszero option.

You may want to know what you're trading off, so in the spirit of trade-offs, here's the long answer πŸ‘‡


The problem is that MRTG doesn't know *why* the data didn't come back, all it knows is that it didn't come back. It has to do something, and it assumes it's a stray lost packet rather than an outage.

Why don't we always assume the circuit is down and use zero, which will (we think) be more nearly right? Well, it turns out that you may be taking advantage of MRTG's "assume last" behaviour without being aware of it πŸ‘€

MRTG uses SNMP (Simple Network Management Protocol) to collect data, and SNMP uses UDP (User Datagram Protocol) to ship packets around. UDP is connectionless (not guaranteed) unlike TCP where packets are tracked and acknowledged and, if needed, retransmitted. UDP just throws packets at the network and hopes they arrive. Sometimes they don't. πŸ™ˆ

One likely cause of lost SNMP data is congestion; another is busy routers. Other possibilities include transient telecommunications problems, router buffer overflows (which may or may not be congestion-related), "dirty lines" (links with high error rates), and acts of God. These things happen all the time; we just don't notice because many interactive services are TCP-based and the lost packets get retransmitted automatically.

In the above cases where some SNMP packets are lost but traffic is flowing, assuming zero is the wrong thing to do β€” you end up with a graph that looks like it's missing teeth whenever the link fills up 🦷😭 MRTG interpolates the lost data to produce a smoother graph which is more accurate in cases of intermittent packet loss. But with V2.8.4 and above, you can use the "unknaszero" option to produce whichever graph is best under the conditions typical for your network. slay 🌟


πŸ‘‘ AUTHOR πŸ‘‘

Tobias Oetiker <tobi@oetiker.ch> β€” the icon, the legend, the moment πŸ’–


okay bestie that's the whole page, you ate that πŸ’…βœ¨

this was mrtg version 2.17.10, dated 2022-01-19, and yes this is MRTG-FAQ(1) β€” go forth and graph responsibly πŸ¦‹πŸŒΈ