influxdb

README

InfluxDB

InfluxDB is an open source distributed time series database with no external dependencies. It's useful for recording metrics, events, and performing analytics.

It has a built-in HTTP API so you don't have to write any server side code to get up and running.

InfluxDB is designed to be scalable, simple to install and manage, and fast to get data in and out.

It aims to answer queries in real-time. That means every data point is indexed as it comes in and is immediately available in queries that should return in < 100ms.

Quickstart

• Understand the design goals and motivations of the project.
• Follow the getting started guide to find out how to install InfluxDB, start writing data, and issue queries - in just a few minutes.
• See the list of libraries for different languages, or check out the HTTP API documentation to start writing a library for your favorite language.

Building

You don't need to build the project to use it. Pre-built binaries and instructions to install InfluxDB are here. That's the recommended way to get it running. However, if you want to contribute to the core of InfluxDB, you'll need to build. For those adventurous enough follow the instructions below.

Mac OS X

Installing via Homebrew

InfluxDB has an officially supported recipe included in Homebrew. To use it, just run:

brew install influxdb

Building from source

First, install the build dependencies of the project (via Homebrew):

brew install protobuf bison flex leveldb go hg bzr

Then run ./test.sh. This will build the server and run the tests.

Note: If you are on Mac OS X Mavericks, you might want to try to install go using brew install go --devel

Linux

• You need to get Go from Google Code.
• Ensure go is on your PATH.
• If you're on a Red Hat-based distro:

sudo yum install hg bzr protobuf-compiler flex bison valgrind

• If you're on a Debian-based distro:

sudo apt-get install mercurial bzr protobuf-compiler flex bison valgrind

• Run ./test.sh. This will build the server and run the tests.