GeekIt

InfluxDB命令速查

服务启停、CLI 配置、组织桶与令牌、行协议写入、Flux 查询、v1 兼容、备份恢复、任务告警与排障等 150 条命令

共 150 条命令 · 12 类场景 · 点击右侧图标可复制

命令 / 表达式说明复制
influxd version查看服务端版本
influxd前台启动,默认监听 8086
influxd --help查看全部启动参数
influxd config打印当前生效配置,排查参数来源
influxd --config /etc/influxdb/config.toml指定配置文件启动
systemctl start influxdbsystemd 部署方式启动
systemctl status influxdb查看服务状态与最近日志
journalctl -u influxdb -f实时查看服务日志
ss -lntp | grep -E "8086|8088"确认 HTTP 8086 与 RPC 8088 端口
curl http://localhost:8086/health健康检查,返回 status=pass 即正常
influxd upgrade从 1.x 升级到 2.x,升级前务必备份
influxd downgrade从 2.x 回退到 1.x(谨慎)
influxd run运行子命令(与直接 influxd 类似)
influxd inspect查看离线检查工具集
命令 / 表达式说明复制
influx setup --username admin --password "P@ssw0rd" --org myorg --bucket mybucket --retention 30d --force初始化实例:创建管理员、组织与初始桶
influx config create -n prod -u http://10.0.0.11:8086 -t $INFLUX_TOKEN -o myorg保存连接配置,后续命令免带参数
influx config list列出所有配置与当前激活项
influx config set -n prod切换当前配置
influx config remove -n prod删除配置
export INFLUX_HOST=http://localhost:8086用环境变量指定地址
export INFLUX_TOKEN=xxxx用环境变量传 Token,避免写入命令历史
export INFLUX_ORG=myorg默认组织
export INFLUX_BUCKET=mybucket默认桶
influx ping连通性检查,返回 OK 即通
influx version查看 CLI 版本
influx --help查看所有子命令
命令 / 表达式说明复制
influx org create --name myorg创建组织
influx org list列出组织
influx org find --name myorg按名称查找组织 ID
influx bucket create -n mybucket -o myorg -r 30d创建桶并设置保留期
influx bucket create -n mybucket -o myorg -r 0保留期 0 表示永久保留
influx bucket create -n mybucket -o myorg -r 90d --shard-group-duration 1d指定分片组时长,影响查询与压缩效率
influx bucket list列出全部桶、保留期与分片组
influx bucket update -n mybucket -r 180d修改保留期
influx bucket delete -n mybucket删除桶及其数据(不可恢复)
influx auth create -o myorg --read-bucket <bucketID> --write-bucket <bucketID>按桶粒度创建读写令牌
influx auth create -o myorg --all-access创建全权限令牌(慎用)
influx auth list列出令牌与权限范围
influx auth delete -i <tokenID>删除令牌
influx delete -o myorg -b mybucket --start 2026-01-01T00:00:00Z --stop 2026-02-01T00:00:00Z按时间范围删除数据,需提供 start/stop
命令 / 表达式说明复制
influx write -b mybucket -o myorg -p s -f data.lp按行协议文件写入,-p 指定时间精度
influx write -b mybucket -o myorg "cpu,host=a,region=bj value=0.64 1609459200"命令行直接写一行(精度秒)
influx write dryrun -b mybucket -o myorg -f data.lp只校验行协议不写入
influx write -b mybucket -o myorg --format csv -f data.csv按 CSV 格式导入
influx write -b mybucket -o myorg --header "#datatype measurement,tag,double" -f annotated.csv带注解的 CSV 导入
influx write -b mybucket -o myorg --precision ms -f data.lp毫秒精度写入
curl -XPOST "http://localhost:8086/api/v2/write?org=myorg&bucket=mybucket&precision=s" -H "Authorization: Token $TOKEN" --data-binary 'cpu,host=a value=1 1609459200'HTTP 写入接口
curl -XPOST "http://localhost:8086/write?db=mydb" --data-binary 'cpu value=1'1.x 兼容写入接口
行协议格式:measurement,tag1=v1 field1=1.0 timestamp标签用于索引,字段存值,注意空格与逗号
单次写入建议不超过 5000 行 / 2MB过大容易触发 413 或超时
influx write -b mybucket -o myorg -f data.lp --rate-limit 10000限制写入速率,保护实例
influx write -b mybucket -o myorg -f data.lp --errors-file /tmp/err.lp失败行单独落盘便于重放
命令 / 表达式说明复制
influx query -o myorg 'from(bucket:"mybucket") |> range(start: -1h)'最基础的 Flux 查询
influx query -o myorg 'from(bucket:"mybucket") |> range(start:-1h) |> filter(fn:(r) => r._measurement == "cpu")'按 measurement 过滤
influx query -o myorg 'from(bucket:"mybucket") |> range(start:-1h) |> filter(fn:(r) => r.host == "a")'按标签过滤
influx query -o myorg 'from(bucket:"mybucket") |> range(start:-1h) |> filter(fn:(r) => r._field == "value") |> mean()'取平均值,需先过滤字段
influx query -f query.flux执行 Flux 文件,复杂查询建议落文件
influx query --raw -o myorg '...'输出原始注解 CSV,便于脚本解析
influx query -o myorg --profiler query '...'输出查询执行计划耗时,定位慢查询
influx query -o myorg 'import "experimental/csv" csv.from(url: "http://x/data.csv")'从 CSV 导入后在 Flux 中处理
curl -XPOST "http://localhost:8086/api/v2/query?org=myorg" -H "Authorization: Token $TOKEN" -H "Accept: application/csv" -H "Content-Type: application/vnd.flux" --data 'from(bucket:"mybucket") |> range(start:-1h)'HTTP 查询接口
Flux 查询必须有 range 才能扫数据缺少 range 会直接报错或返回空
命令 / 表达式说明复制
|> range(start: -1h, stop: now())限定时间范围,必须且尽量靠前
|> filter(fn: (r) => r._measurement == "cpu" and r._field == "usage")过滤行,多个条件用 and
|> group(columns: ["host"])按列重新分组
|> aggregateWindow(every: 1m, fn: mean, createEmpty: false)按窗口聚合,做降采样最常用
|> mean() / max() / min() / sum() / count()基础聚合函数
|> derivative(unit: 1s, nonNegative: true)求变化率
|> difference(nonNegative: true)相邻值差值
|> increase()counter 增量(自动处理重置)
|> rate()每秒增长率
|> last() / first()取最后/第一个值
|> pivot(rowKey:["_time"], columnKey: ["_field"], valueColumn: "_value")把字段转成列,便于多指标对比
|> join(tables: {a: a, b: b}, on: ["_time"])按时间对齐连接两个结果
|> union(tables: [a, b])合并结果集
|> keep(columns: ["_time", "_value", "host"])只保留指定列,减少传输
|> drop(columns: ["_start", "_stop"])丢弃无用列
|> map(fn: (r) => ({ r with _value: r._value * 100.0 }))逐行计算,做单位换算
|> sort(columns: ["_time"], desc: true) |> limit(n: 10)排序取前 N 条
|> yield(name: "mean")命名输出,多结果区分
命令 / 表达式说明复制
influx v1 dbrp create --db mydb --rp autogen --bucket-id <bucketID> --default把 2.x 桶映射为 1.x 数据库与保留策略
influx v1 dbrp list查看映射关系
influx v1 dbrp delete --id <id>删除映射
influx v1 auth create --username telegraf --password pass --write-bucket <id>创建 1.x 兼容账号
influx v1 auth list列出 1.x 账号
curl -G "http://localhost:8086/query?db=mydb" --data-urlencode "q=SELECT * FROM cpu LIMIT 10"InfluxQL 查询接口
curl -G "http://localhost:8086/query?db=mydb" --data-urlencode "q=SHOW MEASUREMENTS"查看 measurement 列表
curl -G "http://localhost:8086/query?db=mydb" --data-urlencode "q=SHOW TAG KEYS FROM cpu"查看标签键,排查基数问题
curl -G "http://localhost:8086/query" --data-urlencode "q=SHOW DATABASES"查看所有数据库
InfluxQL 仅支持 v1 映射的桶新项目建议直接用 Flux 或 /api/v2 接口
命令 / 表达式说明复制
influx backup /backup/influx-20261102 -t $INFLUX_TOKEN2.x 全量备份(含元数据与数据)
influx restore /backup/influx-20261102 -t $INFLUX_TOKEN恢复备份,会覆盖现有元数据,务必谨慎
influx restore --new-bucket mybucket-copy /backup/influx-20261102恢复为新桶,避免覆盖生产
influx export all -f cluster.yml -t $INFLUX_TOKEN导出全部资源(桶、任务、仪表板等)为模板
influx export bucket -f bucket.yml -n mybucket只导出指定桶配置
influx export task -f task.yml -i <taskID>导出指定任务
influx apply -f cluster.yml --force在另一实例上应用模板
influxd backup -portable /backup/v11.x 便携备份(仅 v1 可用)
influxd restore -portable /backup/v11.x 恢复
备份前确认 Token 具备读全部桶权限权限不足会在中途失败并留下不完整备份
导出句柄要定期轮换export 文件可能包含令牌信息,按敏感文件管理
命令 / 表达式说明复制
influx task create -o myorg -f task.flux创建定时任务(Flux 脚本内置 option task)
influx task list列出任务与状态、最近执行时间
influx task find -i <taskID>查看任务详情与 Flux 脚本
influx task update -i <taskID> --status inactive暂停任务
influx task update -i <taskID> --status active恢复任务
influx task log -i <taskID>查看任务运行日志
influx task run list -i <taskID>查看执行记录与失败原因
influx task retry -i <taskID> -r <runID>重试失败的执行
influx task delete -i <taskID>删除任务
option task = {name: "downsample", every: 1h, offset: 5m}任务定义头部,控制调度周期
告警依赖 _monitoring 桶与 checks2.x 告警通过 /api/v2/checks 与 notificationRules 配置
任务写入目标桶要注意保留期源桶数据被清理后任务会查不到数据
命令 / 表达式说明复制
curl -s http://localhost:8086/metrics | headPrometheus 格式指标
curl -s http://localhost:8086/metrics | grep influxdb_httpHTTP 请求量与错误率
curl -s http://localhost:8086/debug/vars | head运行时变量与统计
curl -s http://localhost:8086/health健康状态与版本
influxd inspect report-tsm --bucket-id <bucketID>统计 TSM 文件分布与压缩率
influxd inspect report-tsi --bucket-id <bucketID>统计索引基数,定位高基数指标
influxd inspect export-lp --bucket-id <bucketID> --engine-path /var/lib/influxdb2/engine --output-path /tmp/dump.lp导出桶数据为行协议
influxd inspect dump-wal --path /var/lib/influxdb2/wal查看 WAL 内容,排查写入异常
influxd inspect build-tsi重建索引文件,损坏时使用
influxd inspect verify-seriesfile --dir /var/lib/influxdb2/engine校验序列文件完整性
journalctl -u influxdb | grep -i "slow"查找慢查询相关日志
influx bucket list 观察桶大小结合保留期评估磁盘增长
命令 / 表达式说明复制
SHOW TAG KEYS FROM cpu(InfluxQL)先找出标签键,再评估取值数量
influxd inspect report-tsi --bucket-id <id>索引基数报告,高基数是性能杀手
influx bucket update -n mybucket --shard-group-duration 7d按写入量调整分片组,1d~7d 常见
influx bucket update -n mybucket -r 30d缩短保留期,直接降低查询与磁盘成本
查询尽量带 range 与 filterFlux 先裁剪时间再过滤标签,避免全桶扫描
aggregateWindow 放在 filter 之后减少聚合的数据量
避免把高基数值作为 tagtrace_id、user_id 应放 field 或改写标签结构
influx query --profiler query看 Flux 各算子耗时,定位瓶颈
批量写入优先于逐点写入每批 5000 行左右,兼顾吞吐与失败重试成本
influx write --rate-limit限制写入速率,避免打满 IO
命令 / 表达式说明复制
401 Unauthorized / authorization failedToken 无效、过期或缺少对应桶权限
403 ForbiddenToken 权限不足,检查 auth 的读写范围
bucket not found桶名或 ID 错误,也可能 Token 无该桶权限
organization not foundorg 名称与 Token 绑定的组织不一致
failed to initialize execute state: could not find bucketFlux 中桶名写错或未指定 org
partial write: field type conflict同一字段类型不一致(v1),统一数值类型或改名
points beyond retention policy dropped数据超出保留期被丢弃,检查时间戳与保留期
invalid timestamp / unable to parse行协议时间戳精度不匹配,确认 -p 参数
413 Request Entity Too Large单批过大,拆分成小块写入
query timeout / context deadline exceeded查询超时:缩小 range、加 filter、降低聚合粒度
max series per database exceeded序列基数超限(v1),优化标签或调整限制
connection refused(8086)服务未启动、端口配置不符或防火墙拦截
read: connection reset by peer服务端重启或写入过大,降低并发与批次
database not found / retention policy not foundv1 接口访问未建立 dbrp 映射的桶
写入成功但查不到数据常见于时间戳超范围、精度写错或查错桶/组织

