InfluxDB命令速查
服务启停、CLI 配置、组织桶与令牌、行协议写入、Flux 查询、v1 兼容、备份恢复、任务告警与排障等 150 条命令
共 150 条命令 · 12 类场景 · 点击右侧图标可复制
| 命令 / 表达式 | 说明 | 复制 |
|---|---|---|
influxd version | 查看服务端版本 | |
influxd | 前台启动,默认监听 8086 | |
influxd --help | 查看全部启动参数 | |
influxd config | 打印当前生效配置,排查参数来源 | |
influxd --config /etc/influxdb/config.toml | 指定配置文件启动 | |
systemctl start influxdb | systemd 部署方式启动 | |
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_TOKEN | 2.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/v1 | 1.x 便携备份(仅 v1 可用) | |
influxd restore -portable /backup/v1 | 1.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 桶与 checks | 2.x 告警通过 /api/v2/checks 与 notificationRules 配置 | |
任务写入目标桶要注意保留期 | 源桶数据被清理后任务会查不到数据 |
| 命令 / 表达式 | 说明 | 复制 |
|---|---|---|
curl -s http://localhost:8086/metrics | head | Prometheus 格式指标 | |
curl -s http://localhost:8086/metrics | grep influxdb_http | HTTP 请求量与错误率 | |
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 与 filter | Flux 先裁剪时间再过滤标签,避免全桶扫描 | |
aggregateWindow 放在 filter 之后 | 减少聚合的数据量 | |
避免把高基数值作为 tag | trace_id、user_id 应放 field 或改写标签结构 | |
influx query --profiler query | 看 Flux 各算子耗时,定位瓶颈 | |
批量写入优先于逐点写入 | 每批 5000 行左右,兼顾吞吐与失败重试成本 | |
influx write --rate-limit | 限制写入速率,避免打满 IO |
| 命令 / 表达式 | 说明 | 复制 |
|---|---|---|
401 Unauthorized / authorization failed | Token 无效、过期或缺少对应桶权限 | |
403 Forbidden | Token 权限不足,检查 auth 的读写范围 | |
bucket not found | 桶名或 ID 错误,也可能 Token 无该桶权限 | |
organization not found | org 名称与 Token 绑定的组织不一致 | |
failed to initialize execute state: could not find bucket | Flux 中桶名写错或未指定 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 found | v1 接口访问未建立 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 → 校验数据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
相关工具
Linux命令速查
文件、文本、权限、进程、网络、磁盘、systemd与防火墙等 Linux 常用命令速查手册
Docker命令速查
镜像、容器、网络、数据卷、Compose、Swarm、清理与排障等 Docker 常用命令速查手册
Nginx命令速查
服务管理、配置指令、反向代理、HTTPS、限流缓存、日志排查等 Nginx 常用命令速查手册
K8S命令速查
集群上下文、Pod调试、工作负载、Service与Ingress、存储、权限、排障等 kubectl 常用命令速查手册
Windows CMD命令速查
文件目录、网络诊断、进程服务、系统信息、用户权限、注册表、批处理等 Windows CMD 常用命令速查手册
systemctl服务管理速查
服务启停、开机自启、unit文件编写、日志查看、定时器、依赖分析与排障等 systemctl 命令速查手册
关于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 兼容、令牌与桶权限治理、备份恢复与导出模板、基数与保留期优化,以及监控运维与面试复习。