53 lines
2.3 KiB
Markdown
53 lines
2.3 KiB
Markdown
# InfluxDB [](https://travis-ci.org/influxdb/influxdb)
|
|
|
|
## An Open-Source, Distributed, Time Series Database
|
|
|
|
> InfluxDB v0.9.0 is now in the RC phase. If you're building a new project,
|
|
> please build against `master` or the most current RC instead of using v0.8.8.
|
|
|
|
InfluxDB is an open source **distributed time series database** with
|
|
**no external dependencies**. It's useful for recording metrics,
|
|
events, and performing analytics.
|
|
|
|
## Features
|
|
|
|
* Built-in HTTP API so you don't have to write any server side code to get up and running.
|
|
* Clustering is supported out of the box, so that you can scale horizontally to handle your data.
|
|
* 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.
|
|
|
|
## Getting Started
|
|
|
|
|
|
|
|
### Building
|
|
|
|
You don't need to build the project to use it - you can use any of our
|
|
[pre-built packages](http://influxdb.com/download/) to install InfluxDB. 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, you can
|
|
[follow along on our docs](http://github.com/influxdb/influxdb/blob/master/CONTRIBUTING.md).
|
|
|
|
### Creating your first database
|
|
|
|
```JSON
|
|
curl -XGET 'http://localhost:8086/query' --data-urlencode "q=CREATE DATABASE mydb"
|
|
```
|
|
### Setting up the database's retention policy
|
|
|
|
```JSON
|
|
curl -XGET 'http://localhost:8086/query' --data-urlencode "q=CREATE RETENTION POLICY mypolicy ON mydb REPLICATION 7d DEFAULT"
|
|
```
|
|
|
|
## Helpful Links
|
|
|
|
* Understand the [design goals and motivations of the project](http://influxdb.com/docs/v0.8/introduction/overview.html).
|
|
* Follow the [getting started guide](http://influxdb.com/docs/v0.8/introduction/getting_started.html) 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](http://influxdb.com/docs/v0.8/client_libraries/javascript.html),
|
|
or check out the
|
|
[HTTP API documentation to start writing a library for your favorite language](http://influxdb.com/docs/v0.8/api/reading_and_writing_data.html).
|
|
|