61 lines
1.9 KiB
Markdown
61 lines
1.9 KiB
Markdown
# jilo - JItsi Logs Observer
|
|
|
|
## overview
|
|
|
|
Bash scripts for collecting and displaying information about conference events from Jitsi Meet logs.
|
|
|
|
The webpage for this project is https://lindeas.com/jilo. The main git repo is:
|
|
- https://code.lindeas.com/lindeas/jilo
|
|
|
|
It is mirrored at:
|
|
- https://codeberg.org/lindeas/jilo
|
|
- https://github.com/lindeas/jilo
|
|
- https://gitlab.com/lindeas/jilo
|
|
|
|
You can use any of these git repos to get the program.
|
|
|
|
You are welcome to send feedback with issues, comments and pull requests to a git mirror you prefer.
|
|
|
|
## version
|
|
|
|
Current version: **0.1** released on **2024-06-12**
|
|
|
|
## components
|
|
|
|
Currently this has two components:
|
|
|
|
- `jilo` is the script for collecting data from the logs.
|
|
It is meant to be installed and run on the server and it needs read permissions for the logs.
|
|
Currently it works with Videobridge and Jicofo log files.
|
|
You can run it with cron to periodically update the new data from the logs.
|
|
|
|
- `jilo-cli` is a command line client for displaying stats from an already populated jilo database
|
|
It needs access to the jilo database.
|
|
|
|
## installation
|
|
|
|
Clone the git repo:
|
|
```bash
|
|
git clone https://github.com/lindeas/jilo.git
|
|
cd jilo
|
|
```
|
|
|
|
## config
|
|
|
|
The config file **jilo.conf** overrides the default settings.
|
|
For more details check the comments in the scripts or use the --help option
|
|
|
|
## database
|
|
|
|
The database can be an SQLite file or MySQL/MariaDB database. The default is local sqlite file.
|
|
|
|
## running
|
|
|
|
You can run `jilo` once or add it to a crontab. If you run it periodically it will keep track of all.
|
|
events, detecting when the logs rotate and continuing from where it left on the previous run.
|
|
|
|
Use `jilo-cli` to visualize the info from the database that was gathered previously with `jilo`
|
|
|
|
`jilo-cli` can search for conference and participant events, and display events in a given time period..
|
|
Where appropriate, combine `jilo-cli` with sort, wc and other tools to get total numbers.
|