carmes/zbx_snmpsim

[Work in progress] This repo provides a quick way to test Zabbix SNMP templates with Zabbix and a snmpsim snapshots provided by snmpsim

Zabbix snmpsim

[Work in progress] This repo provides a quick way to test Zabbix SNMP templates with Zabbix and a snmpsim snapshots provided by snmpsim app.

Prepare simulation data

• Add file *.snmpwalk or *.snmprec to data dir. More on how to prepare simulation data is here

Test with bundled Zabbix Server

• run docker-compose to start zabbix-server and snmpsim docker-compose.exe -f .\docker-compose.snmpsim.yml -f .\docker-compose.zabbix.yml up
• Access Zabbix Frontend on http://localhost
• Add new host with SNMP interface and use DNS address snmpsim to connect, use port 161
• Add {$SNMP_COMMUNITY} macro with the same value as *.snmprec *.snmpwalk filename

Test with already existing Zabbix Server

You can also just use snmpsim instance without bundled Zabbix Server and test with your own Zabbix that is up and running somewhere:

• Start snmpsim only: docker-compose.exe -f .\docker-compose.snmpsim.yml up
• Access Zabbix Frontend
• Add new host with SNMP interface and use IP address of the host you are running on, use port 161
• Add {$SNMP_COMMUNITY} macro with the same value as snmprec/snmpwalk filename

Some automation

Use bundled python script create_hosts.py <snmpsim root data dir> to mass create hosts and attach templates. (Requires py-zabbix, run pip install py-zabbix first)
For example:

• bin/create_hosts.py data - to create hosts and attach templates for all *snmpwalk, *snmprec files found in the data dir.
• bin/create_hosts.py data --filter dlink - to create host that contains dlink in the filename and attach Template Net D-Link DES_DGS Switch SNMPv2 to them:

.\bin\create_hosts.py .\data\ --filter dlink
Found file .\data\net.dlink.DGS-3627G.snmpwalk...
Going to create host "net.dlink.DGS-3627G" with templates "[{'name': 'Template Net D-Link DES_DGS Switch SNMPv2', 'templateid': 10223}]" attached
Found file .\data\net.dlink.des3200.snmprec...
Going to create host "net.dlink.des3200" with templates "[{'name': 'Template Net D-Link DES_DGS Switch SNMPv2', 'templateid': 10223}]" attached
Found file .\data\net.dlink.dgs-3420-26sc.snmpwalk...
Going to create host "net.dlink.dgs-3420-26sc" with templates "[{'name': 'Template Net D-Link DES_DGS Switch SNMPv2', 'templateid': 10223}]" attached

• bin/create_hosts.py --api_url http://myzabbix.local/api_jsonrpc.php --username=myuser --password mypassword data --snmpsim-ip=192.168.3.4 to create snmpsim hosts on the other Zabbix Server.
  Note that you need to provide root snmpsim directory that you mount into snmpsim, do not provide subdirs in the snmpsim data tree - otherwise {$SNMP_COMMUNITY} macro value would be wrong!
  See --help for usage.

Test with snmpwalk

You may also just test using snmpwalk cli:

$ snmpwalk -c net.dlink.des3200 -v 2c localhost
iso.3.6.1.2.1.1.1.0 = STRING: "DES-3200-18 Fast Ethernet Switch"
iso.3.6.1.2.1.1.2.0 = OID: iso.3.6.1.4.1.171.10.113.3.1
iso.3.6.1.2.1.1.3.0 = Timeticks: (43321800) 5 days, 0:20:18.00
iso.3.6.1.2.1.1.4.0 = STRING: "burbon"
iso.3.6.1.2.1.1.5.0 = STRING: "des3200-18-kotel.ryl"
iso.3.6.1.2.1.1.6.0 = STRING: "kotelnaya.ryl"
iso.3.6.1.2.1.1.7.0 = INTEGER: 3
iso.3.6.1.2.1.1.8.0 = Timeticks: (43321815) 5 days, 0:20:18.15
iso.3.6.1.2.1.1.9.1.2.1 = OID: iso.3.6.1.4.1.171.12.14
iso.3.6.1.2.1.1.9.1.2.2 = OID: iso.3.6.1.4.1.171.12.93
iso.3.6.1.2.1.1.9.1.2.3 = OID: iso.3.6.1.4.1.171.12.58
iso.3.6.1.2.1.1.9.1.2.4 = OID: iso.3.6.1.4.1.171.12.72
iso.3.6.1.2.1.1.9.1.2.5 = OID: iso.3.6.1.4.1.171.12.9
iso.3.6.1.2.1.1.9.1.2.6 = OID: iso.2.840.802.10006.300.43
iso.3.6.1.2.1.1.9.1.2.7 = OID: iso.0.8802.1.1.2.65538.131072.2156600556
...

where community can be found by running:

$ snmpwalk -c index -v 2c localhost .1.3

How to redefine host settings on creation

Work in progress!
Base templates depends on the filename. Some logic how template are choosen by default is defined here: bin/snmpsim_rules.py#set_templates()

//TODO:
You can rewrite any template settings by creating host.json file nearby host.snmpec file.
For example:

    {
        "templates":[
            "Template OS Linux",
            "Template ICMP Ping"
        ]
    }