Keywords: Big Sister, Bigsister, Network Monitor, Network Monitoring, Perl, GPL, Big Brother, manual, SNMP

mrtg
Prev | Healthcheck Command Reference | Next

## Name

mrtg — receive and visualize mrtg data

## Synopsis

[ `foo.bar.com prefix=10.1.1.253/10.1.1.253.1 column=mrtg maxlev=10485760 bits=1` ]`mrtg`

## Description

The MRTG monitor will retrieve data from a MRTG-style .log file.

It will check the last value of the data being monitored against given thresholds and act accordingly. In the example above, the log file signifies a router interface. The log file is found in mrtglog directory. (see below)

### Available arguments:

`column` the column to which status messages are posted default: mrtg (i.e post to foo.bar.com.mrtg)

`prefix` the directory/file prefix of the logfile no default, required.

`bits` determines if we are graphings bits/sec or bytes/sec (used w/ network interfaces) default: bytes

`maxlev` the maximum value the data may take on Only used to calculate the percentage reported and to calculate yellow/red levels. default: 10mb (bits=1), 1.25mB (bits=0)

`warnlev` These two options determine at which point the `paniclev` monitor should report yellow and red statuses. (0 -> warnlev is green, warnlev-> paniclev is yellow,>paniclev is red) You may specify a value to compare to the counter directly or a percentage of the maximum value. default: warnlev= 50%, paniclev= 75%

`units` This determines the units of the value. Asthetic only. default: b/s (bits=1), Bytes/s (bits=0)

`intext` These are the labels for the data being graphed.

`outtext` For network interfaces, In and Out are the default and should be sufficient.

### Resources variables:

`mrtglog` the directory with mrtg logs in it

`mrtgweb` the path for the url to link to the graph

`mrtgloghtml` 1 to post html status, 0 to do text only So, it reads the file `$mrtglog/$prefix.log`, posts the status as a line of text, and optionally links to and to show the graph and get more info.

Prev | Up | Next
ntp | Home | atmport or etherport