凌晨一点,值机的同事发来一张截图:Prometheus 那台机器的磁盘又满了,三个月的监控曲线撑爆了硬盘。换更大的盘是治标,真正该做的是找一个更省空间的时序库。VictoriaMetrics 就是干这个的:一个 Apache-2.0 协议的开源时序数据库,官方基准称同样的磁盘能比 Prometheus 多存 7 倍数据点。这篇文章带你从一条 docker 命令开始,今晚就把它跑起来。
项目名片
| 项目 | 内容 |
|---|---|
| 仓库 | VictoriaMetrics/VictoriaMetrics |
| Star / Fork | 18122 / 1812(2026-11-18 抓取) |
| 技术栈 | Go,单二进制,无外部依赖 |
| 许可证 | Apache-2.0(LICENSE 原文已核) |
| 最新版本 | v1.156.0(2026-11-09 发布) |
| 默认端口 | 8428(HTTP),自带界面在 /vmui |
| 最近提交 | 2026-11-17(master 分支) |
它解决什么问题
监控数据的麻烦在于三点叠加:采样频率高、标签组合多、保存周期长。Prometheus 的本地存储一般只留两周,想存得更久就得外挂远端存储,而常见方案动辄要拉起一小组服务才能用。VictoriaMetrics 把远端存储做成了一个进程:起一个容器,暴露 8428 端口,Prometheus、vmagent、InfluxDB 客户端都能直接往里写。
某些场景它可以替代 Thanos 这类分布式远端存储;替不掉的是多副本冗余与跨地域部署——单机版就是一个进程,盘坏了数据就没了,真要高可用得换它的集群版,或者自己另做备份。
核心机制
- 单二进制、零依赖,全部配置走命令行参数(README 原文:No dependencies, single small binary)。推断:作者刻意把部署成本压到最低,运维只需要盯住一个进程。
- 入口多协议:Prometheus remote write、InfluxDB line protocol、Graphite、OpenTSDB、OpenTelemetry 都能写(README 各协议小节)。推断:它不做采集端,专心做存储与查询,采集继续用你手上的老工具。
- 数据列式压缩落盘。README 基准页称同容量磁盘可比 TimescaleDB 多存 70 倍数据点、比 Prometheus 省约 7 倍空间。推断:官方数字是自测口径,真实收益取决于你的标签设计,建议先拿小样本压一遍再下结论。
- 查询语言 MetricsQL 兼容 PromQL(README)。推断:Grafana 上已有的 Prometheus 数据源面板,多数不用改表达式就能平移过来。
跑起来
一条命令,数据挂在命名卷 vmdata 里,保留 6 个月:
IMG=victoriametrics/victoria-metrics
TAG=v1.156.0
docker run -d --name vm -p 8428:8428 \
-v vmdata:/victoria-metrics-data \
$IMG:$TAG -retentionPeriod=6
-retentionPeriod=6 表示过期数据自动删除,默认是 1 个月(31 天),最小 24h(官方单机文档)。只想随手试一把,就把最后这行参数删掉。
写一条测试指标,走 Prometheus 写入接口:
URL=http://127.0.0.1:8428
curl -s -X POST $URL/api/v1/write \
-d 'mem_usage{host="A1"} 42'
curl -s "$URL/api/v1/query?query=mem_usage"
从零到能用
- 跑上面的 docker 命令,docker ps 确认容器状态是 Up。
- 浏览器打开 http://127.0.0.1:8428/vmui ,这是自带查询界面。
- 粘贴 curl 写入命令,返回 204 即写入成功。
- 回到 vmui,查询框输入 mem_usage,能看到刚才那条数据。
- 正式接数据:把 Prometheus 的 remote_write 地址改成 http://你的服务器IP:8428/api/v1/write ,重载配置即可。
- Grafana 新建 Prometheus 数据源,URL 填同一个地址,原来的监控面板直接复用。
适合谁用 / 别用
适合:被 Prometheus 本地磁盘两周上限逼着找远端存储的人;想把服务器指标、设备传感器读数、电表数据统一收进一个库的人。这段经历写进简历也成立:为公司监控接入远端时序存储,并完成旧面板迁移。
别用:指望一个库同时管日志和链路的,它只负责指标;数据量小到两周本地盘都填不满的,Prometheus 原生就够,多搬一层只会多一个要维护的东西。
三个真实的坑
坑一:只有按时间的保留,没有按磁盘大小的保留。官方文档只给了 -retentionPeriod 这个按时间删数据的参数,按容量上限自动清理的需求挂在 issue #342(add a limit for the disk storage size (retention size))里,多年未实现。缓解办法:给磁盘配告警,保留周期按盘容量倒推着设。
坑二:标签基数失控会拖垮后台合并。issue #10440 记录了高基数场景下后台合并把内存吃穿直至 OOM 的案例。别把时间戳、请求 ID 这类唯一值塞进标签;README 提到内置 cardinality limiter,正式接入前建议先配一个上限。
坑三:vmagent 扩缩容时可能写出乱序样本。issue #4038 讨论的正是这个场景,README 的 deduplication 章节给出的解法是配 -dedup.minScrapeInterval,让重复与乱序数据点在落盘时被收敛。采集端要横向扩容之前,先把这行参数加上。
小结
回到开头那张磁盘告警截图:把写入端指向 8428、保留周期按盘算清楚、标签收干净,这台小机器就能把三个月的曲线安安稳稳存下来。一条 docker 命令的成本,换一个不天天喊磁盘满的监控系统,这笔账值得算。
参考资料
- 仓库与 README:https://github.com/VictoriaMetrics/VictoriaMetrics
- 单机版文档:https://docs.victoriametrics.com/victoriametrics/single-server-victoriametrics/
- v1.156.0 发布页:https://github.com/VictoriaMetrics/VictoriaMetrics/releases/tag/v1.156.0
- 三个坑的出处:issues #342、#10440、#4038(同一仓库)
默认评论
Halo系统提供的评论