digitalocean/do-agent

DigitalOcean do-agent 镜像文档

镜像概述和主要用途

do-agent 是 DigitalOcean 提供的轻量级系统监控代理，用于收集 Droplet 或其他 Linux 系统的性能指标，并将数据发送至 DigitalOcean 控制面板。该镜像封装了 do-agent 服务，可通过容器化方式快速部署，实现对服务器资源的实时监控。

核心功能和特性

• 收集系统级性能指标：CPU、内存、磁盘、网络使用率
• 支持自定义指标采集频率
• 低系统资源占用（<1% CPU 使用率，约 10MB 内存）
• 自动与 DigitalOcean 监控平台集成
• 支持 HTTPS 加密数据传输
• 容器化部署，简化安装与升级流程

使用场景和适用范围

• DigitalOcean Droplet 实例监控
• 混合云环境中的服务器资源监控
• Kubernetes 集群节点性能监控
• 需要集中管理监控代理的多服务器环境
• 希望避免直接在主机系统安装监控软件的场景
• 需快速部署监控解决方案的开发/测试环境

详细的使用方法和配置说明

前提条件

• Docker 引擎 1.13+ 或 Kubernetes 1.8+
• 具有适当权限的 DigitalOcean API 令牌
• 网络连通性：能够访问 DigitalOcean 监控端点 (https://api.digitalocean.com)

基本使用方法

Docker 运行示例

bash
docker run -d \
  --name do-agent \
  --restart=always \
  --net=host \
  --pid=host \
  -v /:/rootfs:ro \
  -v /var/run:/var/run:ro \
  docker.xuanyuan.run/digitalocean/do-agent:latest

Docker Compose 配置

yaml
version: '3'
services:
  do-agent:
    image: docker.xuanyuan.run/digitalocean/do-agent:latest
    container_name: do-agent
    restart: always
    network_mode: host
    pid: host
    volumes:
      - /:/rootfs:ro
      - /var/run:/var/run:ro
    environment:
      - DO_AGENT_LOG_LEVEL=info
      - DO_AGENT_SCRAPE_INTERVAL=10s
    privileged: false
    restart: always

高级配置

自定义环境变量

自定义配置示例

bash
docker run -d \
  --name do-agent \
  --restart=always \
  --net=host \
  --pid=host \
  -v /:/rootfs:ro \
  -v /var/run:/var/run:ro \
  -e DO_AGENT_LOG_LEVEL=debug \
  -e DO_AGENT_SCRAPE_INTERVAL=5s \
  docker.xuanyuan.run/digitalocean/do-agent:latest

Kubernetes 部署

使用 DaemonSet 部署到所有节点

yaml
apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: do-agent
  namespace: monitoring
spec:
  selector:
    matchLabels:
      name: do-agent
  template:
    metadata:
      labels:
        name: do-agent
    spec:
      hostNetwork: true
      containers:
      - name: do-agent
        image: docker.xuanyuan.run/digitalocean/do-agent:latest
        resources:
          limits:
            cpu: 100m
            memory: 30Mi
          requests:
            cpu: 10m
            memory: 10Mi
        volumeMounts:
        - name: rootfs
          mountPath: /rootfs
          readOnly: true
        - name: varrun
          mountPath: /var/run
          readOnly: true
      volumes:
      - name: rootfs
        hostPath:
          path: /
      - name: varrun
        hostPath:
          path: /var/run

配置参数说明

卷挂载要求

网络模式说明

推荐使用 --net=host 网络模式，确保代理能够正确识别主机网络接口并收集准确的网络指标。如果无法使用主机网络，需确保容器能够访问主机网络命名空间。

安全注意事项

• 容器需要 CAP_SYS_PTRACE capability 以收集某些系统指标
• 虽然容器以非 root 用户运行，但需要访问主机文件系统的只读权限
• 确保主机文件系统挂载权限严格限制为只读
• 定期更新镜像以获取安全补丁

故障排除

验证代理运行状态

bash
docker logs do-agent

正常运行时会显示类似日志：

2023-01-01T12:00:00Z [INFO] Starting do-agent v1.2.3
2023-01-01T12:00:00Z [INFO] Successfully connected to DigitalOcean monitoring API
2023-01-01T12:00:05Z [INFO] Metrics collection started with interval 10s

常见问题解决

1. 指标未显示在 DigitalOcean 控制面板

   • 确认容器是否有权限访问网络
   • 检查主机防火墙设置，确保允许出站 HTTPS 连接
   • 验证容器日志中是否有 API 错误信息

2. 高 CPU/内存使用率

   • 尝试增加指标采集间隔（DO_AGENT_SCRAPE_INTERVAL）
   • 确保使用最新版本的 do-agent 镜像
   • 检查是否有异常的系统活动导致指标激增

版本信息和更新策略

• 镜像标签遵循语义化版本控制（例如 v1.2.3）
• latest 标签指向最新稳定版本
• 建议生产环境使用特定版本标签而非 latest，以确保部署一致性
• 更新策略：定期检查官方镜像更新并测试后再应用到生产环境

相关资源

• https://github.com/digitalocean/do-agent
• https://www.digitalocean.com/docs/monitoring/
• https://developers.digitalocean.com/documentation/monitoring/
• https://hub.docker.com/r/digitalocean/do-agent