influxctl
influxctl 命令行界面 (CLI) 用于向 InfluxDB Cloud Dedicated 集群写入、查询和执行管理任务。
用法
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
使用以下选项之一下载并安装 influxctl 在 macOS 上：
使用 Homebrew 安装 influxctl
使用
brew tap将influxdata/tap仓库添加到 Homebrew 跟踪、更新和安装的公式列表中：brew tap influxdata/tap安装
influxctl包：brew install influxctl
手动下载并安装 influxctl 二进制文件
下载适合您CPU类型的
influxctlCLI包。从您的浏览器或命令行下载该包。浏览器
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包，请执行以下操作：
使用包管理器
# 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类型的
influxctlCLI包。从您的浏览器或命令行下载该包。浏览器
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/创建一个连接配置文件，保存您集群的连接凭据。
下载
influxctlCLI 包.解压下载的档案.
将下载的压缩文件解压到 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 防火墙阻止了此应用程序的某些功能。
要授予
influxctlCLI 所需的访问权限，请执行以下操作：选择私人网络，例如我的家庭网络或工作网络。点击允许访问。
创建一个连接配置文件，保存您集群的连接凭据。
配置连接概要
要连接到您的 InfluxDB Cloud Dedicated 集群， influxctl 需要以下凭据：
- InfluxDB Cloud 专用帐户 ID
- InfluxDB Cloud 专用集群 ID
创建配置文件
创建一个 config.toml，其中包含必要的凭据。 如果存储在您操作系统的 默认位置，influxctl 会自动检测并使用连接配置文件。 如果存储在非默认位置，请在每个 influxctl 命令中包含 --config 标志，并提供您的配置文件的路径。
默认连接配置文件存储位置
该 influxctl 命令行工具根据您的操作系统，在默认位置检查 config.toml 文件中的连接配置文件:
| 操作系统 | 默认配置文件路径 |
|---|---|
| Linux | ~/.config/influxctl/config.toml |
| macOS | ~/Library/Application Support/influxctl/config.toml |
| Windows | %APPDATA%\influxctl\config.toml |
认证
该 influxctl CLI 使用 Auth0 来验证访问信息
您的 InfluxDB Cloud Dedicated 集群。
当您发出 influxctl 命令时，CLI 会检查是否有有效的 Auth0 令牌。
如果没有，您将被引导通过浏览器登录 Auth0，使用您在设置 InfluxDB Cloud
Dedicated 集群时应该创建的凭据。
Auth0 发放一个短期（1小时）令牌，该令牌用于验证对您
InfluxDB Cloud Dedicated 集群的访问。
故障排除
未加载模块“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 ...