influxctl release notes

v2.9.8

Bug Fixes

Continue revoking tokens on error.
Reject unsupported input to --template-timeformat.
Remove unused client_secret option from connection configuration profiles.

Dependency Updates

Update Go to v1.23.2.
Update github.com/jedib0t/go-pretty/v6 from 6.5.9 to 6.6.0.
Update github.com/urfave/cli/v2 from 2.27.4 to 2.27.5.
Update google.golang.org/grpc from 1.66.0 to 1.67.1.
Update google.golang.org/protobuf from 1.34.2 to 1.35.1.

v2.9.7

Features

Add global --timeout flag.
Improve timezone support.

Bug Fixes

Use passthrough resolver for gRPC.

Dependency Updates

Update Go to 1.23.1.
Update github.com/pelletier/go-toml/v2 from 2.2.2 to 2.2.3.
Update golang.org/x/mod from 0.20.0 to 0.21.0.
Update golang.org/x/oauth2 from 0.22.0 to 0.23.0.
Update google.golang.org/grpc from 1.65.0 to 1.66.0.

v2.9.6

Bug Fixes

Update query to wait for EOF on stdin instead of the first newline.

v2.9.5

Bug Fixes

Introduce auth login and logout commands.
Attempt to refresh OAuth tokens when refresh token is present.

Dependency Updates

Update github.com/urfave/cli/v2 from 2.27.2 to 2.27.4
Update golang.org/x/mod from 0.19.0 to 0.20.0
Update golang.org/x/oauth2 from 0.21.0 to 0.22.0

v2.9.4

Bug Fixes

Resolve crash when parsing error message and authentication was null.

Dependency Updates

Update golang.org/x/mod from 0.18.0 to 0.19.0
Update google.golang.org/grpc from 1.64.0 to 1.65.0

v2.9.3

Bug Fixes

Update query subcommand to safely handle null timestamp in response.

v2.9.2

Bug Fixes

Ensure query subcommand returns any error while looping through results.

Dependency Updates

Update google.golang.org/protobuf from 1.34.1 to 1.34.2.

v2.9.1

Dependency Updates

Update Go from 1.22.2 to 1.22.4
Update github.com/apache/arrow/go/v16 from 16.0.0 to 16.1.0
Update github.com/fatih/color from 1.16.0 to 1.17.0
Update golang.org/x/mod from 0.17.0 to 0.18.0
Update golang.org/x/oauth2 from 0.20.0 to 0.21.0
Update google.golang.org/grpc from 1.63.2 to 1.64.0
Update google.golang.org/protobuf from 1.34.0 to 1.34.1
Update build dependencies.

v2.9.0

Features

Restore default rfc3339nano timestamps in table output for influxctl query and add the option for unixnano timestamps.

Bug Fixes

Update unimplemented error message with additional information.

Dependency Updates

Update github.com/apache/arrow/go/v16 from 16.0.0-20240401180149-68241d8a86e9 to 16.0.0.
Update github.com/jedib0t/go-pretty/v6 from 6.5.8 to 6.5.9.
Update github.com/pelletier/go-toml/v2 from 2.2.0 to 2.2.1.
Update github.com/pelletier/go-toml/v2 from 2.2.1 to 2.2.2.
Update github.com/urfave/cli/v2 from 2.27.1 to 2.27.2.
Update golang.org/x/net from 0.22.0 to 0.23.0.
Update golang.org/x/oauth2 from 0.19.0 to 0.20.0.
Update google.golang.org/protobuf from 1.33.0 to 1.34.0.
Update build dependencies.

v2.8.0

influxctl 2.8.0 requires InfluxDB Clustered version 20240326-922145 or newer. A change was made to how database commands were handled internally in InfluxDB Clustered that required this change. If using an older version of InfluxDB Clustered, you will observe an unimplemented gRPC error when using functionality that depends on the updated command handling. If upgrading is not possible, you can continue to use a version prior to 2.8.0 until you are able to update.

Features

Introduce the ability to query with InfluxQL.
Add insecure configuration option to TLS configuration.
Allow users to query system tables.
Utilize the database proxy service.

Dependency Updates

Update Go to v1.22.2.
Update github.com/go-git/go-git/v5 from 5.11.0 to 5.12.0.
Update github.com/jedib0t/go-pretty/v6 from 6.5.6 to 6.5.8.
Update golang.org/x/mod from 0.16.0 to 0.17.0.
Update golang.org/x/oauth2 from 0.18.0 to 0.19.0.
Update google.golang.org/grpc from 1.62.1 to 1.63.2.

