Bitnami VictoriaMetrics Agent 镜像文档

镜像概述和主要用途

关于 VictoriaMetrics Agent

VictoriaMetrics Agent 是一款快速、经济且可扩展的监控解决方案和时间序列数据库代理，兼容 Prometheus 和 Graphite，用于收集、处理和转发监控指标。

Bitnami 镜像特点

Bitnami 提供的 VictoriaMetrics Agent 镜像属于 Bitnami Secure Images 计划，旨在通过安全优化的容器化方案简化开源软件的部署和使用。

⚠️ 重要通知：Bitnami 镜像仓库变更计划

自 2025 年 8 月 28 日起，Bitnami 将调整其公共镜像仓库策略：

• 非强化版 Debian 基础镜像将逐步停止免费支持，非最新标签（如 2.50.0、10.6）将从 docker.io/bitnami 迁移至 docker.io/bitnamilegacy 仓库，且不再接收更新
• 免费用户可访问的强化版镜像将仅保留 latest 标签，适用于开发环境
• 生产环境建议使用 Bitnami Secure Images，包含强化容器、CVE 透明度（VEX/KEV）、SBOMs 及企业支持

详细信息参见 Bitnami Secure Images 公告。

核心功能和特性

VictoriaMetrics Agent 核心能力

• 兼容 Prometheus 生态，支持 PromQL 查询和远程写入
• 低资源占用，高效处理大量时间序列数据
• 水平扩展能力，适应监控规模增长
• 支持 Graphite 协议，兼容现有监控系统

Bitnami 镜像增强特性

• 安全强化：基于 Photon Linux 构建的最小化操作系统，减少攻击面
• 漏洞透明：通过 VEX/KEV 标准提供 CVE 风险评估，附 EPSS 评分
• 供应链安全：SLSA-3 合规构建流程，提供签名验证（Notation）、SBOMs 和病毒扫描报告
• 持续更新：上游补丁发布后数小时内完成镜像更新，确保安全合规
• 跨平台一致性：容器、虚拟机和云镜像使用统一配置，便于格式切换

使用场景和适用范围

典型应用场景

• 开发环境监控：快速部署轻量级监控代理，收集应用指标
• Prometheus 替代方案：作为 Prometheus Agent 的高效替代品，降低资源消耗
• 分布式监控：在大规模集群中部署，集中收集分散节点的监控数据
• 混合监控系统：同时处理 Prometheus 和 Graphite 协议的指标数据

适用用户

• 需要构建轻量级监控解决方案的开发团队
• 寻求 Prometheus 兼容且资源优化的监控工具的用户
• 关注容器镜像安全性和供应链完整性的企业用户

使用方法和配置说明

获取镜像

推荐从 Docker Hub 拉取预构建镜像：

docker pull bitnami/victoriametrics-vmagent:latest

如需特定版本，可指定标签（注意：2025 年 8 月 28 日后非 latest 标签将迁移至 bitnamilegacy 仓库）：

docker pull bitnami/victoriametrics-vmagent:[TAG]

快速启动

使用以下命令快速启动容器（默认配置）：

docker run --name victoriametrics-vmagent bitnami/victoriametrics-vmagent:latest

详细配置

运行命令参数

通过容器命令行传递 vmagent 配置参数，例如查看帮助信息：

docker run --rm --name victoriametrics-vmagent bitnami/victoriametrics-vmagent:latest -- --help

挂载配置文件

通过挂载卷加载自定义配置文件（如 Prometheus 抓取配置）：

docker run --name victoriametrics-vmagent \
  -v /path/to/prometheus.yml:/etc/vmagent/prometheus.yml \
  bitnami/victoriametrics-vmagent:latest \
  --promscrape.config=/etc/vmagent/prometheus.yml

Docker Compose 部署示例

创建 docker-compose.yml 文件：

version: '3.8'
services:
  victoriametrics-vmagent:
    image: bitnami/victoriametrics-vmagent:latest
    container_name: victoriametrics-vmagent
    ports:
      - "8429:8429"  # 默认 HTTP 端口
    volumes:
      - ./prometheus.yml:/etc/vmagent/prometheus.yml:ro  # 只读挂载配置文件
    command: --promscrape.config=/etc/vmagent/prometheus.yml  # 指定抓取配置
    restart: unless-stopped

启动服务：

docker-compose up -d

配置参考

vmagent 的详细配置参数请参考 官方文档，核心配置项包括：

• --promscrape.config：Prometheus 格式的抓取配置文件路径
• --remoteWrite.url：远程存储写入地址（如 VictoriaMetrics 主实例）
• --httpListenAddr：HTTP 服务监听地址（默认 :8429）
• --memory.allowedPercent：允许使用的系统内存百分比

支持的标签

Bitnami 镜像遵循滚动标签（如 latest）和不可变标签（如 v1.91.0）策略，详情参见 标签政策文档。

注意：2025 年 8 月 28 日后，历史版本标签将迁移至 docker.io/bitnamilegacy 仓库。

非 Root 容器说明

该镜像默认以非 root 用户运行，通过以下机制提升安全性：

• 限制容器内权限，降低恶意代码执行风险
• 符合 Kubernetes 等编排平台的安全最佳实践
• 如需调整用户权限，可通过 --user 参数覆盖默认配置

问题与支持

• 提交 Issue：通过 GitHub Issues 报告问题
• 贡献代码：提交 PR 至 bitnami/containers 仓库
• 企业支持：商业用户可订阅 Bitnami Secure Images 企业版 获取全量镜像和技术支持

许可证

本镜像基于 Apache License 2.0 许可发布。详情参见 许可证文本。

商标声明："VictoriaMetrics" 为其 respective 所有者的商标，Bitnami 对第三方商标的使用不暗示任何关联或背书。