paopsmon/netdata

系统与应用性能健康监控基础代理镜像

镜像概述

该Docker镜像提供一个轻量级的性能与健康监控基础代理，专为系统和应用监控设计。作为监控体系的核心组件，它能够持续采集目标系统和应用的关键性能指标与健康状态数据，支持多种数据输出格式，可与主流监控平台集成，为运维和开发团队提供实时监控能力。

核心功能与特性

系统指标监控

• 实时采集CPU使用率、负载、上下文切换等处理器指标
• 监控内存使用率、可用内存、缓存占用等内存指标
• 跟踪磁盘IO、使用率、分区状态等存储指标
• 记录网络吞吐量、连接数、延迟等网络指标

应用健康监控

• 支持HTTP/HTTPS端点健康检查（状态码、响应时间）
• 提供TCP端口连通性检测
• 支持自定义命令执行结果检查
• 可配置健康状态阈值告警触发条件

数据处理能力

• 多维度指标聚合与过滤
• 支持JSON、Prometheus、InfluxDB等多种数据格式输出
• 内置数据缓存机制，避免网络波动导致的数据丢失
• 支持批量数据上报，降低网络开销

部署特性

• 轻量级设计，运行时资源占用低（典型场景下<50MB内存）
• 无状态架构，支持水平扩展
• 容器化部署，跨平台兼容（Linux/Windows容器）
• 支持动态配置更新，无需重启容器

使用场景与适用范围

服务器性能监控

适用于物理机、虚拟机及云服务器的基础性能指标采集，帮助运维团队掌握基础设施运行状态。

应用健康状态跟踪

可集成到微服务架构中，监控各服务实例的健康状态，及时发现服务异常。

分布式系统监控

作为分布式监控体系的边缘代理，在多节点环境中采集分散的性能数据，统一汇总至中心监控平台。

DevOps环境监控

支持CI/CD流水线集成，监控构建、部署过程中的系统资源占用，优化资源配置。

使用方法与配置说明

基本使用

通过以下命令启动基础监控代理，默认监控当前主机系统指标：

bash
docker run -d \
  --name monitoring-agent \
  --privileged \
  -p 9100:9100 \
  --restart always \
  monitoring-base-agent:latest

环境变量配置

通过环境变量自定义监控行为，常用配置如下：

带环境变量的启动示例：

bash
docker run -d \
  --name app-monitor \
  --privileged \
  -p 9100:9100 \
  -e MONITOR_TARGET=both \
  -e COLLECT_INTERVAL=15 \
  -e APP_HEALTH_CHECK_URL=http://app:8080/health \
  -e REPORT_ENDPOINT=http://prometheus:9090/api/v1/write \
  --restart always \
  monitoring-base-agent:latest

Docker Compose配置

以下是典型的docker-compose.yml配置示例，集成应用与监控代理：

yaml
version: '3.8'

services:
  app:
    image: your-application:latest
    ports:
      - "8080:8080"
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
      interval: 30s
      timeout: 10s
      retries: 3

  monitoring-agent:
    image: monitoring-base-agent:latest
    privileged: true
    ports:
      - "9100:9100"
    environment:
      - MONITOR_TARGET=both
      - COLLECT_INTERVAL=15
      - APP_HEALTH_CHECK_URL=http://app:8080/health
      - DATA_OUTPUT_FORMAT=prometheus
    depends_on:
      - app
    restart: always

数据持久化

如需持久化配置文件和监控日志，可挂载本地目录：

bash
docker run -d \
  --name monitoring-agent \
  --privileged \
  -p 9100:9100 \
  -v /etc/monitoring-agent:/etc/agent \
  -v /var/log/monitoring-agent:/var/log/agent \
  monitoring-base-agent:latest

扩展配置

通过挂载自定义配置文件(/etc/agent/config.yaml)实现高级配置，支持：

• 自定义监控指标集合
• 配置复杂健康检查规则
• 设置数据过滤条件
• 集成第三方监控插件

配置文件示例：

yaml
metrics:
  system:
    include: [cpu, memory, disk, network]
    exclude: [cpu_context_switches]
  app:
    endpoints:
      - url: http://app:8080/health
        timeout: 5s
        interval: 30s
report:
  type: http
  url: http://monitor-server:8080/api/metrics
  timeout: 10s
  retry_count: 3

注意事项

• 运行容器需--privileged权限以获取完整系统指标（部分环境可通过--cap-add=SYS_PTRACE替代）
• 网络隔离环境中需确保容器可访问监控目标和上报端点
• 高频率采集（<5秒间隔）可能增加系统资源占用，建议根据实际需求调整
• 生产环境建议配置资源限制：--memory=128m --cpus=0.5