Skip to content
Django app to make Open edX tracking logs Caliper Compliant
Python
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
openedx_caliper_tracking
.gitignore FIX: fix the post request function Apr 16, 2019
CHANGES
LICENSE Add specifications according to the Pypi Mar 7, 2019
MANIFEST.in refactor code to run tests Mar 26, 2019
README.rst chore: version bump Jul 23, 2019
__init__.py change app name Feb 12, 2019
setup.py chore: version bump Jul 23, 2019

README.rst

Open edX Caliper Tracking

Description

Open edX Caliper Tracking can be used to transform the edX traditional event logs into Caliper Analytics Specifications provided by IMS Global. Generated logs can be consumed by any analytics application which is compatible with Caliper Standard.

Installation

To install openedx-caliper-tracking in your Open edX installation, please add the following line to your requirements file. (For most Open edX installations it should be located at edx-platform/requirements/edx/base.txt):

openedx-caliper-tracking==0.11.1

Usage

To enable and use openedx-caliper-tracking:

Please add ENABLE_EVENT_CALIPERIZATION flag under FEATURES in the following files:

  • /edx/app/edxapp/lms.env.json
  • /edx/app/edxapp/cms.env.json

These files should be located at /edx/app/edxapp/ directory, see the example below:

"FEATURES": {
    ...

    "ENABLE_EVENT_CALIPERIZATION": true,

}

Location of Transformed Logs

Transformed events are logged using 'logging.handlers.SysLogHandler' with 'facility: local2'.

We need to create output files manually and set appropriate permissions for syslog user. To do so, please follow the steps below:

  1. Create a log file with read/write permissions given to syslog user e.g: /edx/var/log/caliper-analytics/caliper.log

  2. Create a mapping for 'local2' in the configuration files present in /etc/rsyslog.d/

    local2.*                 /edx/var/log/caliper-analytics/caliper.log
    

License

The code in this repository is licensed under the GPL v3.0 unless otherwise noted. Please see LICENSE for details.

How To Contribute

To contribute, please make a pull request in this repositry on Github: Open edX Caliper Tracking. If you have any question or issue, please feel free to open an issue on Github: Open edX Caliper Tracking.

Contributors

You can’t perform that action at this time.