
pambrose/prometheus-agentPrometheus Agent是一个轻量级的指标收集代理,设计用于在分布式环境中收集指标数据并将其转发到Prometheus服务器或其他监控系统。该镜像提供了一个便捷的方式来部署和运行Prometheus Agent,无需复杂的本地安装和配置。
Prometheus Agent适用于以下场景:
使用以下命令启动Prometheus Agent容器:
bashdocker run -d \ --name prometheus-agent \ -p 9090:9090 \ -v /path/to/config.yml:/etc/prometheus-agent/config.yml \ prometheus-agent:latest
yamlversion: '3' services: prometheus-agent: image: prometheus-agent:latest container_name: prometheus-agent ports: - "9090:9090" volumes: - ./config.yml:/etc/prometheus-agent/config.yml restart: always environment: - LOG_LEVEL=info networks: - monitoring-network networks: monitoring-network: driver: bridge
Prometheus Agent使用YAML格式的配置文件,主要包含以下几个部分:
yamlglobal: scrape_interval: 15s evaluation_interval: 15s scrape_configs: - job_name: 'node' static_configs: - targets: ['node-exporter:9100'] - job_name: 'docker' static_configs: - targets: ['cadvisor:8080'] remote_write: - url: '[***] metric_relabel_configs: - source_labels: [__name__] regex: 'go_.*' action: drop
Prometheus Agent支持以下环境变量来自定义行为:
| 环境变量 | 描述 | 默认值 |
|---|---|---|
CONFIG_FILE | 配置文件路径 | /etc/prometheus-agent/config.yml |
LOG_LEVEL | 日志级别 (debug, info, warn, error) | info |
WEB_LISTEN_ADDRESS | HTTP服务器监听地址 | :9090 |
WEB_TELEMETRY_PATH | 自身指标暴露路径 | /metrics |
RELOAD_INTERVAL | 配置文件重载间隔 | 5m |
如需持久化缓存,可挂载卷到/var/lib/prometheus-agent目录:
bashdocker run -d \ --name prometheus-agent \ -p 9090:9090 \ -v /path/to/config.yml:/etc/prometheus-agent/config.yml \ -v prometheus-agent-data:/var/lib/prometheus-agent \ prometheus-agent:latest
Prometheus Agent暴露了健康检查端点:
http://<agent-address>:9090/-/healthyhttp://<agent-address>:9090/-/readybashdocker logs prometheus-agent
bashdocker exec -it prometheus-agent prometheus-agent --config.check --config.file=/etc/prometheus-agent/config.yml
要自定义Prometheus Agent的行为,可以通过挂载自定义配置文件或使用环境变量。详细的配置选项请参考官方文档。
manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务