influxctl release notes
v2.9.6
Bug Fixes
- Update query subcommand 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 forinfluxctl query
and add the option forunixnano
timestamps.
Bug Fixes
- Update unimplemented error message with additional information.
Dependecy 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 useinfluxctl
. - Introduce the
influxctl write
andinfluxctl 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 toinfluxctl 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
andinfluxctl 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
andinfluxctl 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
andcluster_id
credentials from yourinfluxctl
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
andinfluxctl 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 ofgoreleaser
. - 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.