Cairn used to be a commercial-only plugin that was part of the Tutor Wizard Edition. This subscription model has supported me for the past few years and allowed to focus on maintaining the free parts of Tutor. With the recent acquisition of Overhang.IO by Edly, it no longer makes sense to keep this plugin behind closed doors. If you were a subscriber of the Tutor Wizard Edition, you should know that I am extremely grateful for your support, and I hope we can keep working together
This is a change that I’ve been looking forward to ever since I created the Wizard Edition… It’s always been a bit awkward to publish open source plugins but make them only available to commercial subscribers. I am exceptionally proud of Cairn and the possibilities that it creates for the Open edX platform, and it feels great to finally share the source code with the rest of the world.
Since Cairn was created, the OARS initiative was kickstarted by Axim and community members to build an Open edX analytics stack on the same technical foundations as Cairn. Our hope is that we can work together to avoid the duplication of efforts. There are some components of OARS that Cairn will re-use, such as the authentication system. Others, such as the learning record store, introduce extra complexity without immediate benefits to the end user and should probably be kept as optional components (IMHO). In any case, I am super excited by the possibilities that a powerful, free analytics stack offers for Open edX.
Happy and excited to read this, I remembered one group meeting, where open question was floated, what are the various analytics tools available in Open edX, Cairn was one of them and question asked, whether you are willing to make it open source. You said, No. But I am sure you were in that process to make open source some time. This is really a good new for community that Cairn is open source now! But this certainly create few clouds in sky like
I have a few questions and maybe you can shed light on what is possible in our situation.
We have been using Insights for a long time. Our current Tutor installation does convert the tracking logs in the Raw format expected by Insights. We also rotate and gzip our tracking logs each hour when they reach a certain size. Finally, we transfer those tracking logs to S3.
If I understand correctly the instructions in the README page for Cairn, all tracking logs events must be in a single file $(tutor config printroot)/data/lms/logs/tracking.log. Am I right?
I can always bring back our tracking logs from S3 to our local server, that’s not an issue. But is there a tool or a script to convert these tracking logs in the format expected by Cairn?
Obviously, this is a big deal for us if we were to switch from Insights to Cairn because we would like to keep our historical data from the last 7 or 8 years. I would have the same questions for OARS to be honest. But I know they plan to have a tool to convert the event logs to xAPI.
Right now our focus is on supporting existing Cairn users, so this is where we are going to invest our efforts. But from discussions with @BrianMesick, @jill and @e0d there is a strong consensus that both projects need to merge. How exactly this will happen in the future is still an open question at this point.
For all purpose and intent, you can now consider that the Wizard Edition no longer exists. But when it existed, the plugins that it included were open source – yes, turns out you can sell open source software
Not exactly @sambapete. In Cairn, logs are collected (by Vector) in real time from the Docker daemon, which outputs logs to stdout.
When Cairn is launched for the first time, past events that were triggered prior to the plugin installation will not be loaded in the data lake. If you are interested in loading past events, you should load them manually by running:
tutor local start -d cairn-clickhouse
tutor local run \
--volume="$(tutor config printroot)/data/lms/logs/:/var/log/openedx/:ro" \
--volume="$(tutor config printroot)/env/plugins/cairn/apps/vector/file.toml:/etc/vector/file.toml:ro" \
-e VECTOR_CONFIG=/etc/vector/file.toml cairn-vector
The latter command will parse tracking log events from the $(tutor config printroot)/data/lms/logs/tracking.log file that contains all the tracking logs since the creation of your platform. The command will take a while to run if you have a large platform that has been running for a long time. It can be interrupted at any time and started again, as the log collector keeps track of its position within the tracking log file.
To ingest a very large amount of logs, I suspect that you will have to massage this CLI a bit, and you might want to adjust the log parsing format. But I’m sure you get the idea
What is the minimum required Tutor version? I went to test it on a tutor 14.0.3 system and got Error: No plugin found at cairn (and tutor plugins update doesn’t work on this version either)
Cairn works on Nutmeg, but you should then install it with pip: pip install 'tutor-cairn<15.0.0'. The tutor plugins install command was only introduced in Olive.
