Go to file
Jonathan A. Sternberg 17ca220f33 Enable the storage service by default 2018-06-13 10:56:50 -05:00
.circleci update CircleCI config to 2.0 syntax (#9711) 2018-04-16 12:00:44 -07:00
.github
.hooks Fix data race in WAL 2018-03-15 12:51:30 +00:00
client Merge pull request #9753 from influxdata/js-client-rp-parameter 2018-05-04 16:24:20 -05:00
cmd refactor(services/storage): Enhanced group support for Read RPC 2018-05-30 11:32:20 -07:00
coordinator Implement SHOW STATS FOR 'indexes' 2018-05-10 11:33:52 -07:00
docker
etc Add optional pprof http endpoint immediately on startup. 2018-05-23 14:32:15 -06:00
importer
internal
logger refactor(services/storage): Enhanced group support for Read RPC 2018-05-30 11:32:20 -07:00
man Fix the influx_inspect man page 2018-05-25 09:36:20 -05:00
models buildtsi: Do not escape measurement names 2018-05-30 15:20:56 -07:00
monitor
pkg fix(tsdb): attempt to work on docker on windows 2018-06-01 14:57:18 -06:00
prometheus
query Merge pull request #9853 from influxdata/js-fix-log2-function 2018-05-19 11:35:31 -05:00
releng Use dep for dependency management instead of gdm 2018-03-12 15:20:08 -05:00
scripts
services Enable the storage service by default 2018-06-13 10:56:50 -05:00
stress gofmt 2018-06-06 14:50:43 -06:00
tcp
tests Update backup flags to have long/short versions (#9713) 2018-04-25 10:49:46 -04:00
toml Allow customizing the unix socket group and permissions created by the server 2018-04-05 14:40:12 -05:00
tsdb Export Shard.Engine() 2018-06-04 13:25:03 -06:00
uuid
.dockerignore
.gitignore update CircleCI config to 2.0 syntax (#9711) 2018-04-16 12:00:44 -07:00
.mention-bot
CHANGELOG.md Enable the storage service by default 2018-06-13 10:56:50 -05:00
CODING_GUIDELINES.md
CONTRIBUTING.md update CircleCI config to 2.0 syntax (#9711) 2018-04-16 12:00:44 -07:00
Dockerfile Use dep for dependency management instead of gdm 2018-03-12 15:20:08 -05:00
Dockerfile_build_ubuntu32
Dockerfile_build_ubuntu64
Dockerfile_build_ubuntu64_git
Dockerfile_build_ubuntu64_go19
Dockerfile_jenkins_ubuntu32
Dockerfile_test_ubuntu32
Godeps Update the interface for the simplified call valuer 2018-03-31 00:21:36 -05:00
Gopkg.lock Enable the storage service by default 2018-06-13 10:56:50 -05:00
Gopkg.toml Update the interface for the simplified call valuer 2018-03-31 00:21:36 -05:00
Jenkinsfile Use dep for dependency management instead of gdm 2018-03-12 15:20:08 -05:00
LICENSE
LICENSE_OF_DEPENDENCIES.md
QUERIES.md
README.md
TODO.md
appveyor.yml Use dep for dependency management instead of gdm 2018-03-12 15:20:08 -05:00
build.py Use dep for dependency management instead of gdm 2018-03-12 15:20:08 -05:00
build.sh
errors.go
gobuild.sh
influxdb.go
nightly.sh
node.go
test.sh
write-gdm-deps.sh Update dependencies and remove unnecessary constraints from Gopkg.toml 2018-03-19 11:12:49 -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 -XPOST "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.