zabbixwebscenariobuilder's Introduction

ZabbixWebScenarioBuilder v0.0.2

Description

Website monitoring with zabbix is powerful, it can check availability of website by perform httpcheck.

But the UI to build Web-Scenario in Zabbix-Frontend is not easy to use. So ZabbixWebScenarioBuilder will record navigator http/https traffic and convert it to a Zabbix Webscenario.

Requirements

This tools use python to work

Python >= 3.7
pip

Install

Init environment

On Debian Linux To Init environment use virtualenv and pip by running the following command :

virtualenv --python=/usr/bin/python3 venv
. venv/bin/activate
pip install -r requirement.txt

On windows

c:\Program Files\Python\Python38\python.exe -m pip install virtualenv --proxy=http://<ip_of_corporate_proxy>
c:\Program Files\Python\Python38\python.exe -m pip virtualenv venv
.\venv\Scripts\activate
c:\Program Files\Python\Python38\python.exe -m pip install -r requirement.txt --proxy=http://<ip_of_corporate_proxy>

Create config.ini

ZabbixWebScenarioBuilder use a file named config.ini. You must init this file from config.ini.template :

cp config.ini.template config.ini
vi config.ini

Section	key	description
ZABBIX	zabbix_host	Base URL of zabbix (ex: https://zabbix.example.com/zabbix )
ZABBIX	zabbix_user	API user to log on zabbix
ZABBIX	zabbix_password	API password corresponding to user
ZABBIX	zabbix_hostid	Id of host (or Template) to inject generated webscenario
ZABBIX	zabbix_ignore_header	A list of extensions (end of url) of header to not put in webscenario
API	recording_api_port	A listen port on host to display UI
API	recording_api_websocket	A listen port on host to use for UI to fetch event via websocket
PROXY	port	A listen port for local captive proxy
PROXY	proxy_ignore_ext	A list (comma separated) of all extension to not recording (ex: css)

Howto

Start application via main.py

  python main.py

On start application will create a proxy on localhost (127.0.0.1:3128) and open the EDI :

After clicking on "To Zabbix" button, scenario will be on Zabbix

zabbixwebscenariobuilder's People

Contributors

Stargazers

Watchers

zabbixwebscenariobuilder's Issues

Proxy mission option

Hi,
when i start this, i get the following error:

2021-11-16 09:51:02,604 - root - INFO - Start ZabbixWebScenarioBuilder (v1.0.0)
2021-11-16 09:51:02,604 - root - DEBUG - Load config from config.ini
2021-11-16 09:51:02,605 - root - INFO - Démarage du serveur proxy sur 127.0.0.1:3128
Exception in thread Thread-1:
Traceback (most recent call last):
File "/usr/lib/python3.8/threading.py", line 932, in _bootstrap_inner
self.run()
File "/usr/lib/python3.8/threading.py", line 870, in run
self._target(self._args, **self._kwargs)
File "/home/andreas/git-dir/Linux/monitoring/ZabbixWebScenarioBuilder/proxy/captive_proxy.py", line 209, in start_proxy
self.run(CaptiveProxyDumper, cmdline.mitmdump, args, extra)
File "/home/andreas/git-dir/Linux/monitoring/ZabbixWebScenarioBuilder/proxy/captive_proxy.py", line 150, in run
if pconf.options.server:
AttributeError: 'NoneType' object has no attribute 'options'
2021-11-16 09:51:03,612 - root - INFO - fix config
2021-11-16 09:51:03,612 - root - INFO - Connexion au serveur https://******.net/zabbix
2021-11-16 09:51:04,038 - root - INFO - Démarage du serveur d api
2021-11-16 09:51:05,132 - root - INFO - Start websocket server : localhost:3130
2021-11-16 09:51:05,149 - websockets.server - INFO - server listening on 127.0.0.1:3130