MRTG - Revision history

Boiarino at 19:39, 20 February 2009

2009-02-20T19:39:41Z

← Older revision		Revision as of 15:39, 20 February 2009
Line 1:		Line 1:
	~~mortgage loan.~~
	~~MRTG MRTG logo~~
	~~Developed by Tobi Oetiker~~
	'''General information'''		'''General information'''

Boiarino at 19:39, 20 February 2009

2009-02-20T19:39:06Z

← Older revision		Revision as of 15:39, 20 February 2009
Line 1:		Line 1:
			mortgage loan.
			MRTG MRTG logo
			Developed by Tobi Oetiker
			'''General information'''

			The Multi Router Traffic Grapher, or just simply MRTG, is free software for monitoring and measuring the traffic load on network links. It allows the user to see traffic load on a network over time in graphical form. It was originally developed by Tobias Oetiker and Dave Rand to monitor router traffic, but has developed into a tool that can create graphs and statistics for almost anything.

			MRTG is written in Perl and can run on Windows, Linux, Unix, Mac OS and NetWare.

			MRTG is free software licensed under the terms of the GNU General Public License.

	'''How it works'''		'''How it works'''

Boiarino at 19:36, 20 February 2009

2009-02-20T19:36:55Z

← Older revision		Revision as of 15:36, 20 February 2009
Line 16:		Line 16:
	'''See also'''		'''See also'''

	* ~~RRDtool~~ - reimplementation of MRTG's graphing and logging features		* [[Rrdtool]] - reimplementation of MRTG's graphing and logging features
	* PRTG - Windows GUI implementation of MRTG's functionality (freeware available)		* PRTG - Windows GUI implementation of MRTG's functionality (freeware available)
	* Routers2 - Web front-end for MRTG/RRDtool combination		* Routers2 - Web front-end for MRTG/RRDtool combination

Boiarino at 19:36, 20 February 2009

2009-02-20T19:36:08Z

← Older revision		Revision as of 15:36, 20 February 2009
Line 1:		Line 1:
			'''How it works'''

	MRTG uses the Simple Network Management Protocol [[SNMP]] to send requests with two object identifiers (OIDs) to a device. The device, which must be SNMP-enabled, will have a management information base (MIB) to look up the OIDs specified. After collecting the information it will send back the raw data encapsulated in an SNMP protocol. MRTG records this data in a log on the client along with previously recorded data for the device. The software then creates an HTML document from the logs, containing a list of graphs detailing traffic for the selected device.		MRTG uses the Simple Network Management Protocol [[SNMP]] to send requests with two object identifiers (OIDs) to a device. The device, which must be SNMP-enabled, will have a management information base (MIB) to look up the OIDs specified. After collecting the information it will send back the raw data encapsulated in an SNMP protocol. MRTG records this data in a log on the client along with previously recorded data for the device. The software then creates an HTML document from the logs, containing a list of graphs detailing traffic for the selected device.

			'''Features'''

			* Measures two values (I for Input, O for Output) per target.
			* Gets its data via an SNMP agent, or through the output of a command line.
			* Typically collects data every five minutes (it can be configured to collect data less frequently).
			* Creates an HTML page per target that features four graphs (GIF or PNG images).
			* Results are plotted vs time into day, week, month and year graphs, with the I plotted as a full green area, and the O as a blue line.
			* Automatically scales the Y axis of the graphs to show the most detail.
			* Adds calculated Max, Average and Current values for both I and O to the target's HTML page.
			* Can also send warning emails if targets have values above a certain threshold.

			'''See also'''

			* RRDtool - reimplementation of MRTG's graphing and logging features
			* PRTG - Windows GUI implementation of MRTG's functionality (freeware available)
			* Routers2 - Web front-end for MRTG/RRDtool combination
			* Cacti - A similar tool using RRDtool.

Boiarino at 19:33, 20 February 2009

2009-02-20T19:33:43Z

← Older revision		Revision as of 15:33, 20 February 2009
Line 1:		Line 1:
			MRTG uses the Simple Network Management Protocol [[SNMP]] to send requests with two object identifiers (OIDs) to a device. The device, which must be SNMP-enabled, will have a management information base (MIB) to look up the OIDs specified. After collecting the information it will send back the raw data encapsulated in an SNMP protocol. MRTG records this data in a log on the client along with previously recorded data for the device. The software then creates an HTML document from the logs, containing a list of graphs detailing traffic for the selected device.



	MRTG is included in RHEL4; if want to install separately do following:		MRTG is included in RHEL4; if want to install separately do following:

Boiarino at 19:54, 18 November 2007

2007-11-18T19:54:38Z

← Older revision		Revision as of 15:54, 18 November 2007
Line 1:		Line 1:
	MRTG is included in RHEL4; if want to install separately do following:		MRTG is included in RHEL4; if want to install separately do following:

	~~create~~ user 'mrtg' with private group 'mrtg'		Create user 'mrtg' with private group 'mrtg'. On Linux, use GUI. If it reports problems in ''/etc/shadow'' file, use ''/usr/sbin/pwconv'' script.

			Now do following:
	mkdir /www/mrtg2.15.0		mkdir /www/mrtg2.15.0
	chown mrtg.mrtg /www/mrtg2.15.0		chown mrtg.mrtg /www/mrtg2.15.0

