Skip to content

roemer2201/devmon

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

=====================================================================
Devmon VERSION 0.21.06.06, fork at SF version 0.3.1-beta1 r256
======================================================================

THIS IS NOT AN OFFICIAL VERSION from the original developers:
- Look at SourceForge version for it !
- Previous modified devmon version in this repo were reported
  (in 2017) to be less stable than the SF one...
- Use it at your own risks !

SEE END OF FILE for detailled  STATUS and ROADMAP!

9 jun 2021, Bruno Manzoni
======================================================================

0.21.06.09 Changes
New features
- CPU revamp (Cisco, Huawei), mainly the "uptime" part
  - Reboot cause analysis with a auto disable timer 
  - Better Uptime value, calculation with (snmp and system oid)
- Threshold automatch acccept multiple value
   - We can have not multiple empty (automatch) threshold for an oid
   - Empty threshold of the current color is prefered  
Bug resolved
- MATH transform with constant (without other deps oids)
- TSWITCH calc
- Perl 5.28 compatibility
- Threshold calculation 
- Custom threshold in hosts.cfg should overide other
- BEST threshold can override herited error
And some more !!!
                                                                                           
======================================================================                                                                                           

  This program is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 2 of the License, or
  (at your option) any later version.  Please see the file named
  'COPYING' that was included with the distrubition for more details.

 What is Devmon ?
---------------------------------------

  Devmon is a Perl software that uses SNMP to monitor, graph and alert 
  on host information

 What are Devmon's prerequisites?
---------------------------------------

  In order for Devmon to do anything useful, you will need
  a machine capable of running the Perl interpreter, which
  is used to execute the Devmon code.  

  In addition, you will need a machine (either the same machine 
  running Devmon, or a different one) runing either the Hobbit/Xymon 
  or BigBrother monitoring program, which displays the messages
  that Devmon generates.  

  Finally, you will need your to have your Hobbit/Xymon or BigBrother 
  program set up to monitor at least  one host that Devmon has 
  a template for.   Only then will Devmon be able to poll a 
  remote host and display the results.  For more information on 
  Devmon's template system, please consult the TEMPLATES file
  located in the docs directory.

 How do I install Devmon?
---------------------------------------

  Detailed instructions are available in the docs/INSTALLATION
  file.  A single-node installation merely requires you to untar
  the Devmon tarball to a suitable location, modify the config
  file appropriately, and start the Devmon daemon.  

  A multi-node installation requires you to do all of the above
  on each node in the cluster, as well as set up a MySQL database
  to facilitate communication between nodes.

 What are Devmon templates?
--------------------------------------

  Devmon can monitor a virtually unlimited number of different 
  device types, by allowing a user to define a template for
  each test to be conducted on a particular device type.
  For instance, a 'cpu' test on a Cisco 2950 switch is its own 
  template, while a 'if_load' test on the same switch is an
  entirely different template. A must read: the docs/TEMPLATES file!
  
===========================================================================================================================================

Thanks for all the work done and also all patch/ideas submitted !
Special thanks to this fork version contributors
- W. Nelis
- Stef Coene
- Coec (Github name)

And all previous devmon admins and devs: 
- Henrik Stoerner
- Steve Aiello
- Dan Vande More
- Craig Boyce
- Buchan Milne

This is a work in progress, changes can occur without notice ....

FEEDBACK ALWAYS APPRECIATED: use the github ISSUES to communicate even it is not a bug !

===========================================================================================================================================

Major changes after fork
. All patches from Sourceforge are integrated in this realease (some with adaptation)
- Improved User-Friendliness 
  - Add the 'Blue' color for test that are 'Disabled' and for fun !
  - Error reporting

- Error propagation as "core" concept  

- Multiple error messages and threshold for each oid color !
 
- New transforms:
  - COLTRE     : To collect data when there are "parent" oid values   
  - SORT       : To sort in an increasing order (num or txt, default = txt)
                 oid values. The result (the new oid values) are 
                 int indexes corresponding to the position of the source
                 oid values in the sort.
                 The results are a int between 1 and n 
                 (n is the number of element in the branch oid) 
                 It can be used to 'reindex' an oid if use in conjonction with
                 the CHAIN transform. (similar to the INDEX transform)
  - SET        : See the docs/TEMPLATE for explanation (Thanks to W. Nelis)
  - STATISTIC  : See the docs/TEMPLATE for explanation (Thanks to W. Nelis)

Template Update and Maintained:
- Cisco
  - Cisco r1800, r1900, r2800, r2900, sw2940, sw2950, sw2960, sw3750
    sw3850, sw3650, swIE, rISR, asa
- Wmware
  - esxi6
- Huawei

===========================================================================================================================================

