Go to file
Jonathan A. Sternberg b4db76cee2 Introduce syntax for marking a partial response with chunking
The `partial` tag has been added to the JSON response of a series and
the result so that a client knows when more of the series or result will
be sent in a future JSON chunk.

This helps interactive clients who don't want to wait for all of the
data to know if it is done processing the current series or the current
result. Previously, the client had to guess if the next chunk would
refer to the same result or a new result and it had to match the name
and tags of the two series to know if they were the same series. Now,
the client just needs to check the `partial` field included with the
response to know if it should expect more.

Fixed `max-row-limit` so it counts rows instead of results and it
truncates the response when the `max-row-limit` is reached.
2016-11-22 11:16:22 -06:00
.github Add heap profile to issue template 2016-07-26 09:54:46 -06:00
.hooks Fix incorrect composites check setting 2016-05-18 14:02:48 +01:00
client Merge tag 'v1.0.1' 2016-09-27 17:53:33 -05:00
cmd Introduce syntax for marking a partial response with chunking 2016-11-22 11:16:22 -06:00
coordinator Introduce syntax for marking a partial response with chunking 2016-11-22 11:16:22 -06:00
etc Add support for collectd security policy 2016-11-08 08:42:09 +08:00
importer add example data to importer README.md 2016-07-19 13:01:26 -04:00
influxql Introduce syntax for marking a partial response with chunking 2016-11-22 11:16:22 -06:00
internal remove SetDefaultRetentionPolicy method from meta.Client 2016-11-03 09:39:41 -05:00
man Merge pull request #7492 from influxdata/mr-influx_inspect-help-verify 2016-11-07 13:23:39 -08:00
models Introduce syntax for marking a partial response with chunking 2016-11-22 11:16:22 -06:00
monitor Merge tag 'v1.0.1' 2016-09-27 17:53:33 -05:00
pkg models: Add FieldIterator type 2016-10-03 16:30:21 -06:00
scripts fix chuid argument order 2016-11-10 16:31:50 -06:00
services Introduce syntax for marking a partial response with chunking 2016-11-22 11:16:22 -06:00
stress Update README.md 2016-09-15 15:49:29 -07:00
tcp Add DefaultListener to tcp.Mux 2016-05-18 17:57:26 -04:00
tests rename influxdb/influxdb to influxdata/influxdb 2016-02-10 10:26:18 -07:00
toml Rename cluster package to coordinator 2016-05-11 11:41:05 -06:00
tsdb Switch all Value types from pointers 2016-11-15 16:13:55 -07:00
uuid add canonical paths 2016-02-10 11:30:52 -07:00
.dockerignore decouple circleci from tests using docker 2015-12-14 16:39:39 -07:00
.gitattributes Attempt to use union merge strategy on CHANGELOG 2016-04-22 18:18:20 +01:00
.gitignore Add note to use global .gitignore 2016-10-17 08:33:13 -07:00
.mention-bot Filtering some authors from mention bot 2016-05-11 17:43:52 +01:00
CHANGELOG.md Introduce syntax for marking a partial response with chunking 2016-11-22 11:16:22 -06:00
CODING_GUIDELINES.md Fixes typo in CODING_GUIDELINES.md 2016-02-02 17:20:13 +05:30
CONTRIBUTING.md Fix references to Go 1.6.2 in doc 2016-11-12 11:50:44 +08:00
DOCKER.md Use go1.7.3 2016-10-25 20:16:58 -06:00
Dockerfile Add instructions for building a minimal docker image 2015-08-07 14:27:33 -06:00
Dockerfile_build_ubuntu32 Use go1.7.3 2016-10-25 20:16:58 -06:00
Dockerfile_build_ubuntu64 Use go1.7.3 2016-10-25 20:16:58 -06:00
Dockerfile_build_ubuntu64_git Use go1.7.3 2016-10-25 20:16:58 -06:00
Dockerfile_test_ubuntu32 Use DEBIAN_FRONTEND=noninteractive when using apt-get in Dockerfiles 2016-02-18 21:58:14 -05:00
Godeps Replace kimor79/gollectd with collectd.org 2016-11-08 08:24:57 +08:00
LICENSE Update year to 2016 in LICENSE 2016-01-16 13:09:14 +05:30
LICENSE_OF_DEPENDENCIES.md Replace kimor79/gollectd with collectd.org 2016-11-08 08:24:57 +08:00
Makefile Update toml dependency for slice panic when reading the config 2016-02-23 08:45:01 -05:00
QUERIES.md Update QUERIES.md 2015-10-27 23:02:18 -07:00
README.md Add docker pull badge to the README 2016-05-15 22:05:17 -04:00
TODO.md Add TODO to change time boundaries for v2 2016-08-15 16:21:20 -05:00
appveyor.yml Use built-in Go 1.7 in Appveyor 2016-09-29 10:07:29 -07:00
build-docker.sh Use go1.7.3 2016-10-25 20:16:58 -06:00
build.py Fix ARM64 build by replacing "aarch64" string with "arm64" 2016-11-03 22:23:43 +00:00
build.sh rename influxdb/influxdb to influxdata/influxdb 2016-02-10 10:26:18 -07:00
circle-test.sh add docker rm flag so circleci can disable deletion of containers 2016-02-02 15:18:58 -07:00
circle.yml Use go1.7.3 2016-10-25 20:16:58 -06:00
errors.go Ensure ErrFieldTypeConflict value returned 2016-09-05 13:34:35 +01:00
gobuild.sh make tip container usable for any git revision, add go1.6beta1 test 2015-12-16 15:28:35 -07:00
influxdb.go add canonical paths 2016-02-10 11:30:52 -07:00
nightly.sh Update packaing and build for new github org 2016-01-04 15:47:04 -08:00
node.go Remove MetaServers from node.json 2016-02-15 22:42:51 -07:00
package.sh Use go1.4.3 2016-01-10 16:43:31 -07:00
test.sh Update circle.yml to automate release upload on version tag. 2016-07-14 14:32:53 -05:00

