influxctl

influxctl 命令行界面 (CLI) 用于向 InfluxDB 集群写入、查询和执行管理任务。

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

用法

influxctl [global-flags] [command]

命令

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

全局标志

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

下载并安装 influxctl

macOS Linux Windows

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

使用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 CLI时，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.0 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 CLI 检查操作系统默认位置下的 config.toml 文件中的连接配置

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

身份验证

influxctl CLI 使用 Auth0 来验证对您的 InfluxDB 集群的访问。当您发出 influxctl 命令时，CLI 会检查一个活动的 Auth0 令牌。如果没有，您将重定向到浏览器中的 Auth0 登录，使用您在设置 InfluxDB Cloud Dedicated 集群时应该创建的凭证。Auth0 会发放一个短期的（1小时）令牌，以验证对您的 InfluxDB 集群的访问。

故障排除

无法加载模块“atk-bridge”：在验证时，一些 Linux 系统可能在终端（在 stderr 中）报告以下警告
```
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

这个页面有帮助吗？

感谢您的反馈！

支持和反馈

感谢您成为我们社区的一员！我们欢迎并鼓励您对 InfluxDB 及此文档的反馈和错误报告。要找到支持，请使用以下资源

拥有年度或支持合同的客户 可以联系 InfluxData 支持。

编辑此页面提交文档问题提交 InfluxDB 问题

influxctl

用法

命令

全局标志

下载并安装 influxctl

使用Homebrew安装influxctl

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

浏览器

命令行

使用包管理器

手动下载包

浏览器

命令行

配置连接配置文件

创建配置文件

默认连接配置存储位置

身份验证

故障排除

支持和反馈

Flux 的未来

InfluxDB v3 的增强功能和 InfluxDB 集群现在已正式发布

InfluxDB v3 的性能和功能

InfluxDB 集群正式发布

influxctl

用法

命令

全局标志

下载并安装 influxctl

使用Homebrew安装influxctl

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

浏览器

命令行

使用包管理器

手动下载包

浏览器

命令行

配置连接配置文件

创建配置文件

默认连接配置存储位置

身份验证

故障排除

支持和反馈

您的 InfluxDB 集群 URL 是什么？

输入集群 URL

感谢您的反馈！

Flux 的未来

InfluxDB v3 的增强功能和 InfluxDB 集群现在已正式发布

InfluxDB v3 的性能和功能

InfluxDB 集群正式发布