运维常用组合

初始化接入influx setup → influx bucket create → influx auth create → influx config create → influx write 验证
日常查询from(bucket) |> range(start:-1h) → filter → aggregateWindow → yield → Grafana 展示
降采样task 每小时 aggregateWindow → 写入聚合桶(长保留) → 原桶短保留 → 面板查聚合桶
备份恢复influx backup → influx export all → 新实例 influx restore --new-bucket → 校验数据
v1 兼容influx v1 dbrp create → influx v1 auth create → /query 与 /write 接口验证
性能排查report-tsi 看基数 → SHOW TAG KEYS → profiler 看算子耗时 → 调保留期与分片组

常见问题排查

1. Flux 必须先 range

没有 range 的查询扫不到数据,时间范围越窄越快

2. tag 与 field 别混用

tag 建索引适合筛选,field 存数值;把高基数值当 tag 会拖垮查询

3. 基数决定性能上限

用 report-tsi 与 SHOW TAG KEYS 评估基数,超百万序列要重新设计标签

4. 保留期就是成本

按业务需要设置 retention,再配合任务降采样长期保留聚合值

5. 写入要凑批量

每批几千行、单批不超过 2MB,比逐点写快一个数量级

6. 备份覆盖元数据

restore 会覆盖现有资源,恢复演练务必用 --new-bucket

