There is a log-reader component responsible for fetching data from VSL and having it stored into a MySql database, furthermore there is an available UI that will display in a hierachical manner all requests going through varnish to your services. Both of these components share the same MySql instance.
Following packages are required for running Zipnish:
Install with pip:
$ sudo pip install zipnish
A configuration file found at
/etc/zipnish/zipnish.cfg is required with a structure as described below:
[Database] # Db settings for the MySql connection. # MySql host host = 192.168.59.103 # Database name db_name = microservice # User name user = zipnish # Password pass = secret # Connection keep-alive keep_alive = true [Cache] # Defines which cache to fetch logs from. # Name of the cache (same value sent via the -n argument) # name = demo [Log] # Path to the daemon logfile. log_file = /var/log/zipnish/zipnish.log # Valid log_levels are: DEBUG, INFO, WARNING, ERROR log_level = DEBUG
For convenience purposes, there is a docker image available which handles setting up Mariadb database along with a test user.
Considering that your Varnish instance is properly configured in relation to your services, after installing Zipnish there are two commands available:
Run the logreader:
Run the ui (by default port 5000):