v2.7.1

Bug Fixes

Correctly parse template tag bucket strings.

v2.7.0

This minor release adds the --template-tag-bucket partition template option to the already existing --template-time-format and --template-tag options used to define custom partition templates for databases and tables. This also fixes a nil pointer issue when listing management tokens.

Features

Introduce the bucket template method for grouping tag values into buckets and partitioning by each tag bucket.

Bug Fixes

Ensure strings are not nil pointers.

Dependency Updates

Update github.com/jedib0t/go-pretty/v6 from 6.5.5 to 6.5.6.
Update github.com/pelletier/go-toml/v2 from 2.1.1 to 2.2.0.
Update granite proto.

v2.6.0

influxctl 2.6.0 introduces the ability to create, list, and revoke management tokens and allow you to authenticate directly with your InfluxDB cluster instead of an OAuth2 provider.

New Features

Add management token subcommands to create, list, and revoke management tokens.
Introduce management token configuration option to authenticate using management tokens created with influxctl.

Dependency Updates

Update Go to v1.22.1
Update github.com/golang-jwt/jwt/v5 from v5.2.0 to v5.2.1.
Update google.golang.org/protobuf from v1.32.0 to v1.33.0.
Update golang.org/x/oauth2 from v0.17.0 to v0.18.0.
Update google.golang.org/grpc from v1.62.0 to v1.62.1.
Update github.com/jedib0t/go-pretty/v6 from v6.5.4 to v6.5.5.

v2.5.0

influxctl 2.5.0 introduces the ability to set partition templates during database or table creation. It introduces the table subcommand that lets users manually create tables. Additionally, influxctl now removes a previously cached token if the response from InfluxDB is unauthorized. This helps InfluxDB Clustered users who deploy new clusters using unexpired tokens associated with another InfluxDB cluster.

New Features

Add partition templates to database and table creation.
Remove token if unauthorized.

Bug Fixes

Update Arrow to allow non-TLS connections.
Do not attempt to load cached tokens when an admin token file is provided.
Print retention period up to days rather than very large hours.
Fix indentation of help output.

Dependency Updates

Update github.com/golangci/golangcilint from v1.56.1 to v1.56.2.
Update golang.org/x/mod from v0.15.0 to v0.16.0.
Update github.com/pkg/browser from v0.0.0-20210911075715-681adbf594b8 to v0.0.0-20240102092130-5ac0b6a4141c.
Update github.com/stretchr/testify from 1.8.4 to 1.9.0.
Update go.uber.org/zap from 1.26.0 to 1.27.0.
Update google.golang.org/grpc from 1.61.0 to 1.61.1.
Update google.golang.org/grpc from 1.61.1 to 1.62.0.

v2.4.4

Bug fixes

Introduced trace HTTP debug CLI option.
Added custom gRPC error message handling to gRPC experience.

Dependency updates

Update to go1.22.0.
Update github.com/apache/arrow/go/v14 v14.0.2 to v15.0.0.
Update github.com/google/uuid from 1.5.0 to 1.6.0.
Update github.com/jedib0t/go-pretty/v6 from 6.5.3 to 6.5.4.
Update golang.org/x/mod from 0.14.0 to 0.15.0.
Update golang.org/x/oauth2 from 0.16.0 to 0.17.0.
Update google.golang.org/grpc from 1.60.1 to 1.61.0.

v2.4.3

Bug fixes

Show empty value for database limits when not set, rather than zero.
Use user configured port for write.
Correct typos in query and write error messages.

Dependency updates

Update to go1.21.6.
Update github.com/apache/arrow/go/v14 from 14.0.1 to 14.0.2.
Update github.com/cloudflare/circl from 1.3.6 to 1.3.7.
Update github.com/jedib0t/go-pretty/v6 from 6.4.9 to 6.5.3.
Update github.com/urfave/cli/v2 from 2.26.0 to 2.27.1.
Update golang.org/x/crypto from 0.16.0 to 0.17.0.
Update golang.org/x/oauth2 from 0.15.0 to 0.16.0.
Update google.golang.org/grpc from 1.60.0 to 1.60.1.
Update google.golang.org/protobuf from 1.31.0 to 1.32.0.

v2.4.2

Bug fixes

Correctly set the version and build info for the version command.

v2.4.1

Bug fixes

