VictoriaMetrics for openITCOCKPIT Docker镜像文档

镜像概述和主要用途

本Docker镜像是基于官方 victoriametrics/victoria-metrics 镜像构建，针对openITCOCKPIT监控系统进行了优化。镜像预设了所有必要环境变量的默认值，简化了与openITCOCKPIT集成的配置流程。其核心用途是作为openITCOCKPIT的时序数据库后端，提供高效的监控数据存储、查询和分析能力。

核心功能和特性

基础功能（继承自VictoriaMetrics）

• 高性能时序数据处理：支持每秒数百万级数据点写入，查询响应延迟低至毫秒级
• 低成本存储：采用高压缩算法，存储成本仅为传统时序数据库的1/10~1/20
• 兼容性：完全兼容Prometheus查询API和数据格式，支持PromQL
• 高可用性：支持数据副本和集群部署，保障数据可靠性
• 长时序数据保留：支持自定义数据保留周期，满足长期监控数据分析需求

镜像特有优化

• 预设环境变量：内置openITCOCKPIT集成所需的默认配置，减少手动配置步骤
• 无缝集成：与openITCOCKPIT监控系统的数据流和查询逻辑深度适配
• 即开即用：无需额外配置即可直接作为openITCOCKPIT的后端存储服务

使用场景和适用范围

适用场景

• 作为openITCOCKPIT监控系统的时序数据库后端，存储和查询监控指标数据
• 为openITCOCKPIT提供高可用、低成本的历史数据归档和实时查询能力

适用范围

• 仅限openITCOCKPIT用户：专为openITCOCKPIT设计，非openITCOCKPIT场景建议使用官方VictoriaMetrics镜像
• 中小规模监控场景：适用于监控节点数≤1000、指标量≤100万/秒的环境（大规模场景需参考VictoriaMetrics官方集群方案）

使用方法和配置说明

基本使用（docker run命令）

通过以下命令快速启动镜像，默认配置已适配openITCOCKPIT：

docker run -d \
  --name victoriametrics-openitcockpit \
  -p 8428:8428 \
  -v /path/to/vmdata:/victoria-metrics-data \
  --restart unless-stopped \
  openitcockpit/victoriametrics:latest

参数说明：

• -p 8428:8428：映射VictoriaMetrics默认HTTP端口（openITCOCKPIT默认通过此端口通信）
• -v /path/to/vmdata:/victoria-metrics-data：挂载数据卷，持久化存储时序数据（需替换/path/to/vmdata为本地目录）
• --restart unless-stopped：容器退出时自动重启（保障服务可用性）

Docker Compose配置示例

在openITCOCKPIT部署环境中，可通过docker-compose.yml集成此镜像：

version: '3.8'

services:
  victoriametrics:
    image: openitcockpit/victoriametrics:latest
    container_name: victoriametrics-openitcockpit
    ports:
      - "8428:8428"
    volumes:
      - vmdata:/victoria-metrics-data
    environment:
      # 可选：覆盖默认环境变量（以下为示例，默认值已适配openITCOCKPIT）
      - VM_STORAGE_DATA_RETENTION_PERIOD=30d  # 数据保留期（默认30天）
      - VM_CACHE_SIZE_GB=1  # 内存缓存大小（默认1GB，根据服务器配置调整）
    restart: unless-stopped

volumes:
  vmdata:  # 命名卷，数据持久化存储

启动命令：docker-compose up -d

环境变量配置说明

镜像预设了适配openITCOCKPIT的环境变量默认值，用户可通过-e参数或environment字段覆盖。常用配置项如下：

完整环境变量列表可参考VictoriaMetrics官方文档，本镜像默认值已针对openITCOCKPIT场景优化，非必要不建议修改。

数据备份与迁移

1. 备份：直接复制挂载卷目录（/path/to/vmdata）即可完成数据备份
2. 迁移：将备份的vmdata目录复制到新服务器，通过相同挂载路径启动容器即可恢复数据

注意事项

• 非openITCOCKPIT场景：本镜像仅用于openITCOCKPIT集成，其他场景请使用官方VictoriaMetrics镜像
• 版本兼容性：需确保镜像版本与openITCOCKPIT版本匹配（具体参考openITCOCKPIT官方部署文档）
• 资源配置：生产环境建议服务器配置≥2核4GB内存，数据盘IOPS≥100（机械盘可能导致写入延迟升高）