文档文档

安装和使用 influx CLI

使用 influx CLI 与 InfluxDB 实例交互和管理。写入和查询数据,生成 InfluxDB 模板,导出数据等等。

influx CLI 与 InfluxDB 服务器 (influxd) 分开打包和版本控制。

安装 influx CLI

执行以下操作之一

使用 Homebrew

brew install influxdb-cli
  • Copy
  • Fill window

如果您使用 Homebrew 安装了 InfluxDB 2.7,则 influxdb-cli 公式已作为依赖项下载,应该已经安装。 如果已安装,influxdb-cli 将出现在以下命令的输出中

brew list | grep influxdb-cli
  • Copy
  • Fill window

手动下载和安装

  1. 从您的浏览器 下载 influx CLI 包 或从命令行 下载

    从您的浏览器下载

    influx CLI v2.7.5 (macOS)

    从命令行下载

    curl -LO https://dl.influxdata.com/influxdb/releases/influxdb2-client-2.7.5-darwin-amd64.tar.gz \
        --output-dir ~/Downloads
    
    • Copy
    • Fill window
  2. 解压下载的二进制文件。

    执行以下操作之一

    • 访达中,双击下载的包文件。

    • 在您的终端中(例如,终端iTerm2),使用 tar 提取包 - 例如,输入以下命令将其提取到 ~/Downloads

      tar zxvf ~/Downloads/influxdb2-client-2.7.5-darwin-amd64.tar.gz \
        --directory ~/Downloads
      
      • Copy
      • Fill window
  3. 可选:将 influx 二进制文件放在您的 $PATH 中 - 例如,将二进制文件复制到 /usr/local/bin

    sudo cp ~/Downloads/influx /usr/local/bin/
    
    • Copy
    • Fill window

    influx 二进制文件放在您的 $PATH (/usr/local/bin) 中后,您可以在终端中输入 influx 来运行 CLI。

    如果您不将 influx 二进制文件移动到您的 $PATH 中,请输入二进制文件的路径以运行 CLI - 例如

    ~/Downloads/influx
    
    • Copy
    • Fill window
  4. (macOS Catalina 及更高版本)授权 influx 二进制文件。

    macOS 要求下载的二进制文件由注册的 Apple 开发者签名。 当您第一次尝试运行 influx 时,macOS 会阻止它运行。 要授权 influx 二进制文件

    允许 macOS Ventura 上的二进制文件

    1. 按照上述说明尝试启动 influx
    2. 打开系统设置,然后单击隐私和安全性
    3. 安全性标题下,有一条关于“influxd”被阻止的消息,单击仍然允许
    4. 出现提示时,输入您的密码以允许设置。
    5. 关闭系统设置
    6. 尝试启动 influx
    7. 将出现一个提示,显示消息“macOS 无法验证“influx”的开发者…”"。单击打开

    允许 macOS Catalina 上的二进制文件

    1. 尝试运行 influx 命令。
    2. 打开系统偏好设置,然后单击安全性与隐私
    3. 通用选项卡下,有一条关于 influx 被阻止的消息。单击仍然打开
  1. 从您的浏览器 下载 influx CLI 包 或从命令行 下载

    从您的浏览器下载

    influx CLI v2.7.5 (amd64) influx CLI v2.7.5 (arm)

    从命令行下载

    # amd64
    wget https://dl.influxdata.com/influxdb/releases/influxdb2-client-2.7.5-linux-amd64.tar.gz
    
    • Copy
    • Fill window
    # arm
    wget https://dl.influxdata.com/influxdb/releases/influxdb2-client-2.7.5-linux-arm64.tar.gz
    
    • Copy
    • Fill window
  2. 解压下载的二进制文件。

    注意: 以下命令是示例。如有必要,请调整文件名、路径和实用程序。

    # amd64
    tar xvzf ./influxdb2-client-2.7.5-linux-amd64.tar.gz
    
    • Copy
    • Fill window
    # arm
    tar xvzf ./influxdb2-client-2.7.5-linux-arm64.tar.gz
    
    • Copy
    • Fill window
  3. 可选:将解压缩的 influx 可执行文件放入您的系统 $PATH 中。

    # amd64
    sudo cp ./influx /usr/local/bin/
    
    • Copy
    • Fill window
    # arm
    sudo cp ./influx /usr/local/bin/
    
    • Copy
    • Fill window

    如果您不将 influxd 二进制文件移动到您的 $PATH 中,请输入二进制文件的路径以启动服务器 - 例如

    ./influx
    
    • Copy
    • Fill window

