regina - nginx analytics tool

Ruling Empress Generating In-depth Nginx Analytics (obviously)

Overview

Regina is an analytics tool for nginx. It collects information from the nginx access.log and stores it in a sqlite3 database. Regina supports several data visualization configurations and can generate an admin-analytics page from an html template file.

Command line options

-h, --help: Show the the possible command line arguments
-c, --config config-file: Retrieve settings from the config-file
--access-log log-file: Overrides the access_log from the configuration
--collect: Collect information from the access_log and store them in the databse
--visualize: Visualize the data from the database
--update-geoip geoip-db: Recreate the geoip part of the database from the geoip-db csv. The csv must have this form: lower, upper, country-code, country-name, region, city

Installation with pip

You can also install regina with python-pip:

git clone https://github.com/MatthiasQuintern/regina.git
cd regina
python3 -m pip install .

You can also install it system-wide using sudo python3 -m pip install .

If you also want to install the man-page and the zsh completion script:

sudo cp regina.1.man /usr/share/man/man1/regina.1
sudo gzip /usr/share/man/man1/regina.1
sudo cp _regina.compdef.zsh /usr/share/zsh/site-functions/_regina
sudo chmod +x /usr/share/zsh/site-functions/_regina

Changelog

2.0

Refactored databse code
New database format:
- Removed filegroups table
- Put referrer, browser and platform in own table to reduze size of the database

1.0

Initial release

Copyright

Copyright © 2022 Matthias Quintern. License GPLv3+: GNU GPL version 3 https://gnu.org/licenses/gpl.html.
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

1.9 KiB Raw Blame History