lsdtrip/sauron-collector Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

指标抓取代理 Docker 镜像文档

镜像概述

该Docker镜像提供了一个轻量级代理程序，专注于从各类目标系统（如应用服务、数据库、基础设施等）抓取指标数据，并将其标准化后发送至集中式可观测性平台，以支持统一的监控、分析与告警能力。镜像设计旨在简化分布式环境下的指标收集流程，降低可观测性体系的部署复杂度。

核心功能与特性

核心功能

• 多源指标抓取：支持从HTTP/HTTPS端点、数据库（MySQL、PostgreSQL等）、消息队列（Kafka、RabbitMQ等）及容器编排平台（Kubernetes）等多种目标源抓取指标
• 协议兼容性：兼容Prometheus exposition format、Graphite、InfluxDB Line Protocol等主流指标协议
• 数据转发能力：可将抓取的指标数据发送至Prometheus、Grafana、Elasticsearch、Datadog等集中式可观测性平台

关键特性

• 轻量级设计：基于Alpine Linux构建，镜像体积小（<50MB），运行时资源占用低（CPU<10%，内存<64MB）
• 灵活配置：支持通过环境变量或配置文件自定义抓取规则、频率、数据过滤及转换逻辑
• 高可用性：内置健康检查机制，支持自动恢复与故障重试
• 可扩展性：支持插件机制，可扩展对新数据源或目标平台的适配

使用场景与适用范围

典型使用场景

• 分布式系统监控：在微服务架构中，统一收集各服务实例的性能指标（如响应时间、错误率、资源使用率）
• 混合云环境观测：跨公有云、私有云及边缘环境，整合分散的基础设施与应用指标
• ** legacy系统接入**：为不原生支持可观测性协议的老旧系统提供指标导出能力
• 数据预处理：在指标发送至集中平台前，进行聚合、过滤或格式转换，减少后端存储与计算压力

适用范围

• 开发/测试环境：快速搭建临时监控体系
• 生产环境：作为长期运行的指标收集组件，支持7x24小时稳定运行
• 中小规模部署：单机或小规模集群（<1000个目标）的指标收集
• 大规模部署：配合Kubernetes等编排工具，通过水平扩展支持海量目标

使用方法与配置说明

基本运行命令

通过docker run快速启动代理，示例如下：

bash
docker run -d \
  --name metrics-agent \
  --restart always \
  -p 9091:9091 \  # 代理自身监控端点（可选）
  -e SCRAPE_INTERVAL=30s \  # 抓取频率，默认30s
  -e TARGETS="[***]" \  # 目标指标端点，逗号分隔
  -e OUTPUT_TYPE=prometheus \  # 输出平台类型，支持prometheus/elasticsearch/datadog
  -e OUTPUT_ENDPOINT="[***]" \  # 目标平台接收端点
  -v /host/path/config.yml:/app/config.yml \  # 挂载自定义配置文件（可选，优先级高于环境变量）
  your-registry/metrics-agent:latest

Docker Compose配置

在多容器环境中，通过docker-compose.yml整合代理服务：

yaml
version: '3.8'
services:
  metrics-agent:
    image: your-registry/metrics-agent:latest
    container_name: metrics-agent
    restart: always
    ports:
      - "9091:9091"
    environment:
      - LOG_LEVEL=info  # 日志级别：debug/info/warn/error，默认info
      - SCRAPE_TIMEOUT=10s  # 单次抓取超时时间，默认10s
      - TARGETS_FILE=/app/targets.list  # 从文件读取目标列表（每行一个URL，与TARGETS二选一）
      - OUTPUT_TYPE=prometheus
      - OUTPUT_ENDPOINT="[***]"
    volumes:
      - ./config.yml:/app/config.yml  # 自定义配置文件
      - ./targets.list:/app/targets.list  # 目标列表文件
    depends_on:
      - prometheus  # 确保目标平台先启动

  prometheus:
    image: prom/prometheus:latest
    # Prometheus配置...

配置参数说明

环境变量配置

配置文件格式

当通过-v挂载自定义配置文件（如config.yml）时，支持更复杂的配置，示例：

yaml
scrape:
  interval: 30s
  timeout: 10s
  targets:
    - url: [***]
      labels:  # 为该目标添加自定义标签
        service: "user-service"
        env: "production"
    - url: [***]
      scrape_interval: 60s  # 覆盖全局抓取频率
      filters:  # 指标过滤规则
        include: ["^mysql_.*", "^node_.*"]  # 仅保留匹配的指标
        exclude: ["^mysql_connections_idle$"]  # 排除指定指标

output:
  type: prometheus
  endpoint: [***]
  timeout: 15s
  basic_auth:  # 若目标平台需要认证
    username: "metrics-writer"
    password: "${OUTPUT_PASSWORD}"  # 支持引用环境变量

transform:  # 数据转换规则
  - action: "rename"
    metric: "http_requests_total"
    new_name: "api_requests_total"
  - action: "add_label"
    metric: ".*"
    label: "agent_version"
    value: "v1.2.0"

健康检查与监控

代理程序暴露/health端点（默认端口9091）用于健康检查，返回状态码200表示运行正常：

bash
curl http://localhost:9091/health
# 响应：{"status":"ok","scraped_targets":2,"successful_scrapes":2,"last_scrape_time":"2023-10-01T12:00:00Z"}

同时，/metrics端点提供代理自身的运行指标（如抓取成功率、发送延迟、资源占用等），可直接被Prometheus等工具抓取。

注意事项

1. 网络可达性：确保容器能够访问所有TARGETS端点及OUTPUT_ENDPOINT，建议通过Docker网络或服务发现机制配置网络连接
2. 权限配置：若挂载主机目录或文件，需确保容器内用户（默认nobody）有读取权限
3. 资源限制：在生产环境中，建议通过--memory和--cpus参数限制容器资源使用，避免影响其他服务
4. 版本兼容性：不同版本的代理可能存在配置格式差异，升级前请查阅版本变更日志
5. 安全考虑：对于包含敏感信息的配置（如认证凭证），建议通过Docker Secrets或环境变量注入，避免硬编码在配置文件中