This repository contains three loosely coupled projects:
-
Kronos is a time series storage engine that allows you to store and retrieve timestamped JSON blobs from various backends (e.g., Cassandra, S3). It's a way friendlier logging API than your filesystem.
-
Metis is a HTTP compute service over streams of data stored in Kronos. It's currently implemented as a thin wrapper around the Spark data processing engine.
-
Jia is a visualization, dashboarding, and data exploration tool. It can speak with Kronos and Metis. It answers questions for humans, rather than just developers.
Each of these projects has a "Get running in 5 minutes" section. If you can't get started with one of these systems in five minutes, contact us and we'll make sure you can!
You're contributing to this project by using it, so thanks!
If you run into any issues with code or documentation, please file an issue and we'll jump in as soon as we can.
If you contribute code, run the appropriate runtests.py in each
subproject directory, and please add some tests for your new
contribution.
We generally stick to PEP8 for our coding style with the exception of using 2-space tabs. Be sure to indent with spaces and wrap at 79 characters.
Note: we're currently working through the fact that only repository owners can follow these directions. As a temporary measure, use edX's rebase instructions to contribute to this repository.
Before making a contribution, create a new branch off of master:
git pull origin master
git checkout -b feature-branch
Edit your code and commit it, and then push it back to github:
git push origin feature-branch
Submit a pull request, and await a code review. Once a
reviewer comments 'LGTM' (looks good to me), bring the code into
master with the following command (from your feature-branch):
./push_branch.sh <commit message>
Many many thanks for contributing!