共 150 条 InfluxDB 命令 · 示例中的组织 myorg、桶 mybucket 与地址请替换为实际环境

关于InfluxDB命令速查

在线 InfluxDB 命令速查手册,按服务与启停、CLI 与连接配置、组织桶与令牌、写入数据、Flux 查询、Flux 常用函数、v1 兼容与 InfluxQL、备份恢复与导出、任务与告警、监控与离线检查、性能与基数治理、常见报错与排查等 12 类场景整理 140+ 条常用命令与表达式,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 influxd version/config/upgrade/run 与 8086/8088 端口与 /health、influx setup 与 config create/list/set/remove 与 INFLUX_HOST/INFLUX_TOKEN/INFLUX_ORG/INFLUX_BUCKET 环境变量与 influx ping、org create/list/find 与 bucket create 的 -r 保留期与 --shard-group-duration 与 bucket list/update/delete 与 auth create 的 --read-bucket/--write-bucket/--all-access 与 influx delete 的 --start/--stop、influx write 的行协议与 -p 精度与 dryrun 与 --format csv 与 --rate-limit 与 --errors-file 与 /api/v2/write 与 /write 兼容接口、influx query 的 from/range/filter 与 -f 与 --raw 与 --profiler 与 /api/v2/query、Flux 的 aggregateWindow/group/derivative/difference/increase/rate/pivot/join/union/keep/drop/map/sort/limit/yield/first/last、v1 dbrp create/list/delete 与 v1 auth 与 /query 的 SHOW MEASUREMENTS/SHOW TAG KEYS、influx backup/restore 与 --new-bucket 与 influx export all/bucket/task 与 influx apply、influx task create/list/find/update/log/run list/retry/delete 与 option task 与 _monitoring 告警、/metrics 与 /debug/vars 与 influxd inspect 的 report-tsm/report-tsi/export-lp/dump-wal/build-tsi/verify-seriesfile,以及 401 Unauthorized、403 Forbidden、bucket not found、organization not found、field type conflict、points beyond retention policy、413 Request Entity Too Large、query timeout、database not found 等报错排查。适用于 InfluxDB 时序数据库部署与运维、行协议写入与批量导入、Flux 查询与降采样任务、v1 到 v2 迁移与 InfluxQL 兼容、令牌与桶权限治理、备份恢复与导出模板、基数与保留期优化,以及监控运维与面试复习。

