Open edX Caliper Tracking app can be used to transform Open edX tracking events into Caliper standard compliant events.
Project description
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:
Create a log file with read/write permissions given to syslog user e.g: /edx/var/log/caliper-analytics/caliper.log
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for openedx-caliper-tracking-0.11.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 123e0d12ae4941c6acb59c851905db71095e4476b351701f9dcc73e992306fd0 |
|
MD5 | fd743f35a23ed2b0a7bd64ce035ca439 |
|
BLAKE2b-256 | 1c4b17c5405398db820a5543d86fe4e2671fa70a5f3f555362a97789429790a9 |
Hashes for openedx_caliper_tracking-0.11.1-py2-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5dffa8ebbaa669c27c66f9c872ff604b7c99b14593c28a73bbe8023399046946 |
|
MD5 | a619a77fad59ee394a068182e8b2c42f |
|
BLAKE2b-256 | e2c2916d669343978f26e1d45f5b562bda625d37a3fc0a200684a1c762d5a5b6 |