README.md

InfluxDB Circle CI Go Report Card Docker pulls

An Open-Source Time Series Database

InfluxDB is an open source 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.
  • Data can be tagged, allowing very flexible querying.
  • SQL-like query language.
  • 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.

Installation

We recommend installing InfluxDB using one of the pre-built packages. Then start InfluxDB using:

  • service influxdb start if you have installed InfluxDB using an official Debian or RPM package.
  • systemctl start influxdb if you have installed InfluxDB using an official Debian or RPM package, and are running a distro with systemd. For example, Ubuntu 15 or later.
  • $GOPATH/bin/influxd if you have built InfluxDB from source.

Getting Started

Create your first database

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

Insert some data

curl -XPOST 'http://localhost:8086/write?db=mydb' \
-d 'cpu,host=server01,region=uswest load=42 1434055562000000000'

curl -XPOST 'http://localhost:8086/write?db=mydb' \
-d 'cpu,host=server02,region=uswest load=78 1434055562000000000'

curl -XPOST 'http://localhost:8086/write?db=mydb' \
-d 'cpu,host=server03,region=useast load=15.4 1434055562000000000'

Query for the data

curl -G http://localhost:8086/query?pretty=true --data-urlencode "db=mydb" \
--data-urlencode "q=SELECT * FROM cpu WHERE host='server01' AND time < now() - 1d"

Analyze the data

curl -G http://localhost:8086/query?pretty=true --data-urlencode "db=mydb" \
--data-urlencode "q=SELECT mean(load) FROM cpu WHERE region='uswest'"

Documentation

Contributing

If you're feeling adventurous and want to contribute to InfluxDB, see our contributing doc for info on how to make feature requests, build from source, and run tests.

Looking for Support?

InfluxDB offers a number of services to help your project succeed. We offer Developer Support for organizations in active development, Managed Hosting to make it easy to move into production, and Enterprise Support for companies requiring the best response times, SLAs, and technical fixes. Visit our support page or contact sales@influxdb.com to learn how we can best help you succeed.