核心能力

  • 涵盖 influxd version/config/upgrade/run 与 8086/8088 端口与 /health、influx setup 与 config create/list/set/remove 与 INFLUX_HOST/INFLUX_TOKEN/INFLUX_ORG/INFLUX_BUCKET 环境变量与 influx ping、org create/list/find 与 bucket create 的 -r 保留期与 --shard-group-duration 与 bucket list/update/delete 与 auth create 的 --read-bucket/--write-bucket/--all-access 与 influx delete 的 --start/--stop、influx write 的行协议与 -p 精度与 dryrun 与 --format csv 与 --rate-limit 与 --errors-file 与 /api/v2/write 与 /write 兼容接口、influx query 的 from/range/filter 与 -f 与 --raw 与 --profiler 与 /api/v2/query、Flux 的 aggregateWindow/group/derivative/difference/increase/rate/pivot/join/union/keep/drop/map/sort/limit/yield/first/last、v1 dbrp create/list/delete 与 v1 auth 与 /query 的 SHOW MEASUREMENTS/SHOW TAG KEYS、influx backup/restore 与 --new-bucket 与 influx export all/bucket/task 与 influx apply、influx task create/list/find/update/log/run list/retry/delete 与 option task 与 _monitoring 告警、/metrics 与 /debug/vars 与 influxd inspect 的 report-tsm/report-tsi/export-lp/dump-wal/build-tsi/verify-seriesfile,以及 401 Unauthorized、403 Forbidden、bucket not found、organization not found、field type conflict、points beyond retention policy、413 Request Entity Too Large、query timeout、database not found 等报错排查

