小岳
2026-11-18
点 赞
0
热 度
1
评 论
0

一万八千星的时序库怎么上手

  1. 首页
  2. 开源分享
  3. 一万八千星的时序库怎么上手

文章摘要

摸鱼小助手

凌晨一点,值机的同事发来一张截图: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 这类分布式远端存储;替不掉的是多副本冗余与跨地域部署——单机版就是一个进程,盘坏了数据就没了,真要高可用得换它的集群版,或者自己另做备份。

VictoriaMetrics 数据流:采集端、写入端点、存储进程与查询界面

核心机制

  1. 单二进制、零依赖,全部配置走命令行参数(README 原文:No dependencies, single small binary)。推断:作者刻意把部署成本压到最低,运维只需要盯住一个进程。
  2. 入口多协议:Prometheus remote write、InfluxDB line protocol、Graphite、OpenTSDB、OpenTelemetry 都能写(README 各协议小节)。推断:它不做采集端,专心做存储与查询,采集继续用你手上的老工具。
  3. 数据列式压缩落盘。README 基准页称同容量磁盘可比 TimescaleDB 多存 70 倍数据点、比 Prometheus 省约 7 倍空间。推断:官方数字是自测口径,真实收益取决于你的标签设计,建议先拿小样本压一遍再下结论。
  4. 查询语言 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"

从零到能用

  1. 跑上面的 docker 命令,docker ps 确认容器状态是 Up。
  2. 浏览器打开 http://127.0.0.1:8428/vmui ,这是自带查询界面。
  3. 粘贴 curl 写入命令,返回 204 即写入成功。
  4. 回到 vmui,查询框输入 mem_usage,能看到刚才那条数据。
  5. 正式接数据:把 Prometheus 的 remote_write 地址改成 http://你的服务器IP:8428/api/v1/write ,重载配置即可。
  6. 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(同一仓库)

本站站长,主角光环,怎么滴,你还想攻击你的站长吗,真是好big的狗胆

小岳

intp 逻辑家

站长

不具版权性
不具时效性

文章内容不具时效性。若文章内容有错误之处,请您批评指正。

目录

欢迎来到摸鱼干货栈,这里为您提供开源与摸鱼源码

43 文章数
7 分类数
0 评论数
47标签数
最近评论