Boiarino at 18:39, 18 November 2007

2007-11-18T18:39:26Z

← Older revision		Revision as of 14:39, 18 November 2007
Line 10:		Line 10:
	make		make
	make install		make install

			NOTE: mrtg-2.15.0 was used to install on 'clonweb'', mrtg-2.15.2 - on ''clonmon''.

	Add MRTG-related part to apache config file /www/apache2.2.3/conf/httpd.conf:		Add MRTG-related part to apache config file /www/apache2.2.3/conf/httpd.conf:

Boiarino at 23:14, 4 January 2007

2007-01-04T23:14:22Z

@@ Line 56: / Line 56: @@
    cd /www/mrtg2.15.0/etc
    scp clasweb-bck:/etc/mrtg/"*" .
-Create configuration files using 'cfgmaker' (never worked for me):
+OR: create configuration files using 'cfgmaker' (never worked for me):
    #example
@@ Line 81: / Line 72: @@
    DOES NOT WORK YET ...
-Create configuration files manually (see examples):
+OR: create configuration files manually (examples from clasweb-bck were used):
    etc/mrtg.cfg - main config file, includes *.inc files
    etc/*.inc - hardware-specific config files
-MRTG will produce and update following files while running:
+Create 'web' directories:
+It maybe good idea to copy some old files htmls/*, images/* and logs/* from previously used MRTG (on clasweb-bck in our case).
+It will preserve history: 'logs/*.log' contains recent history, while images/*.png contains longer history
    cd htmls
@@ Line 134: / Line 104: @@
    /etc/init.d/mrtg start
-Cron job (???):
+Generate 'index.html' script in 'share' directory. It will produce file for all channels. It can be splited manually on desired number of smaller files (it maybe possible to generate separate file for every *.inc, but it wanted WorkDir which is defined in mrtg.cfg, and
    [root@clasweb-bck etc]# ll */mrtg

Boiarino at 23:03, 4 January 2007

2007-01-04T23:03:41Z

@@ Line 63: / Line 63: @@
    mkdir images
    mkdir logs
 Create desired index.html in /www/mrtg2.15.0/share, it will be used by browser if 'http://clonweb/mrtg/' URL typed; it was actually copied from clasweb-bck and adjusted:
@@ Line 91: / Line 141: @@
    [root@clasweb-bck etc]# more  cron.d/mrtg
    #0-59/5 * * * * root /usr/bin/mrtg /etc/mrtg/mrtg.cfg

Boiarino at 22:27, 4 January 2007

2007-01-04T22:27:49Z

← Older revision		Revision as of 18:27, 4 January 2007
Line 84:		Line 84:
	/etc/init.d/mrtg start		/etc/init.d/mrtg start

			Cron job (???):



	Cron job:

	[root@clasweb-bck etc]# ll */mrtg		[root@clasweb-bck etc]# ll */mrtg
Line 96:		Line 92:
	#0-59/5 * * * * root /usr/bin/mrtg /etc/mrtg/mrtg.cfg		#0-59/5 * * * * root /usr/bin/mrtg /etc/mrtg/mrtg.cfg

			Create configuration files using 'cfgmaker' (never worked for me):

	~~Configuration~~:

	#example		#example
Line 113:		Line 107:
	DOES NOT WORK YET ...		DOES NOT WORK YET ...

	~~My current understanding about~~ configuration:		Create configuration files manually (see examples):

	etc/mrtg.cfg - main config file, includes *.inc files		etc/mrtg.cfg - main config file, includes *.inc files
	etc/*.inc - hardware-specific config files		etc/*.inc - hardware-specific config files

			Generate 'index.html' script in 'share' directory:

			/www/mrtg2.15.0/bin/indexmaker /www/mrtg2.15.0/etc/mrtg.cfg --prefix=htmls --show=none --output=/www/mrtg2.15.0/share/index.html

	share/index.html - main hadn-made html file, includes references to secondary hand-made html files in share/htmls		share/index.html - main hadn-made html file, includes references to secondary hand-made html files in share/htmls
	share/htmls/*.html - hand-made and mrtg-generated html files		share/htmls/*.html - hand-made and mrtg-generated html files
Line 122:		Line 121:
	share/logs/.log and .old - mrtg-generated current files		share/logs/.log and .old - mrtg-generated current files

	~~There is a script to generate 'hand-made' *.html file:~~

	~~/www/mrtg2.15.0/bin/indexmaker /www/mrtg2.15.0/etc/mrtg.cfg -output=/www/mrtg2.15.0/share/htmls/MRTG.html~~

	It will produce MRTG.html file for all channels. It can be splited on desired number of smaller files.		It will produce MRTG.html file for all channels. It can be splited on desired number of smaller files.