PATCH                                                                  Sourceforge Status   this release Status          
38     Template for cisco nexus 3500                                           open            fixed                  07.06.2018 07.06.2018
37     Allow for OIDS with flag in message part of a threshold definition      open            fixed                  01.04.2017 01.04.2017
36     Enhance REGSUB transformation capabilities                              open            fixed(alternate)       01.04.2017 01.04.2017
35     Replacement for function render_msg in module dm_tests.pm               open            wont/partial fix(bugs) 17.03.2017 24.03.2017
34     Replace an OID errors flag by an empty string incase of a green colour  open            fixed                  26.02.2017 04.03.2017
33     Patch for the (T)SWITCH transform to be able to assign empty string     open            fixed                  24.02.2017 24.02.2017
32     Formatting of result of MATH transform                                  open            reported in todo       06.02.2017 06.02.2017
31     Fix typo in function name                                               open            fixed                  16.01.2017 16.01.2017
30     Support for negative numbers in (T)SWITCH                               open            reported in todo       13.01.2015 13.01.2015
29     Document default in SWITCH transform                                    open            fixed                  14.11.2014 14.11.2014
28     Allow function time in a MATH transform                                 open            wont(use eval trans)   22.10.2014 22.10.2014
27     Add TABLE:sort option                                                   open            fixed(alternate)       26.08.2014 26.08.2014
26     Add transform SET                                                       open            fixed(incompleted)     18.08.2014 18.08.2014
25     Fix bug #13                                                             open            fixed(alternate)       25.06.2014 25.06.2014
24     Align columns of a TABLE to the right side                              open            reported in todo       23.10.2013 23.10.2013
23     Consistent notation OIDs                                                open            fixed/alternate)       04.01.2013 04.01.2013
22     Templates for Cisco 7609 and ITP                                        open            fixed                  29.06.2012 29.06.2012
21     Extend capabilites of transform REGSUB                                  open            fixed(alternate)       10.01.2012 10.01.2012
20     Add transform STATISTIC                                                 open            fixed                  06.01.2012 21.12.2012
17     Fix syntax check of the DELTA transform                                 open            fixed(alternate)       02.01.2012 02.01.2012
16     Change output of SPEED transform                                        open            fixed                  02.01.2012 02.01.2012
15     Improve syntax check DELTA transform                                    open            fixed(alternate)       02.01.2012 02.01.2012
14     Layout of devmon statistics in Xymon, test dm                           open            fixed                  02.01.2012 02.01.2012
13     Template for OpenBSD using Net-SNMP                                     open            fixed                  09.08.2011 09.08.2011
12     snmpEngineTime vs sysUpTimeSecs over 497 days                           open            fixed(alternate)       07.03.2011 07.03.2011
11     Brocade SAN switch template                                             open            wont(see sf comment)   07.08.2010 07.08.2010
10     SUBSTR negative                                                         open-remind     wont fix(disp prob)    04.03.2010 22.01.2011
9      New templates for cisco and hp                                          open            fixed(asa+ps) wont:hp  16.11.2009 16.11.2009
2      Cisco Template for Class Based Weighted Fair Qeueing (QoS)              open            fixed                  06.10.2008 06.10.2008
              
FEATURE REQUEST                         
10     New templates for other devices                                         open            wont/part. fixed(1/3)  29.09.2016 29.09.2016
9      Allow for empty repeater-type OIDs                                      open            reported in todo       05.06.2012 05.06.2012
8      exceptions based on other oid values                                    open            reported in todo       19.04.2012 19.04.2012
7      Share templates for similar devices                                     open            reported in todo       22.01.2010 22.01.2010
3      Use OID value in threshold comparison                                   open            reported in todo       31.12.2008 04.04.2011
2      SNMP V3 support                                                         open            reported in todo       17.10.2008 17.10.2008
                         
                         
BUG                         
16     Some interface of cisco Router do not appear                            open            nothing to do          20.09.2015 15.03.2017
15     MATH transform fails if with both repeaters and non-repeaters           open            fixed                  22.10.2014 22.10.2014
14     Cisco-6509 wrong oids for serial                                        open-later      wont(cannot test)      21.12.2011 03.01.2013
13     Thresholds remain undefined                                             open            fixed                  30.08.2011 30.08.2011
12     New templates for Cisco 3750 switch                                     open            fixed(alternate)       01.02.2011 01.02.2011
10     Many templates share "sysdesc" in specs                                 open            wont                   22.01.2010 22.01.2010
9      Template exceptions sorted misleadingly                                 open-remind     reported in todo       31.12.2009 22.01.2011
8      devmon goes purple                                                      open            fixed(alternate)       13.11.2009 13.11.2009
6      cisco-2811 has wrong ifName oids                                        open-later      fixed                  19.02.2009 05.02.2010
5      Wrong threshold calculation for Cisco templates                         open            fixed                  03.02.2009 03.02.2009

===========================================================================================================================================
                         
TODO                         
Priority 1: Sourceforge open and bugs
       Memory leaks
         On linux (WIP) 
         On BSD (major)
         One was in xymon-rrd, but should be fixed now? (version?) 
         Results: Minimized by fixing all errors: run devmon in foreground and show logs
       SNMPv3: After triing to use the work from StefCoene, it seem more complicated that what I tought...
       Document Transform Coltre, Sort


Ideas
       Warn if autovivification (creates the hash if it do not exists, but it should not) and check if it does already make problem 
       Make Table compatible with LEAF 
       Share templates for similar devices: Lot of work!!!
       Support for negative numbers in (T)SWITCH: Parse mathematical expression simply....: Need more work
       Format display (SUBSTR negative, Align columns of a TABLE to the right side,  Formatting of result of MATH transform): Problems Alignement and Padding
       Exceptions based on other oid values: now only PriOi: make it work for alternate oid
       Template exceptions sorted misleadingly: need documentation clarification
       Use OID value in threshold comparison: Nice to have (workaround is to do that is transform)

FEATURE REQUEST
       Better discovery (SF bug 10)
       Multiple graph in a test
       Add better timer calculation (HiRes)

HELP NEEDED
       Template not listed above cannot be test: please help to updated: take a look at template liste above that are maintained! 
       Template exceptions sorted misleadingly: need documentation clarification: I dont used it: I need concrate case!)

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Perl 97.8%
  • Shell 1.4%
  • C 0.8%