CLI 覆盖哪些操作
InfluxDB 2.x 的 influx 命令行工具覆盖从环境初始化到日常巡检的主要操作:保存连接配置、管理组织与 bucket、写入行协议文件、执行 Flux 查询、查看任务与授权。日常排障时它是最快的入口,不必先打开图形界面。
连接配置怎么管理
连接信息用 influx config create 保存成命名配置,命令默认使用当前激活的那一个,也可以用 -c 指定;地址、Token 与 org 同样可以由环境变量提供。Token 属于凭据,应放在受保护的配置文件或环境变量里,写进命令行会留在命令历史与进程列表中。
输出怎么脚本化
influx query 的默认输出带注释、表头与命名列,适合人看;脚本消费要用 --raw 或 --json 拿纯粹的结果集。批量导入行协议文件之前,先小批量试写再查询核对时间范围,确认 precision 与时间戳单位一致,之后才放开整批文件。
基本信息
| 配置 | influx config create -n default -u http://127.0.0.1:8086 -t <token> -o <org> |
|---|---|
| 写入 | influx write --bucket my-bucket --file data.lp --precision ns |
| 查询 | influx query 'from(bucket:"my-bucket") |> range(start:-1h) |> limit(n:5)' |
| 管理 | influx bucket list、influx task list、influx task log、influx auth list |
| 适用版本 | InfluxDB 2.x 配套 CLI,与 1.x 的 influx 命令不兼容 |
示例
示例
influx config create -n local -u http://127.0.0.1:8086 -t $INFLUX_TOKEN -o my-org
influx config list
influx bucket create -n metrics -o my-org -r 30d
influx write --bucket metrics --file metrics.lp --precision s
influx query 'from(bucket: "metrics") |> range(start: -1h) |> mean()'
influx task list
influx task log -i <taskID>典型使用场景
- 初始化环境:创建命名配置并验证连通性与账号权限
- 批量导入:用 influx write 把行协议文件灌进 bucket
- 临时查询:不打开图形界面,直接用 Flux 验证数据是否写入
- 运维巡检:列出 bucket、任务与授权,核对保留期与权限范围
- 故障排查:任务或写入异常时查看日志,定位失败的窗口
常用命令与参数
| 命令 | 作用 | 常用参数 |
|---|---|---|
| influx config create | 保存连接配置 | -n 名称、-u 地址、-t Token、-o org |
| influx write | 写入行协议文件 | --bucket、--file、--precision |
| influx query | 执行 Flux 查询 | --raw 与 --json 便于脚本解析 |
| influx bucket create | 新建 bucket | -n 名称、-o 组织、-r 保留期如 30d |
| influx auth list | 查看授权 | 核对 Token 的权限范围 |
命令默认使用当前激活的配置,用 -c 可以临时切到另一套环境;给测试与生产各存一个命名配置,能减少误操作。
2.x 的 influx CLI 与 1.x 时代的 influx 命令是两套工具,参数体系完全不同,从旧文档复制命令前先确认版本。