VictoriaMetrics Cluster 镜像文档

概述

VictoriaMetrics Cluster 是一个分布式时间序列数据库集群解决方案，由三个核心服务组件构成，各组件可独立水平扩展，共同提供高效的时间序列数据写入、存储和查询能力。该集群专为处理大规模时间序列数据设计，适用于需要高可用性、可扩展性和高性能的监控、日志分析等场景。

核心组件

VictoriaMetrics Cluster 的功能由以下三个独立组件协同实现：

vminsert

• 功能：接收外部传入的时间序列数据，根据一致性哈希算法将数据路由至相应的 vmstorage 节点进行存储。
• 特点：无状态服务，可通过增加实例数线性扩展数据接收能力。

vmselect

• 功能：接收客户端查询请求，从所有 vmstorage 节点并行获取数据，合并并处理查询结果后返回给客户端。
• 特点：无状态服务，可通过增加实例数提升查询并发能力和处理性能。

vmstorage

• 功能：负责时间序列数据的持久化存储，处理来自 vminsert 的写入请求和 vmselect 的查询请求。
• 特点：有状态服务，存储实际数据，可通过增加节点扩展存储容量和读写吞吐量。

使用场景

VictoriaMetrics Cluster 适用于以下场景：

• 大规模时间序列数据采集与存储（如监控指标、物联网传感器数据、日志时序数据）
• 需要高可用性和水平扩展能力的企业级监控系统
• 对查询响应速度有要求的实时数据分析平台
• 云原生环境下的分布式 metrics 存储解决方案

使用方法

前提条件

• 已安装 Docker 环境
• 确保各组件之间网络互通（可通过 Docker 网络或主机网络实现）

Docker 运行示例

1. 启动 vmstorage

docker run -d \
  --name vmstorage \
  -p 8482:8482 \  # HTTP API端口（用于健康检查等）
  -p 8400:8400 \  # 接收vminsert写入请求的内部端口
  -p 8401:8401 \  # 接收vmselect查询请求的内部端口
  -v /path/to/vmdata-cluster:/storage \  # 挂载数据目录（宿主机路径需替换为实际路径）
  victoriametrics/vmstorage:latest \
  -storageDataPath=/storage \  # 容器内数据存储路径（需与挂载路径对应）
  -vminsertAddr=:8400 \  # 监听vminsert请求的地址
  -vmselectAddr=:8401 \  # 监听vmselect请求的地址
  -retentionPeriod=30d  # 数据保留期（可选，默认值可能不同，单位支持d/h/m/s）

2. 启动 vminsert

docker run -d \
  --name vminsert \
  -p 8480:8480 \  # 数据接收端口（支持Prometheus、InfluxDB等协议）
  victoriametrics/vminsert:latest \
  -storageNode=vmstorage:8400  # vmstorage节点地址（格式：<主机名或IP>:<vminsertAddr端口>，多节点可重复指定）

3. 启动 vmselect

docker run -d \
  --name vmselect \
  -p 8481:8481 \  # 查询端口（支持PromQL等查询语言）
  victoriametrics/vmselect:latest \
  -storageNode=vmstorage:8401  # vmstorage节点地址（格式：<主机名或IP>:<vmselectAddr端口>，多节点可重复指定）

Docker Compose 配置示例

创建 docker-compose.yml 文件统一管理组件：

version: '3'

services:
  vmstorage:
    image: victoriametrics/vmstorage:latest
    container_name: vmstorage
    ports:
      - "8482:8482"
      - "8400:8400"
      - "8401:8401"
    volumes:
      - /path/to/vmdata-cluster:/storage  # 替换为宿主机实际数据目录
    command:
      - -storageDataPath=/storage
      - -vminsertAddr=:8400
      - -vmselectAddr=:8401
      - -retentionPeriod=30d
    restart: always

  vminsert:
    image: victoriametrics/vminsert:latest
    container_name: vminsert
    ports:
      - "8480:8480"
    command:
      - -storageNode=vmstorage:8400  # 多vmstorage节点可添加多个-storageNode参数
    depends_on:
      - vmstorage
    restart: always

  vmselect:
    image: victoriametrics/vmselect:latest
    container_name: vmselect
    ports:
      - "8481:8481"
    command:
      - -storageNode=vmstorage:8401  # 注意端口对应vmstorage的vmselectAddr
    depends_on:
      - vmstorage
    restart: always

启动集群：docker-compose up -d

配置参数

vmstorage 核心参数

vminsert 核心参数

vmselect 核心参数

获取帮助

使用中遇到问题可通过以下渠道获取支持：

• Slack 社区：加入 VictoriaMetrics 社区 Slack
• GitHub 讨论：在 GitHub Discussions 提问
• Bug 报告：在 GitHub Issues 提交问题

源码地址

各组件源代码托管于 GitHub：

• vminsert：[***]
• vmselect：[***]
• vmstorage：[***]