influxctl

该influxctl命令行界面（CLI）用于写入、查询和执行InfinxDB集群中的管理任务。

用法
命令
全局标志
下载并安装 influxctl
配置连接配置文件
身份验证

用法

influxctl [global-flags] [command]

命令

命令	描述
auth	登录或登出 InfluxDB 3
cluster	列出 InfluxDB 3 集群信息
database	管理 InfluxDB 3 个数据库
帮助	输出 `influxctl` 帮助信息
management	管理 InfluxDB 3 管理令牌
query	从InfluxDB 3查询数据
token	管理 InfluxDB 3 数据库令牌
user	管理 InfluxDB 3 集群用户
版本	输出当前 `influxctl` 版本
write	将线协议写入InfluxDB 3

全局标志

标志		描述
	`--debug`	启用调试日志
	`--account`	覆盖配置文件中的账户ID值
	`--cluster`	覆盖配置文件中的集群 ID 值
	`--config`	要使用的配置文件路径
	`--profile`	指定要使用的连接配置文件（默认是 `default`）
	`--timeout`	为API调用指定超时持续时间（默认是 `1m0s`）
	`--trace`	启用更详细的调试日志
`-h`	`--help`	显示帮助

下载和安装 influxctl

macOS Linux Windows

使用以下选项之一下载并安装 influxctl 在 macOS 上：

使用 Homebrew 安装 influxctl
手动下载并安装 influxctl 二进制文件

使用 Homebrew 安装 influxctl

使用 brew tap 将 influxdata/tap 仓库添加到 Homebrew 跟踪、更新和安装的公式列表中：
```
brew tap influxdata/tap
```
安装 influxctl 包：
```
brew install influxctl
```

手动下载并安装 influxctl 二进制文件

下载适合您CPU类型的 influxctl CLI包。从您的浏览器或命令行下载该包。

浏览器

influxctl CLI v2.9.8 (x86_64) influxctl CLI v2.9.8 (arm64)

命令行

# x86_64
curl -Oo ~/Downloads/ https://dl.influxdata.com/influxctl/releases/influxctl-v2.9.8-darwin-x86_64.zip

# arm64
curl -Oo ~/Downloads/ https://dl.influxdata.com/influxctl/releases/influxctl-v2.9.8-darwin-arm64.zip

解压下载的包。
执行以下操作之一：
- 在 Finder 中，双击下载的包文件。
- 从命令行运行适合您CPU类型的以下命令：
```
# x86_64
unzip ~/Downloads/influxctl-v2.9.8-darwin-x86_64.zip

# arm64
unzip ~/Downloads/influxctl-v2.9.8-darwin-arm64.zip
```

(可选) 将二进制文件放入您的 $PATH。

# x86_64
sudo cp ~/Downloads/influxctl-v2.9.8-darwin-x86_64/influxctl /usr/local/bin/

# arm64
sudo cp ~/Downloads/influxctl-v2.9.8-darwin-arm64/influxctl /usr/local/bin/

创建一个连接配置文件，用于存储您集群的连接凭据。

要下载Linux influxctl包，请执行以下操作：

使用包管理器
手动下载包

使用包管理器

Ubuntu & Debian (.deb) Red Hat & CentOS (.rpm)

# influxdata-archive_compat.key GPG fingerprint:
#     9D53 9D90 D332 8DC7 D6C8 D3B9 D8FF 8E1F 7DF8 B07E
wget -q https://repos.influxdata.com/influxdata-archive_compat.key
echo '393e8779c89ac8d958f81f942f9ad7fb82a25e133faddaf92e15b16e6ac9ce4c influxdata-archive_compat.key' | sha256sum -c && cat influxdata-archive_compat.key | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/influxdata-archive_compat.gpg > /dev/null
echo 'deb [signed-by=/etc/apt/trusted.gpg.d/influxdata-archive_compat.gpg] https://repos.influxdata.com/debian stable main' | sudo tee /etc/apt/sources.list.d/influxdata.list

sudo apt-get update && sudo apt-get install influxctl

# influxdata-archive_compat.key GPG fingerprint:
#     9D53 9D90 D332 8DC7 D6C8 D3B9 D8FF 8E1F 7DF8 B07E
cat <<EOF | sudo tee /etc/yum.repos.d/influxdata.repo
[influxdata]
name = InfluxData Repository - Stable
baseurl = https://repos.influxdata.com/stable/\$basearch/main
enabled = 1
gpgcheck = 1
gpgkey = https://repos.influxdata.com/influxdata-archive_compat.key
EOF

sudo yum install influxctl

手动下载包

下载适合您CPU类型的 influxctl CLI包。从您的浏览器或命令行下载该包。

浏览器

influxctl CLI v2.9.8 (x86_64) influxctl CLI v2.9.8 (arm64)

命令行

# amd64
curl -O https://dl.influxdata.com/influxctl/releases/influxctl-v2.9.8-linux-x86_64.tar.gz

# arm64
curl -O https://dl.influxdata.com/influxctl/releases/influxctl-v2.9.8-linux-arm64.tar.gz

解压下载的包.

# amd64
tar zxvf influxctl-v2.9.8-linux-x86_64.tar.gz

# arm64
tar zxvf influxctl-v2.9.8-linux-arm64.tar.gz

(可选) 将二进制文件放置在你的 $PATH 中.

# amd64
sudo cp influxctl-v2.9.8-darwin-x86_64/influxctl /usr/local/bin/

# arm64
sudo cp influxctl-v2.9.8-darwin-arm64/influxctl /usr/local/bin/

创建一个连接配置文件，保存您集群的连接凭据。

下载 influxctl CLI 包.
influxctl CLI v2.9.8 (x86_64)

解压下载的档案.