Update influxctl query examples with SQL instead of InfluxQL.
Update example connection profile configuration with query and write options.
Use database and token CLI options if set.

v2.4.0

This release includes the following notable changes:

InfluxDB Cloud Dedicated users now have the same influxctl login experience as InfluxDB Clustered users. The Auth0 server uses device authorization by displaying a code to validate when logging in. The browser still opens, if possible, and pre-populates the code. The only difference is the need to verify the code on one additional page. This was done to align the user experience between both InfluxDB Cloud Dedicated and InfluxDB Clustered and to allow Cloud Dedicated users without a local UI or browser to continue to use influxctl.
Introduce the influxctl write and influxctl query commands. influxctl query queries an InfluxDB v3 instance using SQL. influxctl write writes line protocol to a InfluxDB v3 instance.

Features

Introduce influxctl query command.
Introduce influxctl write command.
Use device auth for InfluxDB Cloud Dedicated.

Bug fixes

Avoid nil pointer for database information.
Login and early return for TokenFile in InfluxDB Clustered.

Dependency updates

Update github.com/go-git/go-git/v5 from 5.10.0 to 5.10.1.
Update github.com/go-git/go-git/v5 from 5.10.1 to 5.11.0.
Update github.com/golang-jwt/jwt/v5 from 5.1.0 to 5.2.0.
Update github.com/urfave/cli/v2 from 2.25.7 to 2.26.0.
Update golang.org/x/oauth2 from 0.14.0 to 0.15.0.

v2.3.1

Bug fixes

Include error message description in device authorization polling errors.
Do not save tokens when loading from file.
Update header comments in the example config.toml.

Dependency updates

Update github.com/golang-jwt/jwt/v5 from 5.0.0 to 5.1.0.
Update golang.org/x/oauth2 from 0.13.0 to 0.14.0.

v2.3.0

Features updated in this release are meant for internal InfluxData use and do not affect any public APIs.

Dependency updates

Update github.com/go-git/go-git/v5 from 5.9.0 to 5.10.0.
Update github.com/google/uuid from 1.3.1 to 1.4.0.
Update github.com/jedib0t/go-pretty/v6 from 6.4.8 to 6.4.9.
Update golang.org/x/mod from 0.13.0 to 0.14.0.

v2.2.0

Features

Allow token authentication for InfluxDB Clustered.

v2.1.0

Features

Add --format flag to influxctl token create to specify the command output format.

Bug fixes

Use correct account and cluster names when specified in command flags.
Make influxctl database list return an empty array instead of null when there are no databases to list.

Dependency updates

Update to Go 1.21.3.
Update github.com/jedib0t/go-pretty/v6 from 6.4.7 to 6.4.8.
Update go.uber.org/zap from 1.25.0 to 1.26.0.
Update golang.org/x/mod from 0.12.0 to 0.13.0.
Update golang.org/x/net from 0.15.0 to 0.17.0.
Update golang.org/x/oauth2 from 0.12.0 to 0.13.0.
Update google.golang.org/grpc from 1.58.0 to 1.59.0.

Miscellaneous

Automate Homebrew tap releases for influxctl.

v2.0.4

Bug fixes

Validate Microsoft Entra ID (formerly Azure Active Directory) token and device URLs.
Only validate Microsoft Entra ID configuration when getting a token.

Dependency updates

Update to Go 1.21.

v2.0.3

Bug fixes

Add pagination support to influxctl token list and influxctl user list.
Send all logging output to stderr.
Return error for commands that are not supported by InfluxDB Clustered.

Dependency updates

Update github.com/google/uuid from 1.3.0 to 1.3.1.
Update github.com/jedib0t/go-pretty/v6 from 6.4.6 to 6.4.7.
Update github.com/pelletier/go-toml/v2 from 2.0.9 to 2.1.0.
Update golang.org/x/oauth2 from 0.11.0 to 0.12.0.
Update google.golang.org/grpc from 1.57.0 to 1.58.0.

v2.0.2

Bug fixes

Add cluster get args, clarify error message.
influxctl database update should only accept retention policy updates as a flag.
Update influxctl token create and influxctl token update help information with examples that use multiple permission flags.
Update influxctl cluster get help text.
Switch email param ordering.

Dependency updates

Update golang.org/x/mod from 0.8.0 to 0.12.0.

Miscellaneous

Clean up log formatting.
Remove extra debug output of account ID.

v2.0.1

Bug fixes

Return an error when using unrecognized TOML configuration options.

