Zabbix snmpsim

This repo provides a quick way to test Zabbix templates using:

• different SNMP devices snapshots loaded into snmpsim app.
• different applications docker containers (Nginx, Apache, Postgresql, MySQL...)

SNMPSIM

• 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 -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 -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

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

Zabbix 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.