A Python utility for analyzing TeamSpeak 3 server logs.
Analyze multiple log files or an entire log folder. Stores info about all clients and respective connections and nicknames in a SQLite database for ease of use by other applications.
Can be used for extracting information like:
- Who has the most cumulative connection time on the server / Time spent by each user on server
- Longest connection time for each user
- First and last seen
- Most used nicknames
- Total number of connections
- and much more...
Generate useful/fun statistics like the ones you can find here for my server:
It can also 'merge' identities out of the box, this way you can combine stats for users that have multiple identities - as seen in the example above (If you are a TeamSpeak fanatic that strongly believes that everyone should backup their identities, and if they don't do it, it's their fault - you can ignore this feature :D )
Python 3 only.
pip install ts3LogAnalyzer
Alternatively you can clone and setup using setuptools or simply call the file directly.
- Analyze a file:
$ ts3LogAnalyzer databse.db -a ts3server_2017-02-12__11_46_44.016222_1.log
- Analyze a folder:
$ ts3LogAnalyzer databse.db -a ts3server/logs
- Analyze a folder, make it mergeable and generate statistics and hide IP's:
$ ts3LogAnalyzer databse.db -a . -msi
- Be nice to the system when running:
$ nice -n 19 ts3LogAnalyzer db.db -a /path/ -msi
- Merge two clients:
$ ts3LogAnalyzer databse.db --merge 13 37
ts3LogAnalyzer.py Usage: ts3LogAnalyzer.py <database> -a <path> [--stats] [--no-ips] [--mergeable] [--debug] [--output-logging] ts3LogAnalyzer.py <database> --merge <c1> <c2> [--debug] [--output-logging] ts3LogAnalyzer.py <database> ([--stats] | [--no-ips]) [--debug] [--output-logging] ts3LogAnalyzer.py -h | --help ts3LogAnalyzer.py -v | --version Options: -a --analyze <path> Log file or folder to analyze -s --stats Generate statistic fields for every client -i --no-ips Remove ip's from the databse -m --mergeable Make the clients mergeable --output-logging Output logging from THIS program to ts3LogAnalyzer.log --debug Output debug information -h --help Show this screen -v --version Show version Discussion in the TeamSpeak forum thread.
GNU General Public License v3.0
If you really want to donate you can do it [via PayPal][paypal.me/tofran], for other methods contact me at tofran.com.
