Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tofran/ts3-log-analyzer
:calendar: ts3LogAnalyzer: Analyze TeamSpeak 3 logs
https://github.com/tofran/ts3-log-analyzer
log-analyzer logs pypi python statistics teamspeak ts3 ts3admin ts3server
Last synced: 10 days ago
JSON representation
:calendar: ts3LogAnalyzer: Analyze TeamSpeak 3 logs
- Host: GitHub
- URL: https://github.com/tofran/ts3-log-analyzer
- Owner: tofran
- License: gpl-3.0
- Created: 2015-04-22T18:04:19.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2020-09-11T00:18:08.000Z (about 4 years ago)
- Last Synced: 2024-10-15T17:21:08.491Z (22 days ago)
- Topics: log-analyzer, logs, pypi, python, statistics, teamspeak, ts3, ts3admin, ts3server
- Language: Python
- Homepage:
- Size: 126 KB
- Stars: 12
- Watchers: 3
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TS3 Log Analyser
[][pypi]
**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
- Merge users with different identities
- and much more...
Generate useful/fun statistics like the ones you can [find here][ToFran's server statistics] for my server:
[][ToFran's server statistics]
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][ToFran's server statistics] (If you belive that everyone should backup their identities, and if they don't do it, it's their fault - you can ignore this feature :D )
**Disclaimer:** The aim of this project/repo is the log analyzer This repo does not include the web viewer. I'm still developing it, and currently it is not published. This means that you can only generate the DB, and build your own web application. Hopefully I will release [mine](https://github.com/tofran/ts3LogAnalyzer-viwer).
Analy**s**e VS Analy**z**e: Look, English is not my main language, therefore I only found out that anali*s*e could be spelled with an `s` or `z` much after creating and publishing this project. I do not believe that one is better over another. If you cannot live with ts3LogAnaly**z**er with `z` you can always alias it :P.
## Usage
### Installation
Python 3 only.
`pip install ts3LogAnalyzer`
Alternatively you can clone and setup using setuptools or simply call the file directly.
### Examples
* 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`
### Options
```
ts3LogAnalyzer.py
Usage:
ts3LogAnalyzer.py -a [--stats] [--no-ips] [--mergeable] [--debug] [--output-logging]
ts3LogAnalyzer.py --merge [--debug] [--output-logging]
ts3LogAnalyzer.py ([--stats] | [--no-ips]) [--debug] [--output-logging]
ts3LogAnalyzer.py -h | --help
ts3LogAnalyzer.py -v | --version
Options:
-a --analyze 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
```
## Todo
- [ ] Performance improvements #3
- [ ] Support for other DB's other than SQLite #5
- [ ] Python 2 compatibility
## Discussion
Feature requests and bugs: [issues]
Other discussion: TeamSpeak forum [thread]
## Licence
GNU General Public License v3.0
## Contact/Donate
Contact me at [tofran.com](https://tofran.com).
[ToFran's server statistics]: http://tofran.com/ts/stats/
[thread]: http://forum.teamspeak.com/showthread.php/112796-RELEASE-TS3logAnalyser-Analyse-your-teamspeak-server-logs
[pypi]: https://pypi.python.org/pypi/ts3LogAnalyzer
[issues]: https://github.com/tofran/ts3LogAnalyzer/issues
[v1_java]: (https://github.com/ToFran/TS3LogAnalyzer/tree/v1_java)