The Chronology Project
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.
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.
Get running in 5 minutes
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
Minimal style guide
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
./push_branch.sh <commit message>
Many many thanks for contributing!