helyux / bbb-readable-feedback

Script that creates humanly readable output from the feedback logs of a BigBlueButton (BBB) instance.

BBB-Readable-Feedback

Did you activate the feedback feature in BigBlueButton (BBB) but you can't read all the jibberish in the logfile? This simple script creates humanly readable output from the feedback logs of your BigBlueButton (BBB) instance.

It has 7 simple cmd parameters you can use, none of which is required:

Short	Parameter	Default	Explanation
-h	--help	None	Displays this table
-p	--path	/var/log/nginx/	Provide the full path to the directory containing the feedback logs
-cl	--charlimit	100	The character length on which we wrap the comment
-s	--silent	False	If True the script won't have any output
-pz	--parsezip	False	If True unzip .gz logs and parse them aswell
-tf	--tofile	False	If True write the output to html5-client-readable.log
-csv		False	If True write the output to BBB-Feedback.csv

Installation

• Make sure you got atleast Python 3.6 installed: python3 -V
• Copy the script or clone this repo to the server containing the BBB instance: git clone https://github.com/Helyux/BBB-Readable-Feedback

Example Use

Execute python3 ReadFeedback.py -pz -tf

This will parse all html5-client.log files in the directory /var/log/nginx/, even those who are already zipped (-pz) and display something like this: It'll also write the displayed info to the file html5-client-readable.log in the given path. (-tf)

bbb-readable-feedback's Issues

CSV output

First of all: Thank you so much, this tool probably cures the headache of everybody who wanted to use the feedback function ;-)

It would be nice if there is some "standarized" output; e.g. a CSV file. One could then just open it in Excel/LibreOffice/R and do some statistics magic.

Email option would be very handy

As the title already suggests, having a file is pretty awesome, having it automatically by email (of course, with smtp credentials) would be even more awesome ;-)

How to show the feedback log as URL link in the GreenLight Organization Page

First of all: Thank you so much
Please How to show the feedback log as URL link in the GreenLight Organization Page when clicked it shows the log within page
like this example