Go to file
davidby-influx 0ae0bd6e2e
fix: replace unprintable and invalid characters in errors (#23387)
Replace unprintable and invalid characters with '?'
in logged errors.  Truncate consecutive runs of them to
only 3 repeats of '?'

closes https://github.com/influxdata/influxdb/issues/23386
2022-06-01 13:45:24 -07:00
.circleci build: update changelogger to ignore case when parsing verbs (#23368) 2022-05-24 16:07:57 -04:00
.github chore: backport semantic PR and commit message checks (#23306) 2022-04-27 11:09:06 -04:00
.hooks chore: add goimports to ci checks 2021-01-29 11:39:42 -05:00
_tools/tmpl build: upgrade to go1.18 (#23250) 2022-03-31 16:17:57 -05:00
client build: upgrade to go1.18 (#23250) 2022-03-31 16:17:57 -05:00
cmd feat: estimate Cloud2 cardinality on 1.X databases (#23351) 2022-05-26 11:27:17 -07:00
coordinator feat: optionally dump queries to log on SIGTERM (#22638) 2021-10-07 14:02:38 -07:00
docker Use multistage builds in a Dockerfile to compile and create an image from source 2017-10-27 10:28:14 -05:00
etc chore: fix typo in config.sample.toml (#21125) 2022-04-14 13:26:21 -05:00
flux chore: upgrade flux to v1.167.0 for 1.x (#23349) 2022-05-17 15:59:24 -04:00
importer Update README.md 2019-08-01 17:32:51 -07:00
internal chore: upgrade flux to v1.167.0 for 1.x (#23349) 2022-05-17 15:59:24 -04:00
kit build: upgrade to go1.18 (#23250) 2022-03-31 16:17:57 -05:00
logger feat: add memory and concurrency limits in flux controller (#21100) 2021-03-30 15:02:46 -04:00
man chore: update protobuf library versions and remove influx_tsm (#21882) 2021-07-20 09:42:52 -04:00
mock chore: upgrade flux to v1.167.0 for 1.x (#23349) 2022-05-17 15:59:24 -04:00
models build: upgrade to go1.18 (#23250) 2022-03-31 16:17:57 -05:00
monitor chore: increase more flaky test timeouts (#22725) 2021-10-21 14:08:09 -05:00
pkg build: upgrade to go1.18 (#23250) 2022-03-31 16:17:57 -05:00
prometheus build: upgrade protobuf library (#22606) 2021-10-15 11:42:47 -05:00
query chore: upgrade flux to v1.167.0 for 1.x (#23349) 2022-05-17 15:59:24 -04:00
releng build: allow circleci to build 1.x packages (#23104) 2022-02-07 12:15:05 -05:00
scripts chore: finalize changelog automation (#22770) 2021-10-27 08:35:32 -04:00
services feat: stub out bucket members, owners, and labels (#23294) 2022-04-25 11:42:01 -07:00
storage chore: upgrade flux to v1.167.0 for 1.x (#23349) 2022-05-17 15:59:24 -04:00
tcp build: upgrade to go1.18 (#23250) 2022-03-31 16:17:57 -05:00
tests build: upgrade to go1.18 (#23250) 2022-03-31 16:17:57 -05:00
toml build: upgrade to go1.18 (#23250) 2022-03-31 16:17:57 -05:00
tsdb fix: replace unprintable and invalid characters in errors (#23387) 2022-06-01 13:45:24 -07:00
uuid golint uuid package 2018-10-08 21:21:44 +01:00
.dockerignore decouple circleci from tests using docker 2015-12-14 16:39:39 -07:00
.gitignore chore: update protobuf library versions and remove influx_tsm (#21882) 2021-07-20 09:42:52 -04:00
.mention-bot Filtering some authors from mention bot 2016-05-11 17:43:52 +01:00
CHANGELOG.md build: automate changelog (#22522) 2021-09-21 08:30:50 -07:00
CODING_GUIDELINES.md chore: add goimports to ci checks 2021-01-29 11:39:42 -05:00
CONTRIBUTING.md build: upgrade protobuf library (#22606) 2021-10-15 11:42:47 -05:00
DEPENDENCIES.md chore: use community maintained golang-jwt (#21934) 2021-07-23 11:41:14 -05:00
Dockerfile chore: Upgrade to go1.15.10 and flux 0.108.1 (#21015) 2021-03-22 14:11:53 -04:00
LICENSE chore: Update copyright information 2018-12-05 14:49:56 -07:00
Makefile chore: Upgrade 1.x to the latest flux (#20767) 2021-03-03 16:24:49 -05:00
QUERIES.md Updated Queries.md 2017-10-25 09:05:52 +02:00
README.md fix(docs): Update docs to reflect tooling changes (#17798) 2020-04-20 17:49:19 +00:00
TODO.md Add TODO to change time boundaries for v2 2016-08-15 16:21:20 -05:00
appveyor.yml Bump Appveyor to Go 1.12 2019-07-15 11:29:31 -07:00
checkfmt.sh build: fix/add `go generate` calls for flux-related `.proto` files (#21103) 2021-03-30 17:14:15 -04:00
cliff.toml build: automate changelog (#22522) 2021-09-21 08:30:50 -07:00
errors.go Add authorization error behavior API 2017-05-26 13:21:59 -07:00
generate.sh build: upgrade protobuf library (#22606) 2021-10-15 11:42:47 -05:00
go.mod chore: update yaml.v3 to 3.0.1 (#23392) 2022-06-01 12:33:46 -05:00
go.sum chore: update yaml.v3 to 3.0.1 (#23392) 2022-06-01 12:33:46 -05:00
influxdb.go Update godoc for the client packages 2016-12-30 11:58:43 -08:00
nightly.sh Update packaing and build for new github org 2016-01-04 15:47:04 -08:00
node.go build: upgrade to go1.18 (#23250) 2022-03-31 16:17:57 -05:00
pkg-config.sh chore: Upgrade 1.x to the latest flux (#20767) 2021-03-03 16:24:49 -05:00
test-flux.sh chore: upgrade flux to v1.167.0 for 1.x (#23349) 2022-05-17 15:59:24 -04:00
tools.go build: upgrade to go1.18 (#23250) 2022-03-31 16:17:57 -05:00
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

ATTENTION:

Around January 11th, 2019, master on this repository will become InfluxDB 2.0 code. The content of infludata/platform will be moved to this repository. If you rely on master, you should update your dependencies to track the maxter-1.x branch.

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.

Licensing

See LICENSE and DEPENDENCIES.

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.