Bitnami VictoriaMetrics 文档

镜像概述和主要用途

VictoriaMetrics 是一款快速、经济高效且可扩展的监控解决方案和时序数据库，兼容 Prometheus 和 Graphite。Bitnami 提供的 VictoriaMetrics Helm Chart 用于在 Kubernetes 集群上快速部署和管理 VictoriaMetrics，简化其核心组件（vminsert、vmstorage、vmselect）及可选组件（vmauth、vmalert、vmagent）的部署流程，适用于开发、测试和生产环境。

核心功能和特性

VictoriaMetrics 核心功能

• 高性能：优化的时序数据存储和查询引擎，支持高吞吐量写入和快速查询
• 成本效益：高效的数据压缩算法，降低存储成本
• 可扩展性：支持水平扩展，通过集群模式（vminsert、vmstorage、vmselect）处理大规模数据
• 兼容性：完全兼容 Prometheus API 和 Graphite 协议，支持现有监控工具集成
• 可靠性：数据复制和自动故障转移机制，确保数据可用性

Bitnami Helm Chart 特性

• 组件化部署：默认部署核心组件（vminsert、vmstorage、vmselect），可选启用 vmauth、vmalert、vmagent
• 资源管理：支持自定义资源请求/限制，提供资源预设（resourcesPreset）简化配置
• 监控集成：可配置 Prometheus 指标暴露，支持 ServiceMonitor 集成（适用于 Prometheus Operator）
• 网络配置：支持 Ingress 资源，实现外部访问和 TLS 加密
• 安全加固：遵循容器安全最佳实践，支持适配 OpenShift 安全上下文
• 灵活配置：通过环境变量（envflag）自定义 VictoriaMetrics 参数，支持日志格式配置

使用场景和适用范围

适用场景

• 大规模时序数据存储：需处理高并发写入（如每秒数十万指标）的监控系统
• Prometheus 替代/扩展：作为 Prometheus 的长期存储解决方案，或直接替代 Prometheus 部署
• 基础设施监控：监控服务器、容器、Kubernetes 集群等基础设施指标
• 应用性能监控：收集和分析应用程序性能指标（如响应时间、错误率）
• DevOps 工作流：集成到 CI/CD 流程中，提供监控数据支持问题排查和性能优化

适用环境

• Kubernetes 集群（1.23+ 版本）
• 开发/测试环境：使用 Helm Chart 快速部署，支持最新标签镜像
• 生产环境：建议使用 Bitnami Secure Images（2025 年 8 月 28 日后），获取安全加固和长期支持

详细使用方法和配置说明

前提条件

• Kubernetes 集群版本 1.23+
• Helm 3.8.0+
• 集群支持持久卷（PV）供应（用于 vmstorage 数据持久化）

安装步骤

快速安装（TL;DR）

console
helm install my-release oci://registry-1.docker.io/bitnamicharts/victoriametrics

标准安装流程

1. 添加 Bitnami Helm 仓库（如需自定义仓库）：

   console
   helm repo add bitnami [***]
   helm repo update
   

2. 安装 Helm Chart：

   console
   helm install my-release bitnami/victoriametrics
   

   替换 my-release 为自定义发布名称，如需指定镜像仓库，使用 --set vmselect.image.registry=REGISTRY_NAME 等参数。

配置详情

组件启用与管理

• 核心组件：默认自动部署 vminsert、vmstorage、vmselect
• 可选组件：通过参数启用：
  • vmauth：--set vmauth.enabled=true
  • vmalert：--set vmalert.enabled=true
  • vmagent：--set vmagent.enabled=true

资源配置

• 资源请求/限制：直接配置 resources 参数（推荐生产环境）：

  yaml
  vmstorage:
    resources:
      requests:
        cpu: 2
        memory: 4Gi
      limits:
        cpu: 4
        memory: 8Gi
  

• 资源预设：使用 resourcesPreset 快速配置（开发环境）：

  console
  helm install my-release bitnami/victoriametrics --set vmstorage.resourcesPreset=medium
  

  预设值参考 bitnami/common chart

Prometheus 监控集成

1. 启用指标暴露：为组件配置 *.metrics.enabled=true，例如：

   yaml
   vmselect:
     metrics:
       enabled: true
       service:
         type: ClusterIP
         port: 8481
   

