openitcockpit/victoria-metrics

VictoriaMetrics for openITCOCKPIT Docker镜像文档

镜像概述和主要用途

本Docker镜像是基于官方 https://hub.docker.com/r/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：

bash
docker run -d \
  --name victoriametrics-openitcockpit \
  -p 8428:8428 \
  -v /path/to/vmdata:/victoria-metrics-data \
  --restart unless-stopped \
  docker.xuanyuan.run/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集成此镜像：

yaml
version: '3.8'

services:
  victoriametrics:
    image: docker.xuanyuan.run/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字段覆盖。常用配置项如下：

完整环境变量列表可参考https://docs.victoriametrics.com/#environment-variables%EF%BC%8C%E6%9C%AC%E9%95%9C%E5%83%8F%E9%BB%98%E8%AE%A4%E5%80%BC%E5%B7%B2%E9%92%88%E5%AF%B9openITCOCKPIT%E5%9C%BA%E6%99%AF%E4%BC%98%E5%8C%96%EF%BC%8C%E9%9D%9E%E5%BF%85%E8%A6%81%E4%B8%8D%E5%BB%BA%E8%AE%AE%E4%BF%AE%E6%94%B9%E3%80%82

数据备份与迁移

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

注意事项

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