"Fossies" - the Fresh Open Source Software Archive

Member "gkrellm_snmp-1.1/README" (3 Jan 2009, 6589 Bytes) of package /linux/privat/gkrellm_snmp-1.1.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 GKrellM_SNMP README
    2 ===================
    3 
    4 - gkrellm_snmp: GKrellM SNMP monitor Plugin
    5 - Author:    Christian W. Zuckschwerdt <zany@triq.net>
    6 - Homepage:  http://triq.net/gkrellm/
    7 
    8 
    9 **A plugin for GKrellM, that let's you monitor SNMP vars.**
   10 
   11 
   12 Prerequisites:
   13 --------------
   14 You need a SNMP library to run this plugin.
   15 You also need the SNMP header (include) files for building (as well as
   16 GTK-2.0 and GKrellM headers).
   17 Tested with UCD-SNMP and Net-SNMP.
   18 (If you want to link to the -old- UCD-SNMP try "make ucdsnmp").
   19 
   20 This means for e.g. Debian/Ubuntu you need to install libsnmp-dev
   21 (and libgtk2.0-dev / gkrellm as well).
   22 
   23 Compiling:
   24 ----------
   25 
   26 * For linux: just run the normal 'make'.
   27 * For freebsd: run 'make freebsd'.
   28 * For OS X: run 'make osx'.
   29 
   30 
   31 Installing:
   32 -----------
   33 Running 'make install-user' will place the plugin in your current home
   34 directory under $HOME/.gkrellm2/plugins.
   35 Running 'make install' as superuser will place the plugin under
   36 /usr/lib/gkrellm2/plugins. You can also manually place the resulting
   37 gkrellm_snmp.so under $HOME/.gkrellm2/plugins. After restarting gkrellm, you
   38 should be able to enable it in the gkrellm plugins configuration menu.
   39 
   40 
   41 Troubleshooting:
   42 ----------------
   43 If you have trouble compiling the plugin. Make sure you have gtk 2 and 
   44 gkrellm >= 2.0.0 and you've installed the gkrellm header files in
   45 /usr/include/gkrellm or /usr/local/include/gkrellm. If you have placed the
   46 header files in some other dir, edit GKRELLM_INCLUDE in the Makefile
   47 
   48  
   49 Bugs:
   50 -----
   51 No GKrellm 1.x support anymore. Anyone needing that?
   52 I do consider this version stable.
   53 Please mail any problems/bugs to me...
   54 
   55 
   56 Some examples:
   57 --------------
   58 
   59 (1)
   60 
   61 The ambiente temperature sensor for some net-snmp server
   62 
   63  Peer: 192.168.1.2  Port: 161  Community: public 
   64  OID: extOutput.1 (= .1.3.6.1.4.1.2021.8.1.101.1 from UCD-SNMP-MIB)
   65 
   66 If you have the needed MIB you can use the symbolic OID form. The name
   67 is unambiguous but only available if you have the MIB installed.
   68 
   69 (2)
   70 
   71 Server CPU load using a string ranging from 0.00 to 1.00
   72 (e.g. the load factor for the first cpu on that server )
   73 
   74  Peer: 192.168.1.3  Port: 161  Community: public
   75  OID: laLoad.1 (= .1.3.6.1.4.1.2021.10.1.3.1 from UCD-SNMP-MIB)
   76 
   77 (3)
   78 
   79 Server CPU load using integer variable ranging from 0 to 100
   80 (e.g. the percentile load for the first cpu on that server)
   81 
   82  Peer: 192.168.1.4  Port: 161  Community: public
   83  OID: laLoadInt.1 (= .1.3.6.1.4.1.2021.10.1.5.1 from UCD-SNMP-MIB)
   84 
   85 (4)
   86 
   87 Most devices don't support gauges for interface load. They just count
   88 octets. You can get around that limitation with the delta monitoring
   89 feature. (eg. monitor packet counters instead of gauges)
   90 
   91  Peer: 192.168.1.5  Port: 161  Community: public
   92  OID: ifInOctets.1 (= .1.3.6.1.2.1.2.2.1.10.1 from RFC1213-MIB)
   93  or OID: ifOutOctets.1 (= .1.3.6.1.2.1.2.2.1.16.1 from RFC1213-MIB)
   94 Be sure to check the button "Delta".
   95 
   96 You can convert the symbolic OID to numbers and vice-versa with
   97 snmptranslate:
   98 
   99 $ snmptranslate -m all -IR laLoadInt.1
  100 .1.3.6.1.4.1.2021.10.1.5.1
  101 
  102 $ snmptranslate -m all -OnS .1.3.6.1.4.1.2021.10.1.5.1
  103 UCD-SNMP-MIB::laLoadInt.1
  104 
  105 
  106 More interessting OIDs:
  107 -----------------------
  108 - Chasis inlet temperature (tested on cisco7204VXR)
  109   CISCO-SMI::ciscoMgmt.13.1.3.1.3.1
  110  .1.3.6.1.4.1.9.9.13.1.3.1.3.1
  111 
  112 - Dominik Winter found the following OID's in Cisco's Vendor-MIB
  113   (works for his cisco-2514 w/ IOS Version 11.2(5))
  114 
  115   locIfInBitsSec.n  inbound traffic measured in bit/s
  116   .1.3.6.1.4.1.9.2.2.1.1.6.<interface_nr>
  117 
  118   locIfOutBitsSec.n  outbound traffic measured in bit/s
  119   .1.3.6.1.4.1.9.2.2.1.1.8.<interface_nr>
  120 
  121   locIfInPktsSec.n  inbound traffic measured in pkts/s
  122   .1.3.6.1.4.1.9.2.2.1.1.7.<interface_nr>
  123 
  124   locIfOutPktsSec.n  outbound traffic measured in pkts/s
  125   .1.3.6.1.4.1.9.2.2.1.1.9.<interface_nr>
  126 
  127   avgBusy1  CPU-load sampled over 1 minute
  128   .1.3.6.1.4.1.9.2.1.57
  129 
  130   avgBusy5 CPU-load sampled over 5 minutes
  131   .1.3.6.1.4.1.9.2.1.58
  132 
  133 Where <interface> means the number of the interface you wish to monitor.
  134 Be aware that software routers are likely to have this setup
  135  ifDescr.1 = lo0 ; ifDescr.2 = eth0 ;ifDescr.3 = eth1
  136 So if you mean eth0 you need to write "2"!
  137 
  138 Be always sure to prepend the leading dot "." it's much like the
  139 root "/" in path names.
  140 Mostly there is a trailing ".0" do not omit it -- it selects the first
  141 row (E.g. there could be more that just one value).
  142 You can specify the cpu or interface appending a .1 or .2 and so on.
  143 
  144 
  145 Call for features!
  146 ------------------
  147 
  148 Do you want/need
  149  monitor multiple oid's on the same server? (snmp bulk get)
  150  choose between charts and krells?
  151  SNMP v1, v2, v3 support?
  152  SNMP privacy options?
  153 
  154  Enter peer, port, community and oid in separate fields
  155  or as snmp://community@peer:port/oid ?
  156 
  157  other SNMP lib instead of UCD-SNMPD / better NETNMP support?
  158  GKrellM pre 1.x or 0.x support/compatibility?
  159 
  160  instance mapping?
  161 
  162  Diffential monitors (eg. monitor packet counters instead of gauges)?
  163 
  164 
  165 Please help:
  166 ------------
  167 
  168 Can you give some usage examples?
  169 
  170 
  171 Tested on:
  172 ----------
  173 - FreeBSD  4.0 Release   w/ ucd-snmp-4.0.1   libcrypt not needed
  174 - SuSE Linux 6.4   w/ ucd-snmp-4.0.1
  175 - SuSE Linux 6.4   w/ ucd-snmp-4.1.1
  176 - SuSE Linux 8.2   w/ ucd-snmp-4.2.6
  177 - RedHad Linux 6.1
  178 - Mac OS-X
  179 - Gentoo Linux
  180 - Debian / Ubuntu
  181 
  182 
  183 Thanks to:
  184 ----------
  185 
  186  Bill Wilson <billw@gkrellm.net>
  187  (valuable feedback and last but not least making GKrellM!)
  188 
  189  Eike Bernhardt <teefax@pmnet.uni-oldenburg.de>
  190  (Makefile improvements, Testing on FreeBSD)
  191 
  192  Shamada Diundra <shamada@pmnet.uni-oldenburg.de>
  193  (Testing on RedHad Linux)
  194 
  195  Stefan Raab <stefan.raab@nextel.com>
  196  (Fixed ASN.1 return type strangeness with cisco7204VXR router    
  197   bug report and cisco7204VXR access)
  198 
  199  Mikael Blomqvist <micke@altcom.se>
  200  (GKrellM 1.0.4 changes)
  201 
  202  Sami Haahtinen <ressu@debian.org>
  203  (requested delta monitoring)
  204 
  205  Peter Herz <peterh@connectnet.com>
  206  (suggestions on divisor/scaling)
  207 
  208  Ben Winslow <rain@bluecherry.net>
  209  (fixed a bug in clist handling)
  210  
  211  Lasse Aagren <lasse@aagren.org>
  212  (reported config file reading error)
  213 
  214  Eric Lindvall <eric@5stops.com>
  215  (fixed a bug concerning the error state)
  216 
  217  Quentin Garnier <cube@netbsd.org>
  218  (transport:host patch)
  219 
  220  Juan Manuel Garcia Molina <juanma@debian.org>
  221  Elmar Hoffmann <elho@elho.net>
  222  (reported that the chart config isn't saved/restored)
  223 
  224  Mark Duling <mark.duling@biola.edu>
  225  (suggested Makefile improvements for OS-X)
  226 
  227 
  228 AUTHOR AND WEBPAGE:
  229 -------------------
  230 
  231 - Christian W. Zuckschwerdt  <zany@triq.net>
  232 - GKrellM SNMP can be found at http://triq.net/gkrellm/
  233 - and also at GKrellM homepage http://gkrellm.net/
  234