someorg/mib2zabbix
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
mib2zabbix/README.md
Ryan Armstrong 6d24aad64b Initial commit
2016-06-01 15:33:08 +08:00

2.2 KiB
Raw Blame History

mib2zabbix

This Perl script will generate a Zabbix Template in XML format for an OID tree in an SNMP MIB file.

Usage

mib2zabbix.pl [ -l | -t ] -o <OID> [OPTIONS]...

Export loaded SNMP MIB OIDs to Zabbix Template XML

    --export-maps           export value maps directly to Zabbix database

    -t, --template          generate a Zabbix template
    -f, --filename=PATH     output filename (default: stdout)

    -N, --name=STRING       template name (default: OID label)
    -G, --group=STRING      template group (default: 'Templates')
    -e, --enable-items      enable template items (default: disabled)
                            * enable with caution *

    -o, --oid=STRING        OID tree root to export

    -v, --snmpver=1|2|3     SNMP version (default: 1)
    -p, --port=PORT         SNMP UDP port number (default: 161)

SNMP Version 1 or 2c specific

    -c, --community=STRING  SNMP community string (default: 'public')

SNMP Version 3 specific

    -L, --level=LEVEL           security level (noAuthNoPriv|authNoPriv|authPriv)
    -n, --context=CONTEXT       context name
    -u, --username=USERNAME     security name
    -a, --auth=PROTOCOL         authentication protocol (MD5|SHA)
    -A, --authpass=PASSPHRASE   authentication protocol passphrase
    -x, --privacy=PROTOCOL      privacy protocol (DES|AES)
    -X, --privpass=PASSPHRASE   privacy passphrase

    --check-delay=SECONDS   check interval in seconds (default: 300)
    --disc-delay=SECONDS    discovery interval in seconds (default: 86400)
    --history=DAYS          history retention in days (default: 365)
    --trends=DAYS           trends retention in days (default: 3650)

    -h, --help              print this message

Requirements

  • Perl v5+
  • Pod::Usage
  • XML::Simple
  • Net-SNMP
  • Correctly configured MIB files

Translations

  • Scalar OID -> Zabbix SNMP Item
  • Table OID -> Zabbix SNMP Discovery Rule
  • Table Column OID -> Zabbix Discovery Prototype
  • Trap/Notification OID -> Zabbix SNMP Trap Item
  • OID Enums -> Zabbix Value Map