适用场景

适用于 InfluxDB 时序数据库部署与运维、行协议写入与批量导入、Flux 查询与降采样任务、v1 到 v2 迁移与 InfluxQL 兼容、令牌与桶权限治理、备份恢复与导出模板、基数与保留期优化,以及监控运维与面试复习。InfluxDB命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。

常见问题

InfluxDB命令速查是免费的吗?需要注册或安装吗?
InfluxDB命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
InfluxDB命令速查支持哪些功能?
涵盖 influxd version/config/upgrade/run 与 8086/8088 端口与 /health、influx setup 与 config create/list/set/remove 与 INFLUX_HOST/INFLUX_TOKEN/INFLUX_ORG/INFLUX_BUCKET 环境变量与 influx ping、org create/list/find 与 bucket create 的 -r 保留期与 --shard-group-duration 与 bucket list/update/delete 与 auth create 的 --read-bucket/--write-bucket/--all-access 与 influx delete 的 --start/--stop、influx write 的行协议与 -p 精度与 dryrun 与 --format csv 与 --rate-limit 与 --errors-file 与 /api/v2/write 与 /write 兼容接口、influx query 的 from/range/filter 与 -f 与 --raw 与 --profiler 与 /api/v2/query、Flux 的 aggregateWindow/group/derivative/difference/increase/rate/pivot/join/union/keep/drop/map/sort/limit/yield/first/last、v1 dbrp create/list/delete 与 v1 auth 与 /query 的 SHOW MEASUREMENTS/SHOW TAG KEYS、influx backup/restore 与 --new-bucket 与 influx export all/bucket/task 与 influx apply、influx task create/list/find/update/log/run list/retry/delete 与 option task 与 _monitoring 告警、/metrics 与 /debug/vars 与 influxd inspect 的 report-tsm/report-tsi/export-lp/dump-wal/build-tsi/verify-seriesfile,以及 401 Unauthorized、403 Forbidden、bucket not found、organization not found、field type conflict、points beyond retention policy、413 Request Entity Too Large、query timeout、database not found 等报错排查。
InfluxDB命令速查适合哪些场景使用?
适用于 InfluxDB 时序数据库部署与运维、行协议写入与批量导入、Flux 查询与降采样任务、v1 到 v2 迁移与 InfluxQL 兼容、令牌与桶权限治理、备份恢复与导出模板、基数与保留期优化,以及监控运维与面试复习。