将下载的压缩文件解压到 C:\Program Files\InfluxData\ 并根据需要重命名。

Expand-Archive .\influxctl-v2.9.8-windows-x86_64.zip `
-DestinationPath 'C:\Program Files\InfluxData\'
mv 'C:\Program Files\InfluxData\influxctl-v2.9.8-windows-x86_64' `
'C:\Program Files\InfluxData\influxctl'

授予 influxctl CLI 网络访问权限。
第一次使用 influxctl 命令行工具时，Windows Defender 显示以下消息：
Windows Defender 防火墙阻止了此应用程序的某些功能。
要授予 influxctl CLI 所需的访问权限，请执行以下操作：
选择私人网络，例如我的家庭网络或工作网络。点击允许访问。
创建一个连接配置文件，保存您集群的连接凭据。

配置连接概要

要连接到您的 InfluxDB 集群， influxctl 需要以下凭据：

InfluxDB 集群主机
InfluxDB集群端口
OAuth提供者凭据 (所需凭据取决于您的OAuth提供者)

创建配置文件

创建一个 config.toml，其中包含必要的凭据。如果存储在您操作系统的默认位置，influxctl 会自动检测并使用连接配置文件。如果存储在非默认位置，请在每个 influxctl 命令中包含 --config 标志，并提供您的配置文件的路径。

查看示例 config.toml

## influxctl - example configuration

[[profile]]
    ## Profile name
    ## Users can define multiple profile sections and reference them via the
    ## `--profile {name}` global option. By default, the profile named
    ## "default" is loaded and used.
    name = "PROFILE_NAME
"

    ## Product type
    ## Choose from "clustered" or "dedicated"
    product = "clustered"

    ## Host and port
    ## InfluxDB hostname/IP address and port.
    ## Required for InfluxDB Clustered.
    host = "cluster-host.com"
    port = "INFLUXDB_PORT
"

    ## Database and token
    ## Used for the query and write subcommands
    # database = ""
    # token = ""

    ### Dedicated Specific Options ###
    ## Account ID and cluster ID
    # account_id = ""
    # cluster_id = ""

    ## Custom client-side TLS certs
    ## By default, the system certificates are used. If a custom certificate
    ## for connecting to InfluxDB is required, define it below.
    # [profile.tls]
        ## When true, `insecure` influxctl configures HTTPS clients to not
        ## verify server certificates. Use this if you are connecting to a
        ## TLS endpoint with invalid (expired, self-signed, etc) server
        ## certificates.
        # insecure = false
        ## When true, `disable` causes influxctl to use HTTP rather than HTTPS
        ## client. Use this if you don't have an ingress controller configured
        ## to terminate TLS connections. InfluxDB 3 components themselves do
        ## not terminate TLS.
        # disable = false
        # cert = ""
        # key = ""
        # ca = ""

    ## OAuth2 client authorization settings
    [profile.auth.oauth2]
        client_id = "OAUTH_CLIENT_ID
"
        scopes = [""]
        parameters = { audience = "" }
        token_url = "OAUTH_TOKEN_URL
"
        device_url = "OAUTH_DEVICE_URL
"

在示例中替换以下值：

PROFILE_NAME: 使用 default 作为默认连接配置文件，或者使用自定义名称作为非默认配置文件。
INFLUXDB_PORT: InfluxDB 集群端口
OAUTH_CLIENT_ID: OAuth 客户端 ID
OAUTH_CLIENT_ID: OAuth 供应商令牌 URL（例如：https://indentityprovider/oauth2/v2/token）
OAUTH_CLIENT_ID: OAuth提供者设备URL（例如：https://indentityprovider/oauth2/v2/auth/device）

默认连接配置文件存储位置

该 influxctl 命令行工具根据您的操作系统，在默认位置检查 config.toml 文件中的连接配置文件:

操作系统	默认配置文件路径
Linux	`~/.config/influxctl/config.toml`
macOS	`~/Library/Application Support/influxctl/config.toml`
Windows	`%APPDATA%\influxctl\config.toml`

认证

这个influxctl命令行工具使用Auth0来验证对您InfluxDB集群的访问。当您发出influxctl命令时，CLI检查是否有活动的Auth0令牌。如果不存在，您将被引导通过浏览器登录Auth0，使用您在设置InfluxDB Cloud Dedicated集群时应该创建的凭据。Auth0发放一个短期（1小时）令牌，用于验证对您InfluxDB集群的访问。

故障排除

未加载模块“atk-bridge”：在认证时，一些Linux系统可能会在终端（标准错误）报告以下警告：
```
Not loading module "atk-bridge": The functionality is provided by GTK natively. Please try to not load it.
```
要在运行 influxctl 命令时消除警告，请取消设置 GTK_MODULES 环境变量（或从其值中删除 gail:atk-bridge）–例如：
```
GTK_MODULES= influxctl ...
```

cli

influxctl

用法

命令

全局标志

下载和安装 influxctl

使用 Homebrew 安装 influxctl

手动下载并安装 influxctl 二进制文件

浏览器

命令行

使用包管理器

手动下载包

浏览器

命令行

配置连接概要

创建配置文件

默认连接配置文件存储位置

认证

故障排除

Flux的未来

InfluxDB 3 开源版本现已公开Alpha测试

influxctl

用法

命令

全局标志

下载和安装 influxctl

使用 Homebrew 安装 influxctl

手动下载并安装 influxctl 二进制文件

浏览器

命令行

使用包管理器

手动下载包

浏览器

命令行

配置连接概要

创建配置文件

默认连接配置文件存储位置

认证

故障排除

您的 InfluxDB 集群 URL 是什么？

输入集群 URL

感谢您的反馈!

Flux的未来

InfluxDB 3 开源版本现已公开Alpha测试