A Plug-in for zabbix to support building snmp templates from mib files.
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 11 commits ahead of giapnguyen:master.
Permalink
Failed to load latest commit information.
snmp_builder Added some cisco-files. Dec 25, 2017
README Update README Nov 20, 2017
snmp_builder.php Color scheme fixup - colors should be taken from css. Jun 13, 2018

README

General

I write the tool because I'm tired in create SNMP items for zabbix. To create a useful zabbix's template for SNMP devices, I used to open a MIB browser to get correct OID then fill the zabbix's item forms. It'm so boring when create a long list of items :-( . There is a first attempt of work out this problem, zload_snmpwalk http://zabbix.com/wiki/howto/monitor/snmp/zload_snmpwalk. But I rather a GUI tool. So why just make one?

SNMP builder is a add-in for Zabbix. It provide browse MIB for values and informations, automatically convert into Zabbix items and insert them into a template.

I code it with zabbix 1.8 so it not work on other version (I will port into prior version later)
Download

Version number of snmpbuilder with same with zabbix version for that it works.

SnmpBuilder 3.2

WARNING! 
This version is ported to zabbix 3.2 and IS NOT COMPATIBLE with zabbix 1.x/2.x. I wasn't tested it on zabbix 3.0, though. Mikhail Vasilyev.

Change log:

    * Ported to zabbix 3.2
    * Fix undefined index warnings.
    * Include danrog's fix for non-numeric indexes.
    * From 1.8.1, zabbix not accept specified chars in key name. So I must replace them with underscore.

Features

    * MIB Browser: you can select default MIB files or your own device MIBs to get OID tree. Click on the tree to retrieve value and information about a OID. Click to select the OID as Zabbix's item.
    * OID Table support: it assume that a OID whose name's end with string 'Table' is a OID Table. OID Table will retrieve with all it's indexes. Click on the cell to select the index as Zabbix's item. If my above assumption is wrong, you can use the checkbox .view as table. to switch between table and normal view.
    * Column selection: On OID Table, click on a header will select a whole column as Zabbix's items. It's useful if you create SNMP template for a 48 ports switch 8-).
    * Auto convert: I implement a simple convert from SNMP Type to Zabbix's item.

Installation

I try my best to not patch Zabbix's code, but still did a little to integrate the tool into Zabbix.

* Unzip snmp_builder.zip into zabbix's web root. There is a snmp_builder.php and 3 js files under sump_builder sub-dir.

* Open snmp_builder.php, edit MIBS_ALL_PATH for your own SNMP MIB's directories.

define('MIBS_ALL_PATH', '/home/zabbix/public_html/snmp_builder/mibs:/usr/share/snmp/mibs');

* Open include/menu.inc.php.

Find function zbx_construct_menu and add the following "page" in "config" section of $zbx_menu structure:
(as for the moment of this writing, it's about line 222):

                                [
                                        'url' => 'snmp_builder.php',
                                        'label' => 'SNMP Builder'
                                ],

So the code would look like this:

                                [
                                        'url' => 'hosts.php',
                                        'label' => _('Hosts'),
                                        'sub_pages' => [
                                                'items.php',
                                                'triggers.php',
                                                'graphs.php',
                                                'applications.php',
                                                'tr_logform.php',
                                                'tr_testexpr.php',
                                                'popup_trexpr.php',
                                                'host_discovery.php',
                                                'disc_prototypes.php',
                                                'trigger_prototypes.php',
                                                'host_prototypes.php',
                                                'httpconf.php',
                                                'popup_httpstep.php'
                                        ]
                                ],
                                [
                                        'url' => 'snmp_builder.php',
                                        'label' => 'SNMP Builder'
                                ],
                                [
                                        'url' => 'maintenance.php',
                                        'label' => _('Maintenance')
                                ],

(you actually can choose, where to put this item in menu of zabbix. My decision is to put it into "Configuration" menu 
between "Hosts" and "Maintainance" entries )



* Open jsLoader.php. Add some values to $availableJScripts to make lines around line 51 look array like this:

$availableJScripts = [
        // snmp_builder
        '../snmp_builder/Tree.js' => '',
        '../snmp_builder/snmp_builder.js' => '',
        '../snmp_builder/DynTable.js' => '',
        // /snmp_builder

It for integrate snmp_builder.php as a menu item under Administration tab and between Locales and Install menu. In fact, you can add it in any place.

    * Open Zabbix, select Administation tab, you should see SNMP Builder in menu.

Todos

    * Search OID: Sometimes I'm tired to dig into OID tree to find a OID. Why don't search it?
    * Edit item lists: Auto convert not work every cases. Why don't edit item's params (unit, delta, interval) before submit to Zabbix?
    * Detect default mib directory (edit MIB_ALL_PATH no more)