KairosDB is a fast distributed scalable time series database written on top of Cassandra.
Documentation is found here.
Download the latest KairosDB release.
Installation instructions are found here
If you want to test KairosDB in Kubernetes please follow the instructions from KairosDB Helm chart.
Join the KairosDB discussion group.
The Waylay branch is built using maven. For 1.3.0.x versions do checkoud of 1.3.0-waylay branch before release:
$ git checkout 1.3.0-waylay
Note that the version number includes a patch number (e.g. the "+3" in 1.3.0-waylay+1). This patch number should be incremented on each release (and the base KairosDB version should remain unchanged).
To run tests using a local Cassandra installation, run
$ CASSANDRA_HOST=localhost mvn clean test
Running mvn test without the CASSANDRA_HOST environment variable will skip tests that depend on Cassandra.
Running mvn deploy will push the artifacts, including the distributable .tar.gz to Nexus
(make sure you have specified credentials for NEXUS maven-releases server in settings.xml)
Releases can be performed with the following command (TODO:make sure that the release pushes the artifacts to nexus):
mvn clean -DskipTests -Darguments=-DskipTests -Dmaven.javadoc.skip=true release:clean release:prepare release:perform
Note that the build directory which is created by a number of tests doesn't always get cleaned up properly by
the tests. This means that it may be necessary to do a rm -rf build between builds of this repo.
Contributions to KairosDB are very welcome. KairosDB is mainly developed in Java, but there's a lot of tasks for non-Java programmers too, so don't feel shy and join us!
What you can do for KairosDB:
- KairosDB Core: join the development of core features of KairosDB.
- Website: improve the KairosDB website.
- Documentation: improve our documentation, it's a very important task.
If you have any questions about how to contribute to KairosDB, join our discussion group and tell us your issue.
The license is the Apache License 2.0