Learning analytics playground

Description

This tool is a first draft of connecting an LMS interface to a Graylog server to create a dataset of learning logs.

It is intended to be used locally. Currently, it is using OpenEdx's LMS service (with the fun-flavored dogwood's release).

Clone the current repository.
When using the tool for the first time, you need to run migrations. Run the following command:

make migrate

The tool is now ready for use ! 🚀

The whole learning tool (both LMS and graylog servers) are launched in one command.

make run

When connections are established, you can access:
- the LMS server on localhost:8072
- the Graylog server on localhost:9000

Access Graylog interface with admin / admin credentials.
To configure the input where to listen the LMS server, click on System bar menu and Inputs button.
On Select input, choose GELF TCP and click on Launch new input button.
In the input window appearing, enter the input title you want.
Check that binding adress is 0.0.0.0 and the listening port is 12201.
Ensure that Null frame delimiter? option is activated (on the bottom of the windows), otherwise logs won't be recognized and streamed.
Click on Save button.

Go on LMS server and navigate through the website.
On the Graylog server, go on Search and update the timeframe on Search in all messages option if no logs are visible.
You should see appearing a list of all the messages you have generated!

This work is released under the MIT license (see LICENSE).