Go to file
Jason Wilder c356ff6483 Return fmt.Errorf() 2015-04-06 16:29:00 -06:00
.hooks
admin Fix all lint errors in "admin" and "collectd" packages. 2015-04-01 03:37:31 +02:00
client server: rename influxdb.Results type to influxdb.Response (issue: #2050) 2015-04-04 12:17:33 +03:00
cmd Return fmt.Errorf() 2015-04-06 16:29:00 -06:00
collectd Fix all lint errors in "admin" and "collectd" packages. 2015-04-01 03:37:31 +02:00
etc OpenTSDB server interface 2015-04-05 10:29:49 +01:00
graphite Fix swallowed error 2015-04-02 19:01:19 -07:00
httpd server: rename influxdb.Results type to influxdb.Response (issue: #2050) 2015-04-04 12:17:33 +03:00
influxql Combine values across mappers before emit 2015-04-02 16:00:52 -07:00
messaging Merge branch 'master' of https://github.com/influxdb/influxdb into broker-recovery 2015-04-04 08:09:06 -06:00
opentsdb OpenTSDB server interface 2015-04-05 10:29:49 +01:00
raft Return term from vote, add term logging. 2015-04-04 10:59:50 -06:00
scripts Update init script to append STDERR to log. 2015-04-03 14:27:27 -06:00
shared/admin
statik
test Track data node urls on brokers 2015-04-02 11:27:53 -06:00
tests Add script to show how to query for future data 2015-04-03 10:33:40 -05:00
udp
uuid Replace code.google.com/p/go-uuid with TimeUUID from gocql 2015-03-30 09:02:11 -07:00
.gitignore Ignore the 'influx' shell binary 2015-03-23 14:29:41 -07:00
CHANGELOG.md Minor tweak to changelog for OpenTSDB support 2015-04-06 11:24:39 -07:00
CONTRIBUTING.md
LICENSE
QUERIES.md
README.md Don't split database-create doc command into 2 lines 2015-03-23 14:33:54 -07:00
broker.go
broker_test.go
circle.yml Re-run test suite with -race 2015-03-30 11:35:24 -07:00
commands.go minor style change 2015-03-31 23:49:54 -04:00
continuous_queries.md
database.go Don't panic if presented with a field of unknown type 2015-04-04 10:33:56 -07:00
diagnostics.go Saner names for diags and stats, and use tags 2015-03-26 16:27:13 -07:00
influxdb.go Don't panic if presented with a field of unknown type 2015-04-04 10:33:56 -07:00
influxdb_test.go
internal_test.go Optimize marshalTags(). 2015-03-31 16:55:42 -06:00
metastore.go Ignore replayed commands on the metastore. 2015-04-02 14:43:25 -06:00
package.sh Fix up paths for run and data 2015-04-03 12:52:37 -07:00
server.go Don't panic if presented with a field of unknown type 2015-04-04 10:33:56 -07:00
server_test.go server: rename influxdb.Results type to influxdb.Response (issue: #2050) 2015-04-04 12:17:33 +03:00
shard.go Synchronize access to shard index 2015-03-30 13:50:17 -07:00
snapshot.go Add incremental backups. 2015-03-24 15:57:03 -06:00
snapshot_test.go Add incremental backups. 2015-03-24 15:57:03 -06:00
stats.go
stats_test.go
tx.go Don't panic if presented with a field of unknown type 2015-04-04 10:33:56 -07:00

README.md

InfluxDB Circle CI

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] (http://influxdb.com/docs/v0.9/concepts/reading_and_writing_data.html) 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

The following directions apply only to the 0.9.0 release or building from the source on master.

Building

You don't need to build the project to use it - you can use any of our pre-built packages 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.

Starting InfluxDB

  • service influxdb start if you have installed InfluxDB using an official Debian or RPM package.
  • $GOPATH/bin/influxd if you have built InfluxDB from source.

Creating your first database

curl -G 'http://localhost:8086/query' --data-urlencode "q=CREATE DATABASE mydb"

Insert some data

curl -H "Content-Type: application/json" http://localhost:8086/write -d '
{
    "database": "mydb",
    "retentionPolicy": "default",
    "points": [
        {
            "timestamp": "2014-11-10T23:00:00Z",
            "name": "cpu",
             "tags": {
                 "region":"uswest",
                 "host": "server01"
            },
             "fields":{
                 "value": 100
            }
         }
      ]
}'

Query for the data

curl -G http://localhost:8086/query?pretty=true \
--data-urlencode "db=mydb" --data-urlencode "q=SELECT * FROM cpu"