2. Prometheus Operator 集成：启用 ServiceMonitor：

   yaml
   vmselect:
     metrics:
       serviceMonitor:
         enabled: true
         namespace: monitoring
         interval: 15s
   

Ingress 与外部访问

1. 启用 Ingress（以 vmselect 为例）：

   yaml
   vmselect:
     ingress:
       enabled: true
       hostname: vmselect.example.com
       tls: true
       annotations:
         kubernetes.io/ingress.class: nginx
   

2. TLS 配置：

   • 自动生成证书：通过 *.ingress.secrets 指定证书内容：

     yaml
     vmselect:
       ingress:
         secrets:
           - name: vmselect-tls
             certificate: |
               -----BEGIN CERTIFICATE-----
               ...
               -----END CERTIFICATE-----
             key: |
               -----BEGIN RSA PRIVATE KEY-----
               ...
               -----END RSA PRIVATE KEY-----
     

   • 外部证书：手动创建 TLS 密钥（名称格式：${hostname}-tls）：

     console
     kubectl create secret tls vmselect-example-com-tls --cert=path/to/cert.pem --key=path/to/key.pem
     

   • cert-manager 集成：添加 cert-manager 注解：

     yaml
     vmselect:
       ingress:
         annotations:
           cert-manager.io/cluster-issuer: letsencrypt-prod
     

备份与恢复

使用 Velero 备份持久卷数据：

1. 安装 Velero 并配置存储后端（如 S3）。
2. 创建备份：

   console
   velero backup create vm-backup --include-resources pvc,pv --selector app.kubernetes.io/instance=my-release
   

3. 恢复备份：

   console
   velero restore create --from-backup vm-backup
   

Docker 部署示例（非 Helm）

Bitnami 提供独立 Docker 镜像（如 vmselect、vmstorage、vminsert），可直接通过 docker run 部署（适用于非 Kubernetes 环境）：

部署 vmstorage（数据存储组件）

console
docker run -d \
  --name vmstorage \
  -p 8482:8482 \
  -v vmstorage-data:/bitnami/vmstorage \
  -e VM_STORAGE_DATA_PATH=/bitnami/vmstorage \
  -e VM_LOGGER_FORMAT=json \
  docker.io/bitnami/victoriametrics-vmstorage:latest

部署 vmselect（查询组件）

console
docker run -d \
  --name vmselect \
  -p 8481:8481 \
  -e VM_SELECT_STORAGE_ENTPOINTS=vmstorage:8482 \  # 连接 vmstorage 实例
  -e VM_LOGGER_FORMAT=json \
  docker.io/bitnami/victoriametrics-vmselect:latest

部署 vminsert（写入组件）

console
docker run -d \
  --name vminsert \
  -p 8480:8480 \
  -e VM_INSERT_STORAGE_ENTPOINTS=vmstorage:8482 \  # 连接 vmstorage 实例
  -e VM_LOGGER_FORMAT=json \
  docker.io/bitnami/victoriametrics-vminsert:latest

注：Docker 部署需手动管理组件间网络（如使用 --link 或 Docker Compose），生产环境建议优先使用 Kubernetes + Helm。

配置参数参考

全局参数

VictoriaMetrics 通用参数

vmselect 组件参数（示例）

完整参数列表见 Bitnami VictoriaMetrics Chart 文档

⚠️ 重要通知：Bitnami 镜像目录即将变更

自 2025 年 8 月 28 日起，Bitnami 将升级公共镜像目录，推出 Bitnami Secure Images 计划，主要变更如下：

• 安全优化镜像：首次向社区用户开放安全加固版容器镜像。
• 非加固镜像逐步弃用：免费 tier 将逐步停止支持非加固 Debian 基础镜像，公共目录仅保留少量“latest”标签的加固镜像（用于开发）。
• 旧镜像迁移：所有现有镜像（含历史版本标签，如 2.50.0）将在两周内迁移至 docker.io/bitnamilegacy 仓库，不再更新。
• 生产环境建议：生产 workload 推荐使用 Bitnami Secure Images，包含安全加固、SBOM、CVE 透明度（VEX/KEV）和企业支持。

详情见 Bitnami Secure Images 公告。