Documentation

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 for influxctl query and add the option for unixnano 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 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

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

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

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:

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

  2. 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!


The future of Flux

Flux is going into maintenance mode. You can continue using it as you currently are without any changes to your code.

Read more

InfluxDB v3 enhancements and InfluxDB Clustered is now generally available

New capabilities, including faster query performance and management tooling advance the InfluxDB v3 product line. InfluxDB Clustered is now generally available.

InfluxDB v3 performance and features

The InfluxDB v3 product line has seen significant enhancements in query performance and has made new management tooling available. These enhancements include an operational dashboard to monitor the health of your InfluxDB cluster, single sign-on (SSO) support in InfluxDB Cloud Dedicated, and new management APIs for tokens and databases.

Learn about the new v3 enhancements


InfluxDB Clustered general availability

InfluxDB Clustered is now generally available and gives you the power of InfluxDB v3 in your self-managed stack.

Talk to us about InfluxDB Clustered