我们建议在 Powershell 中运行 influx CLI 命令。命令提示符不完全兼容。

  1. 下载 influx CLI 包。

    influx CLI v2.7.5 (Windows)

  2. 展开下载的存档。

    将下载的存档展开到 C:\Program Files\InfluxData\ 中,如果需要,可以重命名它。

    > Expand-Archive .\influxdb2-client-2.7.5-windows-amd64.zip -DestinationPath 'C:\Program Files\InfluxData\'
    > mv 'C:\Program Files\InfluxData\influxdb2-client-2.7.5-windows-amd64' 'C:\Program Files\InfluxData\influx'
    
    • Copy
    • Fill window
  3. 授予 influx CLI 网络访问权限。

    首次使用 influx CLI 时,Windows Defender 会显示以下消息

    Windows Defender 防火墙阻止了此应用程序的某些功能。

    要授予 influx CLI 所需的访问权限,请执行以下操作

    1. 选择专用网络,例如我的家庭或工作网络
    2. 单击允许访问

设置 influx CLI

提供所需的身份验证凭据

为了避免每次命令都传递 InfluxDB 主机API 令牌组织,请将它们存储在 influx CLI 配置(config)中。 需要这些凭据的 influx 命令会自动从活动配置中检索这些凭据。

使用 influx config create 命令 创建一个 influx CLI 配置并将其设置为激活状态

influx config create --config-name 
CONFIG_NAME
\
--host-url
https://#:8086
\
--org
ORG
\
--token
API_TOKEN
\
--active
  • Copy
  • Fill window

替换以下内容

  • CONFIG_NAME:连接配置名称。
  • ORG_NAME:你的 InfluxDB 组织
  • API_TOKEN:你的 API 令牌

有关管理 CLI 配置的更多信息,请参阅 influx config 文档

有关如何创建 API 令牌的说明,请参阅创建令牌

使用用户名和密码进行身份验证

influx CLI 2.4.0+ 允许您创建连接配置,该配置使用您用于登录 InfluxDB 用户界面 (UI) 的用户名和密码组合对 InfluxDB OSS 2.4+ 进行身份验证。 CLI 检索会话 cookie 并将其以未加密的形式存储在您的 configs path 中。

使用 --username-password, -p 选项,使用 <username>:<password> 语法提供您的用户名和密码。 如果未提供密码,CLI 会在每次需要身份验证的命令后提示输入密码。

influx config create \
  -n 
CONFIG_NAME
\
-u
https://#:8086
\
-p
USERNAME
:
PASSWORD
\
-o
ORG
  • Copy
  • Fill window

替换以下内容

  • CONFIG_NAME:连接配置名称。
  • ORG: 你的组织名称
  • USERNAME:PASSWORD: 你的 UI 用户名和密码组合。

启用 shell 补全(可选)

要安装 influx shell 补全脚本,请参阅 influx completion

使用 influx CLI 命令

有关 influx CLI 命令的信息,请参阅 influx CLI 参考文档


此页面是否对您有帮助?

感谢您的反馈!


Flux 的未来

Flux 将进入维护模式。您可以继续像现在这样使用它,而无需对您的代码进行任何更改。

阅读更多

InfluxDB 3 开源版现已进入公开 Alpha 阶段

InfluxDB 3 开源版现已可用于 alpha 测试,并根据 MIT 或 Apache 2 许可获得许可。

我们将发布两个产品作为 Alpha 的一部分。

InfluxDB 3 Core 是我们新的开源产品。 它是用于时间序列和事件数据的最新数据引擎。 InfluxDB 3 Enterprise 是一个商业版本,它建立在 Core 的基础上,增加了历史查询功能、读取副本、高可用性、可扩展性和细粒度的安全性。

有关如何开始使用的更多信息,请查看