jilo/README.md

61 lines
1.9 KiB
Markdown
Raw Normal View History

2024-06-12 16:07:06 +00:00
# jilo - JItsi Logs Observer
2024-05-22 06:51:40 +00:00
2024-06-12 16:07:06 +00:00
## 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
2024-06-04 17:10:49 +00:00
Currently this has two components:
2024-06-12 16:07:06 +00:00
- `jilo` is the script for collecting data from the logs.
2024-06-04 17:10:49 +00:00
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.
2024-06-12 16:07:06 +00:00
- `jilo-cli` is a command line client for displaying stats from an already populated jilo database
2024-06-04 17:10:49 +00:00
It needs access to the jilo database.
2024-06-12 16:07:06 +00:00
## installation
Clone the git repo:
```bash
git clone https://github.com/lindeas/jilo.git
cd jilo
```
## config
2024-06-04 17:10:49 +00:00
The config file **jilo.conf** overrides the default settings.
For more details check the comments in the scripts or use the --help option
2024-06-12 16:07:06 +00:00
## 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.