v2.0.0

influxctl 2.0.0 introduces support for both InfluxDB Cloud Dedicated and InfluxDB Clustered. To simplify configuration profile management, all connection configurations now managed in a single configuration file. If using influxctl 1.x, migrate your 1.x configuration profiles to the 2.0 format:

Migrate from influxctl 1.x to 2.0

influxctl 2.0+ supports multiple InfluxDB v3 products. To simplify connection configuration management, all configurations are now managed in a single file rather than separate files for each connection configuration.

To migrate influxctl 1.x configuration files to the 2.x format, use the following guidelines:

Create a 2.0+ configuration file (config.toml) at the default location for your operating system. See Create a configuration file.

Copy the account_id and cluster_id credentials from your influxctl 1.x configuration file and add them to a [[profile]] TOML table along with the following fields:

name: Profile name
product: InfluxDB product (dedicated)

For example, the following 1.x configuration file:

account_id = "dff3ee52-b494-47c1-9e2c-ab59d90d94eb"
cluster_id = "5827cdeb-b868-4446-b40e-e08de116fddf"

would become:

[[profile]]
    name = "default"
    product = "dedicated"
    account_id = "dff3ee52-b494-47c1-9e2c-ab59d90d94eb"
    cluster_id = "5827cdeb-b868-4446-b40e-e08de116fddf"

Features

Add support for both InfluxDB Cloud Dedicated and InfluxDB Clustered.
Provide public distributions through https://www.influxdata.com/downloads/ and the https://repos.influxdata.com/ repository.
The influxctl configuration file is now a single file that you can optionally pass in via the CLI.
Add additional options to influxctl database and influxctl token subcommands.
Introduce influxctl cluster subcommands.
Remove the influxctl init subcommand to avoid additional complexity of an InfluxDB Cloud Dedicated configuration.
Set maximum tables and columns when creating a database.
Support passing a connection configuration file path as a CLI option.
Delete multiple tokens or database in one command.
Disable of TLS verification for self-signed certificates.
Update a database and token values.
Update account & cluster ID for configurations for InfluxDB Clustered.
Add account and authz gRPC method support.
Add account and authz protofiles.
Add oauth2 authentication.
Specify custom TLS certificates.
Store configuration settings for multiple InfluxDB products in a single configuration file.

Bug Fixes

Return error when too many arguments are provided to a command.
Set token directory permissions to only the current user.
Unmarshal expires_in for device OAuth2 token.
Update authentication host for InfluxDB Cloud Dedicated.
Verify account and cluster IDs.

Miscellaneous

Update configuration examples with InfluxDB Clustered configurations.
Properly close gRPC connections.
Update error message for missing connection profiles.

Dependency Updates

Update github.com/pelletier/go-toml/v2 from 2.0.7 to 2.0.9.
Update github.com/stretchr/testify from 1.8.2 to 1.8.4.
Update github.com/urfave/cli/v2 from 2.25.3 to 2.25.7.
Update go.uber.org/zap from 1.24.0 to 1.25.0.
Update golang.org/x/oauth2 from 0.9.0 to 0.11.0.
Update google.golang.org/grpc from 1.55.0 to 1.57.0.
Update google.golang.org/protobuf from 1.30.0 to 1.31.0.

v1.1.0

Features

Add the influxctl database update subcommand to update retention periods.
Add the influxctl token update subcommand to update token descriptions.
Using the influxctl init command:
- Confirm before overwriting an existing profile.
- Remove the existing token if overwriting a profile.
On error, use stderr and return non-zero return code.
Increase command timeouts to 60 seconds.
Support setting the Auth0 and gRPC destinations using environment variables for staging and development environment use.

Bug fixes

Call Makefile instead of goreleaser.
Remove token on init.

Dependency updates

Update github.com/urfave/cli/v2 from 2.25.1 to 2.25.3.
Update golang.org/x/oauth2 from 0.7.0 to 0.8.0.
Update google.golang.org/grpc from 1.54.0 to 1.55.0.

v1.0.0

Features

Output confirmation messages on delete.
Use production Authentication service URLs.

Miscellaneous

Display 0s retention policies as infinite.

Was this page helpful?

Thank you for your feedback!

Support and feedback

Thank you for being part of our community! We welcome and encourage your feedback and bug reports for InfluxDB and this documentation. To find support, use the following resources:

Customers with an annual or support contract can contact InfluxData Support.

Edit this page Submit docs issue Submit InfluxDB issue