A distributed system designed to ingest and process time series data
Java Other
Latest commit 6cacb4f Apr 28, 2017 @shintasmith shintasmith committed on GitHub Merge pull request #804 from shintasmith/dtx_pool
create properties for the datastax connection pool settings
Failed to load latest commit information.
bin add check for blueflood-all/target directory Jan 22, 2016
blueflood-all integrating docker build into maven build Dec 15, 2016
blueflood-cloudfiles update versions to the next dev version Nov 29, 2016
blueflood-core remove extranous meter Apr 28, 2017
blueflood-elasticsearch Code changes to avoid return duplicates from metric_name search Mar 15, 2017
blueflood-http install idle state handler Apr 21, 2017
blueflood-rollupTools remove string and boolean metrics Jan 6, 2017
contrib Merge pull request #790 from izrik/client Mar 2, 2017
demo Correcting property name in blueflood.conf Mar 2, 2017
maven/repo/com/stuartwarren/logit Create a local repository to use for stuartwarren logit stuff. Sep 30, 2014
ops/rackspace-agent-plugins Updating bf-rollups-delay.py to support new blueflood installations w… Feb 5, 2016
src/cassandra/cli removing enum-related tables Jan 5, 2017
.gitignore add profile, add ignore Jan 18, 2016
.travis.yml update travis to not use cassandra2.0 profile anymore Feb 1, 2017
CHANGES.md add ENABLE_DTX_INGEST_BATCH option. If set to true, blueflood will us… Apr 7, 2017
Ideas.md Add idea about exploring Dropwizard. Feb 24, 2014
LICENSE Revert "Making all the copyrights current" Jun 24, 2015
NOTICE.txt Revert "Making all the copyrights current" Jun 24, 2015
README.md one more formatting changes Apr 13, 2017
pom.xml add ENABLE_DTX_INGEST_BATCH option. If set to true, blueflood will us… Apr 7, 2017
versions.properties update versions to the next dev version Nov 29, 2016



Build Status Coveralls Releases License

Discuss - Code - Site


Blueflood is a multi-tenant, distributed metric processing system. Blueflood is capable of ingesting, rolling up and serving metrics at a massive scale.

Getting Started

The latest code will always be here on Github.

git clone https://github.com/rackerlabs/blueflood.git
cd blueflood

You can run the entire suite of tests using Maven:

mvn test integration-test


Build an 'uber jar' using maven:

mvn package -P all-modules

The uber jar will be found in ${BLUEFLOOD_DIR}/blueflood-all/target/blueflood-all-${VERSION}-jar-with-dependencies.jar. This jar contains all the dependencies necessary to run Blueflood with a very simple classpath.

Build a docker image:

mvn clean package  docker:build -Pall-modules


The best place to start is the 10 minute guide. In a nutshell, you must do this:

java -cp /path/to/uber.jar \
-Dblueflood.config=file:///path/to/blueflood.conf \
-Dlog4j.configuration=file:///path/to/log4j.properties \

Each configuration option can be found in Configuration.java. Each of those can be overridden on the command line by doing:


Additional Tools

The Blueflood team maintains a number of tools that are related to the project, but not essential components of it. These tools are kept in various other repos:


First, we welcome bug reports and contributions. If you would like to contribute code, just fork this project and send us a pull request. If you would like to contribute documentation, you should get familiar with our wiki

Also, we have set up a Google Group to answer questions.

If you prefer IRC, most of the Blueflood developers are in #blueflood on Freenode.


Copyright 2013-2017 Rackspace

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at


Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.