/BBB-Readable-Feedback2.4

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

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

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 6 simple cmd parameters you can use, none of which is required:

Short Parameter Default Explanation
-h --help None Show this table
-p --path /var/log/nginx/ Provide the full path to the directory containing the feedback logs
-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 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 print something like this:
Screenshot It'll also write the printed info to the file html5-client-readable.log in the given path. (-tf)