产品概述
产品优势
应用场景
基本概念
相关限制
功能特性
开服地域
Agent 自助接入
使用场景
采集自建 IDC 上的服务，需要部署 Agent 并管理采集配置，上报监控数据到云上 Prometheus 监控服务。对于云上服务推荐使用 集成中心，集成中心会托管 Agent，提供多种中间件和抓取任务的自动化集成。
获取 Prometheus 实例访问配置
1. 前往 Prometheus 监控控制台，选择对应的实例 ID/名称，在基本信息 > 服务地址页面，获取 Remote Write 地址和 Token。
2. 在 账号信息 页面获取 APPID。
确认所在网络环境和云上实例联通
根据获取的 RemoteWrite 地址，执行如下命令，如果网络联通返回信息会包含
401 Unauthorized。curl -v -X POST ${RemoteWriteURL}
安装并启动 vmagent
vmagent 占用较少的资源且兼容 Prometheus 采集配置和 Remote Write 协议而得到广泛使用。本文只介绍 vmagent 常用启动选项，通过 Systemd 或 Docker 来管理 vmagent，更多详细信息可以参考 官方文档。
常用启动选项
-promscrape.noStaleMarkers：如果采集目标消失，默认会生成所有关联指标的 stale marker 并写到远程存储。设置该选项禁止该行为，能减少内存的占用。
-loggerTimezone：日志中时间的时区，例如
Asia/Shanghai, Europe/Berlin 或者 Local (默认是 "UTC")。-remoteWrite.tmpDataPath：采集后待写出数据临时存储的文件路径。
-remoteWrite.url：数据写向远程存储的 URL。
-remoteWrite.basicAuth.username：远程存储 -remoteWrite.url 对应的 basic auth 用户名。
-remoteWrite.basicAuth.password：远程存储 -remoteWrite.url 对应的 basic auth 密码。
-promscrape.config：采集配置的路径，可以是文件路径或者 HTTP URL，更多详情 参考文档。
-promscrape.configCheckInterval：检查 -promscrape.config 配置变化的时间间隔，关于配置更新可以 参考文档。
通过 Docker 管理
1. 在 vmagent 发布页面 选择镜像版本，推荐使用 latest。
2. 替换脚本中的 Prometheus 实例信息，启动 vmagent。
mkdir /etc/prometheustouch /etc/prometheus/scrape-config.yamldocker run -d --name vmagent --restart always --net host -v /etc/prometheus:/etc/prometheus victoriametrics/vmagent:latest \\-promscrape.noStaleMarkers \\-loggerTimezone=Local \\-remoteWrite.url="${RemoteWriteURL}" \\-remoteWrite.basicAuth.username="${APPID}" \\-remoteWrite.basicAuth.password='${Token}' \\-remoteWrite.tmpDataPath=/var/lib/vmagent \\-promscrape.config=/etc/prometheus/scrape-config.yaml \\-promscrape.configCheckInterval=5s
3. 查看 vmagent 日志
docker psdocker logs vmagent
如果正常启动，执行如下命令会返回
OK。curl localhost:8429/health
通过 Systemd 管理
1. 在 vmagent 发布页面，根据操作系统和 CPU 架构，下载对应 vmutils-* 压缩包并解压。
2. 替换脚本中的 Prometheus 实例访问信息，启动 vmagent。
mkdir /etc/prometheustouch /etc/prometheus/scrape-config.yamlcat >/usr/lib/systemd/system/vmagent.service <<EOF[Unit]Description=VictoriaMetrics AgentAfter=network.target[Service]LimitNOFILE=10240ExecStart=/usr/bin/vmagent \\-promscrape.noStaleMarkers \\-loggerTimezone=Local \\-remoteWrite.url="${RemoteWriteURL}" \\-remoteWrite.basicAuth.username="${APPID}" \\-remoteWrite.basicAuth.password="${Token}" \\-remoteWrite.tmpDataPath=/var/lib/vmagent \\-promscrape.config=/etc/prometheus/scrape-config.yaml \\-promscrape.configCheckInterval=5sRestart=alwaysRestartSec=10s[Install]WantedBy=multi-user.targetEOFsystemctl daemon-reloadsystemctl enable vmagentsystemctl start vmagentsleep 3systemctl status vmagent
3. 查看日志
journalctl -u vmagent
如果正常启动，执行如下命令会返回
OK。curl localhost:8429/health
管理配置
修改配置文件
global:scrape_interval: 30sscrape_configs:- job_name: agent-monitorstatic_configs:- targets:- localhost:8429
修改配置后，要过选项
-promscrape.configCheckInterval 设置时间才会生效。查看监控目标信息
执行如下命令，查看采集目标，可以查看配置是否生效并符合预期。
curl localhost:8429/api/v1/targets
文档反馈