1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
|
// IOG v1.03 - Input/Output Grapher - README
//
// Official Homepage: http://www.dynw.com/iog/
// Comments, bug reports to: iog@dynw.com
//
// Copyright (c) 2000-2003 James Dogopoulos <jd@dynw.com>
//
// Contributors:
// Simon Leinen <simon@switch.ch> - SNMPlib
//
Files:
Artistic - Artistic License *READ*
*.gif - IOG image files.
iog - IOG execution file.
iog.cfg - IOG Configuration file.
README - THIS FILE
BER.pm - Module by Simon Leinen <simon@switch.ch>
SNMP_Session.pm - Module by Simon Leinen <simon@switch.ch>
howto-iog.html - How-to by Sean Kelly <sean@inabiaf.com>
http://www.inabiaf.com/howto-iog/
index.php - Index script by Preston Carter <preston@ashenet.net>
About:
IOG is a network I/O byte grapher made to graph cumulative KB/MB/GB
totals for hours/days and months. It is intended to be simple, fast
(support thousands of hosts) and integrate well with MRTG. Data for
each host is updated hourly and HTML graphs are created. It uses a
data consolidation algorithm which allows for a small, non-growing
database file for each host. No external graphing libs or
executables are required.
IOG has been used in several production ISP environments,
including at the authors company, Dynamic Internet (dyni.net).
MRTG: http://ee-staff.ethz.ch/~oetiker/webtools/mrtg/mrtg.html
Comments:
64-bit SNMPv2c counters can now be used, use ifHCInOctets.# and
ifHCOutOctets.# in iog.cfg.
NT support has been added (tested under win2k), to enable full NT
support pass the command line argument "NT" to iog.
ex.) "perl iog NT"
You will need to add entries to "at" to make it run once per hour.
Thorough performance testing has not been done, but IOG should
be able to handle >1000 hosts/ports adequately. If you are running
on a semi-large network with at least 200 ports, please report your
results to iog@dynw.com.
*IMPORTANT*: You must select the proper sysUpTime value for your
device otherwise problems will arrive when these devices reboot.
Installation:
Required...
* WindowsNT/2000/XP with Perl/ActivePerl or your favorite UNIX OS
with Perl.
* A web browser (if you intend to let people view these pages through the
world wide web).
* A switch/router/device with an SNMPd/server configured.
1.) Untar/gz into your desired location. copy all .gif files to any
directory that will contain HTML (path in .cfg).
2.) Edit "iog.cfg" and follow the examples to set-up your hosts.
3.) Add a crontab to run "iog" EVERY HOUR (NOT every 5 minutes).
0 * * * * /path/to/iog
..or an "at" entry on NT.
4.) Decide how you want your users to view the stats. Perhaps
you want to add a type of authentication to view the graphs (.htaccess)?
5.) Watch it run and report bugs and performance info to iog@dynw.com.
Try to include detailed info including OS type, Perl version etc.
Upgrading:
From 1.0rcX - When upgrading, the first hour might be in-accurate due to a
minor change in db storage code.
From v0.99 - Make a copy of your iog.cfg and copy over all the files in this
directory.
From v0.98 or earlier - The format of the iog.cfg file has changed,
please see iog.cfg!
Donations:
No need for donations, but if you feel like doing something generous, send
some business to the author's company at www.dyni.net or you can donate
to the creator of SNMPlib or MRTG, they also produce great free software.
Changes:
v1.03 * Fixed bug which causes router/switch reboots to potentially
cause large negative values for that particular hour.
v1.02 * Added newer SNMP module that fixes compatibility with
some switches. Included how-to by Sean Kelly.
v1.01 * Fixed small "NE" bug by changing to lower-case.
v1.00 * Previous months and days are now saved and linked to
provide a more historical view of usage.
* Added 64-bit SNMPv2c counter support, backwards
compatible with SNMPv1.
* Added easier way to change KB/MB/GB size to increase
accuracy.
v0.99 * Added uptime polling to detect hosts that have
reset and adjust counters accordingly.
(NOTE: Config file format has changed.)
* Fixed bug that caused iog to die when a hostname
could not be resolved.
* Fixed reporting bug for hosts that are unreachable.
v0.98 * Fixed bug causing January to not graph properly.
* Changed "This Year" text to "Previous Months".
v0.97 * Fixed interface counter wrap bug, previous fix was
not complete.
v0.96 * Fixed problem with in-accurate reporting when an
interface counter wraps (every 4GB).
File name is now displayed on front of HTML.
v0.95 * Failed SNMPGets no longer reset counter to zero.
v0.9 * 0KB cells are no longer displayed.
* Problem with top navigation during hour 1:00 has been
corrected.
* "months" graph now displays GB total for In+Out.
v0.8 * Fixed bug in monthly graph creation, totals were
not being calculated properly.
* Minor changes in MB/GB display.
v0.7 * Preliminary NT support added.
* MB(KB) now scales to GB(MB) when >1000mb to
better display stats for busy hosts/ports.
v0.6 * Fixed 0kb bars under Netscape.
* Now detects when a hosts octet counters have reset to
prevent negative totals from being displayed.
* Navbar now only displays reports which are available.
* HTML is now generated at first run, to avoid confusion.
* Improved documentation.
v0.5 * First public release. (10/12/2000)
v0.4 *
v0.1 - v0.3 * Internal development releases.
|
