{"id":26861042,"url":"https://github.com/rackerlabs/blueflood","last_synced_at":"2025-03-31T02:01:52.473Z","repository":{"id":37846067,"uuid":"10081109","full_name":"rax-maas/blueflood","owner":"rax-maas","description":"A distributed system designed to ingest and process time series data","archived":false,"fork":false,"pushed_at":"2024-02-29T05:31:04.000Z","size":12092,"stargazers_count":592,"open_issues_count":56,"forks_count":102,"subscribers_count":95,"default_branch":"master","last_synced_at":"2024-04-13T21:11:00.427Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://www.blueflood.io","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rax-maas.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2013-05-15T14:50:39.000Z","updated_at":"2024-04-22T16:26:48.390Z","dependencies_parsed_at":"2024-01-11T20:43:06.464Z","dependency_job_id":"a9ee9116-7d07-4fe9-af4e-5fc4e832ab24","html_url":"https://github.com/rax-maas/blueflood","commit_stats":null,"previous_names":["rackerlabs/blueflood"],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rax-maas%2Fblueflood","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rax-maas%2Fblueflood/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rax-maas%2Fblueflood/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rax-maas%2Fblueflood/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rax-maas","download_url":"https://codeload.github.com/rax-maas/blueflood/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246403911,"owners_count":20771530,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-31T02:00:46.139Z","updated_at":"2025-03-31T02:01:52.443Z","avatar_url":"https://github.com/rax-maas.png","language":"Java","readme":"\u003cp align=\"center\"\u003e\r\n \u003cimg src=\"http://blueflood.io/images/bf-bg-color.png\" width=\"220\" height=\"232\" align=center\u003e\r\n\u003c/p\u003e\r\n\r\n# Blueflood\r\n\r\n[![Unit tests](https://github.com/rax-maas/blueflood/actions/workflows/unit-test.yml/badge.svg?branch=master)](https://github.com/rax-maas/blueflood/actions/workflows/unit-test.yml)\r\n[![Coverage Status](https://coveralls.io/repos/github/rax-maas/blueflood/badge.svg?branch=master)](https://coveralls.io/github/rax-maas/blueflood?branch=master)\r\n[![License](https://img.shields.io/badge/license-Apache%202-blue.svg)](http://www.apache.org/licenses/LICENSE-2.0)\r\n\r\n[Discuss](https://groups.google.com/forum/#!forum/blueflood-discuss) - [Code](http://github.com/rackerlabs/blueflood) - [Site](http://blueflood.io)\r\n\r\n## Introduction\r\n\r\nBlueflood is a multi-tenant, distributed metric processing system. Blueflood is capable of ingesting, rolling up and serving metrics at a massive scale.  \r\n\r\n## Getting Started\r\n\r\nThe latest code will always be here on Github.\r\n\r\n    git clone https://github.com/rax-maas/blueflood.git\r\n    cd blueflood\r\n\r\n## Building\r\n\r\nBlueflood builds and runs on Java 8. Ensure you're using an appropriate JDK before proceeding.\r\n\r\nBlueflood builds with Maven. Use typical Maven lifecycle phases:\r\n\r\n- `mvn clean` removes build artifacts.\r\n- `mvn test` runs unit tests.\r\n- `mvn verify` runs all tests.\r\n- `mvn package` builds a Blueflood package for release.\r\n\r\nImportant build profiles to know about:\r\n\r\n- `skip-unit-tests` skips unit tests in all modules.\r\n- `skip-integration-tests` skips the integration tests.\r\n\r\nBlueflood's main artifact is an ['uber jar'](http://stackoverflow.com/questions/11947037/what-is-an-uber-jar), produced\r\nby the [`blueflood-all` module](blueflood-all/pom.xml).\r\n\r\nAfter compiling, you can also build a Docker image with `mvn docker:build`. See\r\n[blueflood-docker](contrib/blueflood-docker) for the Docker-related files.\r\n\r\n### Running\r\n\r\nYou can easily build a ready-to-run Blueflood jar from source:\r\n\r\n    mvn package -P skip-unit-tests,skip-integration-tests\r\n\r\nHowever, it requires Cassandra to start and Elasticsearch for all its features to work. The best place to start is the\r\n[10 minute guide](https://github.com/rackerlabs/blueflood/wiki/10-Minute-Guide).\r\n\r\n## Additional Tools\r\n\r\nThe Blueflood team maintains a number of tools that are related to the project, but not essential components of it.\r\nThese tools are kept in various other repos:\r\n\r\n* Performance Tests: Scripts for load testing a blueflood installation using [The\r\n  Grinder](http://grinder.sourceforge.net/). https://github.com/rackerlabs/raxmetrics-perf-test-scripts\r\n\r\n* Carbon Forwarder: a process that receives data from carbon (one of the components of\r\n  [Graphite](https://graphiteapp.org/)) and sends it to a Blueflood instance.\r\n  https://github.com/rackerlabs/blueflood-carbon-forwarder\r\n\r\n* Blueflood-Finder: a plugin for graphite-web and graphite-api that allows them to using a Blueflood instance as a data\r\n  backend. https://github.com/rackerlabs/blueflood-graphite-finder\r\n\r\n* StatsD plugin: a statsD backend that sends metrics a Blueflood instance.\r\n  https://github.com/rackerlabs/blueflood-statsd-backend\r\n\r\n## Contributing\r\n\r\nFirst, we welcome bug reports and contributions.\r\nIf you would like to contribute code, just fork this project and send us a pull request.\r\nIf you would like to contribute documentation, you should get familiar with\r\n[our wiki](https://github.com/rackerlabs/blueflood/wiki)\r\n\r\nAlso, we have set up a [Google Group](https://groups.google.com/forum/#!forum/blueflood-discuss) to answer questions.\r\n\r\n## License\r\n\r\nCopyright 2013-2017 Rackspace\r\n\r\nLicensed 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\r\n\r\n   http://www.apache.org/licenses/LICENSE-2.0 \r\n\r\nUnless 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.\r\n","funding_links":[],"categories":["Databases","Time-Series Databases","Java"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frackerlabs%2Fblueflood","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frackerlabs%2Fblueflood","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frackerlabs%2Fblueflood/lists"}