Go to file
Stuart Carnie d165d76fc3
feat: influx CLI Packager support for explicit schema buckets (#21465)
This commit adds the minimal requirements to process specs containing
explicit schema buckets, so they may be exported and applied from
Cloud 2.
2021-05-31 10:01:29 +10:00
.circleci build: static image for e2e tests (#21506) 2021-05-19 11:02:07 -04:00
.github feat(http): allow for disabling pprof (#20827) 2021-03-04 09:28:03 -05:00
authorization refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
authorizer chore: move notebook service interface to root (#21570) 2021-05-26 12:27:56 -04:00
backup refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
bolt refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
checks refactor: refactor for tasks backport (#21117) 2021-04-07 14:42:55 -04:00
chronograf feat: add StaticLegend (#21218) 2021-04-15 15:06:01 -07:00
cmd feat: influx CLI Packager support for explicit schema buckets (#21465) 2021-05-31 10:01:29 +10:00
context refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
dashboards feat: add legendHide for the tooltip (#21547) 2021-05-25 10:31:50 -07:00
dbrp refactor: refactor for tasks backport (#21117) 2021-04-07 14:42:55 -04:00
docker build: adjust emulator setup and ordering for Docker cross-build (#20503) 2021-01-12 10:41:13 -08:00
docs build: remove npm replace with yarn (#14176) 2019-06-21 16:19:42 -07:00
etc fix(fluxtest): fix load storage to read/write the bucket correctly (#21058) 2021-03-26 15:58:04 -05:00
flux refactor: rewrite imports to include the /v2 suffix for version 2 2020-04-03 12:39:20 -05:00
fluxinit refactor: replace builtin package with fluxinit/static (#3304) (#19909) 2020-11-05 16:54:28 -08:00
gather refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
http build(flux): update flux to v0.117.0 (#21539) 2021-05-24 12:29:28 -07:00
influxql refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
inmem refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
internal fix(influxql): make meta queries respect query timeout (#21545) 2021-05-24 21:10:53 -04:00
jsonweb refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
kit feat(notebooks): notebooks database implementation (#21573) 2021-05-28 09:29:00 -04:00
kv refactor: refactor for tasks backport (#21117) 2021-04-07 14:42:55 -04:00
label refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
logger test: replace influxlogger with zaptest logger (#20589) 2021-02-11 10:12:39 -05:00
mock chore: move notebook service interface to root (#21570) 2021-05-26 12:27:56 -04:00
models feat: influx CLI Packager support for explicit schema buckets (#21465) 2021-05-31 10:01:29 +10:00
nats fix: add logging to NATS streaming server (#21375) 2021-05-05 14:25:39 -04:00
notebooks feat(notebooks): notebooks database implementation (#21573) 2021-05-28 09:29:00 -04:00
notification refactor: refactor for tasks backport (#21117) 2021-04-07 14:42:55 -04:00
pkg build: delete vendored copy of gogo protos (#21098) 2021-03-30 14:26:05 -04:00
pkger feat: influx CLI Packager support for explicit schema buckets (#21465) 2021-05-31 10:01:29 +10:00
pprof refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
predicate refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
prometheus refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
query feat(storage/flux): support table.fill() within aggregate window pushdown (#21519) 2021-05-19 20:22:56 -05:00
rand refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
resource refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
restore fix(cmd/influx): accept `--input` flag in `restore` command (#21477) 2021-05-14 15:07:58 -04:00
scripts chore: remove dead source code from UI folder (#21446) 2021-05-11 10:11:07 -04:00
secret refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
session feat: notebooks HTTP handlers (#21316) 2021-04-28 11:06:13 -04:00
snowflake refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
source refactor(kv): delete deprecated kv service code 2020-11-16 12:41:26 +00:00
sqlite feat(notebooks): notebooks database implementation (#21573) 2021-05-28 09:29:00 -04:00
storage fix(influxql): make meta queries respect query timeout (#21545) 2021-05-24 21:10:53 -04:00
task refactor: refactor for tasks backport (#21117) 2021-04-07 14:42:55 -04:00
telegraf refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
telemetry chore: add goimports 2021-01-29 14:06:52 -05:00
tenant feat(notebooks): authorization for notebooks (#21490) 2021-05-17 19:01:27 -04:00
testing feat(users): list users via the API now supports `offset`, `limit` or `after` parameter (#21367) 2021-05-12 14:09:52 +02:00
tests refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
toml fix: correct various typos (#19987) 2020-11-11 13:54:21 -05:00
tools/tmpl refactor: modify tooling to take advantage of go run 2018-10-15 11:01:27 -05:00
tsdb fix(influxql): make meta queries respect query timeout (#21545) 2021-05-24 21:10:53 -04:00
ui chore: remove dead source code from UI folder (#21446) 2021-05-11 10:11:07 -04:00
uuid chore: rename imports from platform to influxdb 2019-01-09 20:51:47 -08:00
v1 fix(influxql): make meta queries respect query timeout (#21545) 2021-05-24 21:10:53 -04:00
vault refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
write refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
zap refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
.editorconfig chore(editorconfig): revert editorconfig changes, too much work 2020-06-25 18:16:57 +01:00
.gitignore fix(tls): Update TLS strict cipher suite to actually work (#20921) 2021-03-16 10:45:27 -04:00
.goreleaser.yml build: add windows to cross-build (#21109) 2021-03-31 18:52:20 -04:00
CHANGELOG.md feat: add legendHide for the tooltip (#21547) 2021-05-25 10:31:50 -07:00
CONTRIBUTING.md chore: remove dead source code from UI folder (#21446) 2021-05-11 10:11:07 -04:00
Dockerfile fix: switch port to 8086 2020-09-03 14:40:29 -07:00
FUZZ.md docs: Update FUZZ.md 2020-10-26 10:43:21 -07:00
LICENSE Initial commit 2018-05-09 09:17:31 -07:00
Makefile chore: remove dead source code from UI folder (#21446) 2021-05-11 10:11:07 -04:00
README.md chore: remove dead source code from UI folder (#21446) 2021-05-11 10:11:07 -04:00
SECURITY.md chore: Update table of supported security updates 2020-09-28 15:19:25 -07:00
api-compat.Jenkinsfile chore(Jenkins): Update Golang build container to 1.12 2019-04-12 15:51:21 -04:00
appveyor.yml fix(tasks): Add a log message for run transition clairity (#14321) 2019-07-12 10:10:11 -06:00
auth.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
authz.go feat(notebooks): authorization for notebooks (#21490) 2021-05-17 19:01:27 -04:00
authz_test.go feat(notebooks): authorization for notebooks (#21490) 2021-05-17 19:01:27 -04:00
backup.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
bucket.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
build.go feat(influxdb): Add global BuildInfo 2019-03-14 09:23:53 -07:00
check.go refactor: refactor for tasks backport (#21117) 2021-04-07 14:42:55 -04:00
credentials.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
crud_log.go chore(inmem): nuke the duplicative inmem store 2019-12-30 11:04:45 -08:00
dashboard.go feat: add legendHide for the tooltip (#21547) 2021-05-25 10:31:50 -07:00
dashboard_test.go feat: add legendHide for the tooltip (#21547) 2021-05-25 10:31:50 -07:00
dbrp_mapping.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
dbrp_mapping_internal_test.go chore: rename imports from platform to influxdb 2019-01-09 20:51:47 -08:00
dbrp_mapping_test.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
delete.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
document.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
duration.go refactor(tasks): use go Time for Task CreatedAt, UpdatedAt, LatestCompleted, Offset (#15672) 2019-11-12 17:13:56 -08:00
env feat: add support for pkg-config (#17036) 2020-02-28 11:08:21 -06:00
flags.yml chore: adding rangeAnnotations feature flag (#21556) 2021-05-25 15:25:05 -04:00
go.mod feat(notebooks): notebooks database implementation (#21573) 2021-05-28 09:29:00 -04:00
go.sum feat(notebooks): notebooks database implementation (#21573) 2021-05-28 09:29:00 -04:00
keyvalue_log.go feat(kv): implemented key/value store with end-to-end integration tests 2019-02-19 17:47:19 -06:00
label.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
label_test.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
lookup.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
measurement.go chore: rename imports from platform to influxdb 2019-01-09 20:51:47 -08:00
measurement_schema.go feat: influx CLI Packager support for explicit schema buckets (#21465) 2021-05-31 10:01:29 +10:00
measurement_schema_errors.go feat: influx CLI Packager support for explicit schema buckets (#21465) 2021-05-31 10:01:29 +10:00
measurement_schema_test.go feat: influx CLI Packager support for explicit schema buckets (#21465) 2021-05-31 10:01:29 +10:00
notebook.go feat(notebooks): notebooks database implementation (#21573) 2021-05-28 09:29:00 -04:00
notebook_test.go chore: move notebook service interface to root (#21570) 2021-05-26 12:27:56 -04:00
notification.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
notification_endpoint.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
onboarding.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
operation_log.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
organization.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
paging.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
passwords.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
scraper.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
secret.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
secret_test.go feat(notification/endpoint): add endpoint struct 2019-08-15 21:56:17 -04:00
semaphore.go refactor: simpify Semaphore interface 2019-10-23 19:49:48 +01:00
session.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
source.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
status.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
tag.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
tag_test.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
telegraf.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
telegraf_test.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
tenant.go test: add tests for tenant service 2020-03-19 11:34:15 +01:00
token.go chore: rename imports from platform to influxdb 2019-01-09 20:51:47 -08:00
tools.go build(flux): update flux to v0.117.0 (#21539) 2021-05-24 12:29:28 -07:00
usage.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
user.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
user_resource_mapping.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
user_resource_mapping_test.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
variable.go refactor: automated move of errors and id from root to kit (#21101) 2021-03-30 14:10:02 -04:00
variable_test.go refactor: rewrite imports to include the /v2 suffix for version 2 2020-04-03 12:39:20 -05:00
write.go fix(http): fix passing of bucket ID by write-handler client (#20679) 2021-02-02 17:34:40 -05:00

README.md

InfluxDB CircleCI

Slack Status

InfluxDB is an open source time series platform. This includes APIs for storing and querying data, processing it in the background for ETL or monitoring and alerting purposes, user dashboards, and visualizing and exploring the data and more. The master branch on this repo now represents the latest InfluxDB, which now includes functionality for Kapacitor (background processing) and Chronograf (the UI) all in a single binary.

The list of InfluxDB Client Libraries that are compatible with the latest version can be found in our documentation.

If you are looking for the 1.x line of releases, there are branches for each minor version as well as a master-1.x branch that will contain the code for the next 1.x release. The master-1.x working branch is here. The InfluxDB 1.x Go Client can be found here.

Installing

We have nightly and versioned Docker images, Debian packages, RPM packages, and tarballs of InfluxDB available at the InfluxData downloads page. We also provide the influx command line interface (CLI) client as a separate binary available at the same location.

If you are interested in building from source, see the building from source guide for contributors.

Getting Started

For a complete getting started guide, please see our full online documentation site.

To write and query data or use the API in any way, you'll need to first create a user, credentials, organization and bucket. Everything in InfluxDB is organized under a concept of an organization. The API is designed to be multi-tenant. Buckets represent where you store time series data. They're synonymous with what was previously in InfluxDB 1.x a database and retention policy.

The simplest way to get set up is to point your browser to http://localhost:8086 and go through the prompts.

You can also get set up from the CLI using the command influx setup:

$ bin/$(uname -s | tr '[:upper:]' '[:lower:]')/influx setup
Welcome to InfluxDB 2.0!
Please type your primary username: marty

Please type your password: 

Please type your password again: 

Please type your primary organization name.: InfluxData

Please type your primary bucket name.: telegraf

Please type your retention period in hours.
Or press ENTER for infinite.: 72


You have entered:
  Username:          marty
  Organization:      InfluxData
  Bucket:            telegraf
  Retention Period:  72 hrs
Confirm? (y/n): y

UserID                  Username        Organization    Bucket
033a3f2c5ccaa000        marty           InfluxData      Telegraf
Your token has been stored in /Users/marty/.influxdbv2/credentials

You can run this command non-interactively using the -f, --force flag if you are automating the setup. Some added flags can help:

$ bin/$(uname -s | tr '[:upper:]' '[:lower:]')/influx setup \
--username marty \
--password F1uxKapacit0r85 \
--org InfluxData \
--bucket telegraf \
--retention 168 \
--token where-were-going-we-dont-need-roads \
--force

Once setup is complete, a configuration profile is created to allow you to interact with your local InfluxDB without passing in credentials each time. You can list and manage those profiles using the influx config command.

$ bin/$(uname -s | tr '[:upper:]' '[:lower:]')/influx config
Active	Name	URL			            Org
*	    default	http://localhost:8086	InfluxData

Writing Data

Write to measurement m, with tag v=2, in bucket telegraf, which belongs to organization InfluxData:

$ bin/$(uname -s | tr '[:upper:]' '[:lower:]')/influx write --bucket telegraf --precision s "m v=2 $(date +%s)"

Since you have a default profile set up, you can omit the Organization and Token from the command.

Write the same point using curl:

curl --header "Authorization: Token $(bin/$(uname -s | tr '[:upper:]' '[:lower:]')/influx auth list --json | jq -r '.[0].token')" \
--data-raw "m v=2 $(date +%s)" \
"http://localhost:8086/api/v2/write?org=InfluxData&bucket=telegraf&precision=s"

Read that back with a simple Flux query:

$ bin/$(uname -s | tr '[:upper:]' '[:lower:]')/influx query 'from(bucket:"telegraf") |> range(start:-1h)'
Result: _result
Table: keys: [_start, _stop, _field, _measurement]
                   _start:time                      _stop:time           _field:string     _measurement:string                      _time:time                  _value:float
------------------------------  ------------------------------  ----------------------  ----------------------  ------------------------------  ----------------------------
2019-12-30T22:19:39.043918000Z  2019-12-30T23:19:39.043918000Z                       v                       m  2019-12-30T23:17:02.000000000Z                             2

Use the -r, --raw option to return the raw flux response from the query. This is useful for moving data from one instance to another as the influx write command can accept the Flux response using the --format csv option.

Introducing Flux

Flux is an MIT-licensed data scripting language (previously named IFQL) used for querying time series data from InfluxDB. The source for Flux is available on GitHub. Learn more about Flux from CTO Paul Dix's presentation.

Contributing to the Project

InfluxDB is an MIT licensed open source project and we love our community. The fastest way to get something fixed is to open a PR. Check out our contributing guide if you're interested in helping out. Also, join us on our Community Slack Workspace if you have questions or comments for our engineering teams.

CI and Static Analysis

CI

All pull requests will run through CI, which is currently hosted by Circle. Community contributors should be able to see the outcome of this process by looking at the checks on their PR. Please fix any issues to ensure a prompt review from members of the team.

The InfluxDB project is used internally in a number of proprietary InfluxData products, and as such, PRs and changes need to be tested internally. This can take some time, and is not really visible to community contributors.

Static Analysis

This project uses the following static analysis tools. Failure during the running of any of these tools results in a failed build. Generally, code must be adjusted to satisfy these tools, though there are exceptions.

  • go vet checks for Go code that should be considered incorrect.
  • go fmt checks that Go code is correctly formatted.
  • go mod tidy ensures that the source code and go.mod agree.
  • staticcheck checks for things like: unused code, code that can be simplified, code that is incorrect and code that will have performance issues.

staticcheck

If your PR fails staticcheck it is easy to dig into why it failed, and also to fix the problem. First, take a look at the error message in Circle under the staticcheck build section, e.g.,

tsdb/tsm1/encoding.gen.go:1445:24: func BooleanValues.assertOrdered is unused (U1000)
tsdb/tsm1/encoding.go:172:7: receiver name should not be an underscore, omit the name if it is unused (ST1006)

Next, go and take a look here for some clarification on the error code that you have received, e.g., U1000. The docs will tell you what's wrong, and often what you need to do to fix the issue.

Generated Code

Sometimes generated code will contain unused code or occasionally that will fail a different check. staticcheck allows for entire files to be ignored, though it's not ideal. A linter directive, in the form of a comment, must be placed within the generated file. This is problematic because it will be erased if the file is re-generated. Until a better solution comes about, below is the list of generated files that need an ignores comment. If you re-generate a file and find that staticcheck has failed, please see this list below for what you need to put back:

File Comment
query/promql/promql.go //lint:file-ignore SA6001 Ignore all unused code, it's generated

End-to-End Tests

CI also runs end-to-end tests. These test the integration between the influxd server the UI. Since the UI is used by interal repositories as well as the influxdb repository, the end-to-end tests cannot be run on forked pull requests or run locally. The extent of end-to-end testing required for forked pull requests will be determined as part of the review process.