VictoriaMetrics Cluster 镜像文档

镜像概述和主要用途

VictoriaMetrics Cluster 是一个高性能、可扩展的时序数据库集群解决方案，由三个独立扩展的核心服务组成：

• vminsert: 接收传入的数据并将其路由到 vmstorage 节点
• vmselect: 接收查询请求，从所有 vmstorage 节点获取数据并合并结果
• vmstorage: 存储时序数据并处理来自 vminsert 和 vmselect 的请求

该集群架构允许每个组件独立扩展，以满足不同场景下的性能需求，适用于大规模时序数据的存储和查询场景。

核心功能和特性

• 独立扩展能力: 三个核心组件可根据需求独立水平扩展
• 高可用性: 分布式架构确保系统无单点故障
• 高性能: 优化的存储引擎提供高效的数据写入和查询性能
• 灵活的数据路由: vminsert 智能路由数据到适当的存储节点
• 分布式查询处理: vmselect 聚合多个存储节点的数据提供统一结果

使用场景和适用范围

• 大规模监控系统的数据存储和查询
• DevOps 和 SRE 监控基础设施
• IoT 设备数据采集与分析
• 实时分析系统
• 需要长期存储和快速查询时序数据的场景
• 对可用性和可扩展性有高要求的企业级应用

详细的使用方法和配置说明

Docker 拉取命令

推荐指定具体版本标签而非使用 latest：

bash
# 拉取 vminsert 镜像
docker pull victoriametrics/vminsert:{TAG}

# 拉取 vmselect 镜像
docker pull victoriametrics/vmselect:{TAG}

# 拉取 vmstorage 镜像
docker pull victoriametrics/vmstorage:{TAG}

基本部署示例

运行集群需要将三个组件网络连接在一起，以下是简化示例：

1. 运行 vmstorage

bash
docker run -d --name vmstorage \
  -p 8482:8482 \
  -p 8400:8400 \
  -p 8401:8401 \
  -v /path/to/vmdata-cluster:/storage \
  victoriametrics/vmstorage:latest \
  -storageDataPath=/storage \
  -vminsertAddr=:8400 \
  -vmselectAddr=:8401

2. 运行 vminsert

bash
docker run -d --name vminsert \
  -p 8480:8480 \
  victoriametrics/vminsert:latest \
  -storageNode=vmstorage:8400

3. 运行 vmselect

bash
docker run -d --name vmselect \
  -p 8481:8481 \
  victoriametrics/vmselect:latest \
  -storageNode=vmstorage:8400

Docker Compose 部署示例

创建 docker-compose.yml 文件：

yaml
version: '3.8'

services:
  vmstorage:
    image: victoriametrics/vmstorage:latest
    volumes:
      - ./vmdata-cluster:/storage
    ports:
      - "8482:8482"
      - "8400:8400"
      - "8401:8401"
    command:
      - -storageDataPath=/storage
      - -vminsertAddr=:8400
      - -vmselectAddr=:8401
    restart: always

  vminsert:
    image: victoriametrics/vminsert:latest
    ports:
      - "8480:8480"
    command:
      - -storageNode=vmstorage:8400
    depends_on:
      - vmstorage
    restart: always

  vmselect:
    image: victoriametrics/vmselect:latest
    ports:
      - "8481:8481"
    command:
      - -storageNode=vmstorage:8400
    depends_on:
      - vmstorage
    restart: always

启动集群：

bash
docker-compose up -d

配置参数说明

通用参数

vmstorage 特有参数

vminsert 特有参数

vmselect 特有参数

网络端口说明

获得帮助

如果有任何问题，请联系 VictoriaMetrics 社区获取帮助：

• Slack: 加入社区 Slack
• 社区论坛: 在 GitHub Discussions 提问
• Bug 报告: 在 GitHub 提交 Issue

源代码

各集群组件的源代码可在 VictoriaMetrics GitHub 仓库中找到：

• vminsert: [***]
• vmselect: [***]
• vmstorage: [***]