Skip to content
A home for InfluxDB’s 2.x's golang client.
Go
Branch: develop
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci refactor(writers): move buffered writing and periodic batching into w… Aug 5, 2019
generated check go fmt on ci Jul 19, 2019
internal check go fmt on ci Jul 19, 2019
writer refactor(writers): move buffered writing and periodic batching into w… Aug 5, 2019
LICENSE chore: add MIT License May 30, 2019
README.md chore(client): refactor New Client function (#19) Jun 24, 2019
client.go refactor(writers): move buffered writing and periodic batching into w… Aug 5, 2019
client_test.go chore(client): refactor New Client function (#19) Jun 24, 2019
clientoptions.go chore(client): refactor New Client function (#19) Jun 24, 2019
e2e_test.go refactor(writers): move buffered writing and periodic batching into w… Aug 5, 2019
errors.go refactor(writers): move buffered writing and periodic batching into w… Aug 5, 2019
examples_test.go refactor(writers): move buffered writing and periodic batching into w… Aug 5, 2019
go.mod refactor(writers): move buffered writing and periodic batching into w… Aug 5, 2019
go.sum refactor(writers): move buffered writing and periodic batching into w… Aug 5, 2019
http.go Initial client work (#1) Apr 23, 2019
models.go Initial client work (#1) Apr 23, 2019
models_test.go Initial client work (#1) Apr 23, 2019
query.go doc: Fix code block for QueryCSVResult.Next() Jul 23, 2019
query_test.go feat: Query Marshaling (#17) Jun 12, 2019
setup.go chore(client): refactor New Client function (#19) Jun 24, 2019
useragent.go Initial client work (#1) Apr 23, 2019
write.go refactor(writers): move buffered writing and periodic batching into w… Aug 5, 2019

README.md

influxdb-client-go

A home for InfluxDB’s 2.x's golang client. This client is not compatible with InfluxDB 1.x--if you are looking for the 1.x golang client you can find it here.

Example:

	influx, err := influxdb.New(myHTTPInfluxAddress, myToken, influxdb.WithHTTPClient(myHTTPClient))
	if err != nil {
		panic(err) // error handling here; normally we wouldn't use fmt but it works for the example
	}

	// we use client.NewRowMetric for the example because it's easy, but if you need extra performance
	// it is fine to manually build the []client.Metric{}.
	myMetrics := []influxdb.Metric{
		influxdb.NewRowMetric(
			map[string]interface{}{"memory": 1000, "cpu": 0.93},
			"system-metrics",
			map[string]string{"hostname": "hal9000"},
			time.Date(2018, 3, 4, 5, 6, 7, 8, time.UTC)),
		influxdb.NewRowMetric(
			map[string]interface{}{"memory": 1000, "cpu": 0.93},
			"system-metrics",
			map[string]string{"hostname": "hal9000"},
			time.Date(2018, 3, 4, 5, 6, 7, 9, time.UTC)),
	}

	// The actual write..., this method can be called concurrently.
	if err := influx.Write(context.Background(), "my-awesome-bucket", "my-very-awesome-org", myMetrics...); err != nil {
		log.Fatal(err) // as above use your own error handling here.
	}
	influx.Close() // closes the client.  After this the client is useless.

Releases

We will be using git-flow style releases, the current stable release will be listed in the master readme.

Requirements

influxdb-client-go requires go version 1.12 or newer to build.

You can’t perform that action at this time.