pambrose/prometheus-agent

Prometheus Agent Docker镜像

概述

Prometheus Agent是一个轻量级的指标收集代理，设计用于在分布式环境中收集指标数据并将其转发到Prometheus服务器或其他监控系统。该镜像提供了一个便捷的方式来部署和运行Prometheus Agent，无需复杂的本地安装和配置。

核心功能和特性

• 轻量级设计：资源占用低，适合在边缘设备和资源受限环境中运行
• 指标收集：支持从各种exporters和应用程序收集Prometheus格式的指标
• 指标处理：提供指标过滤、重写、聚合和转换功能
• 灵活转发：可将收集的指标转发到一个或多个Prometheus服务器
• 配置热重载：支持动态更新配置而无需重启代理
• 高可用性：支持冗余部署和故障转移
• 监控自身：内置自我监控指标，可监控代理自身的性能和健康状态

使用场景和适用范围

Prometheus Agent适用于以下场景：

• 分布式系统和微服务架构的监控
• 边缘计算环境中的指标收集
• 需要在发送到中心服务器之前预处理指标的场景
• 多区域或多集群环境的集中监控
• 云原生环境中的容器化应用监控
• Kubernetes集群中的Pod级指标收集

使用方法和配置说明

基本用法

使用以下命令启动Prometheus Agent容器：

bash
docker run -d \
  --name prometheus-agent \
  -p 9090:9090 \
  -v /path/to/config.yml:/etc/prometheus-agent/config.yml \
  prometheus-agent:latest

Docker Compose配置

yaml
version: '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格式的配置文件，主要包含以下几个部分：

yaml
global:
  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: 'http://prometheus-server:9090/api/v1/write'
  
metric_relabel_configs:
  - source_labels: [__name__]
    regex: 'go_.*'
    action: drop

环境变量

Prometheus Agent支持以下环境变量来自定义行为：

持久化数据

如需持久化缓存，可挂载卷到/var/lib/prometheus-agent目录：

bash
docker 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/-/healthy
• 就绪状态: http://<agent-address>:9090/-/ready

故障排除

查看日志

bash
docker logs prometheus-agent

检查配置有效性

bash
docker exec -it prometheus-agent prometheus-agent --config.check --config.file=/etc/prometheus-agent/config.yml

自定义配置

要自定义Prometheus Agent的行为，可以通过挂载自定义配置文件或使用环境变量。详细的配置选项请参考https://github.com/pambrose/prometheus-proxy/blob/master/README.md%E3%80%82