lindeas
/
jilo
1
1
Fork 0
Code Issues Pull Requests Packages Projects Releases 2 Wiki Activity
JItsi Logs Observer https://lindeas.com/jilo/
107 Commits
1 Branch
2 Tags
472 KiB
Shell 98.1%
Roff 1.9%
 
 
Go to file
Yasen Pramatarov 97f0f5655e Fixes components search, adds component_id option 2024-07-08 11:37:32 +03:00
packaging Version bump 2024-06-18 11:08:35 +03:00
.gitignore Moves "jilo-web" to its own repo. 2024-06-28 19:50:51 +03:00
CHANGELOG.md Moves "jilo-web" to its own repo. 2024-06-28 19:50:51 +03:00
LICENSE Initial commit 2024-05-22 06:51:40 +00:00
README.md Adds reference to "jilo-web" 2024-06-28 19:57:05 +03:00
TODO.md Adds duration and number of participants in conferences lists. 2024-06-17 13:30:47 +03:00
jilo Fixes formatting 2024-06-25 12:13:21 +03:00
jilo-cli Fixes components search, adds component_id option 2024-07-08 11:37:32 +03:00
jilo.conf Lists all available config options 2024-06-12 16:34:28 +03:00
log-regexps.md Fixes formatting 2024-06-25 12:14:33 +03:00

README.md

jilo - JItsi Logs Observer

overview

Bash scripts for collecting and displaying information about conference events from Jitsi Meet logs.

This is the command line tools repository. For a web interface to query Jilo, go to the "jilo-web" repository.

The webpage for this project is https://lindeas.com/jilo. The main git repo is:

It is mirrored at:

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.1 released on 2024-06-18

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

You can install it in the following ways:

  • use the latest deb package from the APT repo - recommended for Debian/Ubuntu

  • use the latest RPM package - recommended for rpm-based systems

  • download the latest release from the "Releases" section here

  • clone the git repo:

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.