thousandeyes/enterprise-agent

ThousandEyes Enterprise Agent Docker镜像技术文档

1. 镜像概述和主要用途

ThousandEyes Enterprise Agent是ThousandEyes网络智能平台的核心组件，负责在本地网络环境中执行主动/被动监控任务，收集网络性能指标（如延迟、丢包率、路径可视化）、应用可用性数据及端到端用户体验指标，并实时上报至ThousandEyes云平台。

本Docker镜像提供容器化部署方案，旨在简化Enterprise Agent的安装、升级和运维流程，确保跨环境（物理机、虚拟机、Kubernetes集群）的部署一致性，适用于需要快速扩展监控节点或基于容器化基础设施构建网络可见性体系的场景。

2. 核心功能和特性

2.1 多维度监控能力

• 支持HTTP/HTTPS、DNS、ICMP、TCP、UDP等多协议性能测试
• 提供路径可视化（Traceroute、BGP路由分析）和网络拓扑发现
• 集成Web应用性能监控（页面加载时间、API响应延迟）

2.2 实时数据采集与上报

• 毫秒级数据采样，分钟级数据聚合与上报
• 支持离线缓存（网络中断时缓存数据，恢复后自动同步）

2.3 云平台深度集成

• 与ThousandEyes云平台双向通信，接收监控任务配置并上报结果
• 支持通过平台远程管理代理生命周期（升级、重启、配置更新）

2.4 容器化部署优势

• 轻量级设计（基础镜像基于Alpine Linux，镜像体积<200MB）
• 无依赖安装（容器内置所有运行时依赖，无需手动配置系统库）
• 快速扩缩容（支持通过Docker Compose或Kubernetes批量部署多实例）

3. 使用场景和适用范围

3.1 企业分支网络监控

• 部署于分支机构本地网络，监控总部与分支间的广域网（WAN）性能
• 定位跨地域应用访问延迟、丢包等问题

3.2 混合云/多云环境可见性

• 部署于公有云（AWS/Azure/GCP）或私有云节点，监控云资源与本地数据中心间的网络路径
• 分析云服务（如SaaS应用、IaaS资源）的可用性与性能

3.3 分布式系统诊断

• 在微服务集群节点部署，监控服务间通信延迟、API调用成功率
• 结合ThousandEyes Endpoint Agent，实现端到端（用户-应用-数据库）路径追踪

3.4 容器化基础设施监控

• 适配Kubernetes、Docker Swarm等容器编排平台，监控容器网络性能
• 支持与Prometheus、Grafana等监控系统集成（通过ThousandEyes API导出数据）

4. 使用方法和配置说明

4.1 前提条件

• 已注册ThousandEyes企业账户，并拥有管理员权限（用于生成Agent令牌）
• 已在ThousandEyes平台创建Enterprise Agent（获取AGENT_TOKEN和ACCOUNT_TOKEN）
• 部署环境满足：
  • Docker Engine 19.03+ 或 Kubernetes 1.16+
  • 网络连通性：允许容器访问ThousandEyes云服务端点（agent.thousandeyes.com:443、api.thousandeyes.com:443）
  • 资源配置：最低1 CPU核心、1GB内存、10GB磁盘空间

4.2 获取镜像

ThousandEyes Enterprise Agent Docker镜像需通过ThousandEyes官方渠道获取（需账户授权）。获取方式包括：

• 从ThousandEyes私有镜像仓库拉取（需配置仓库认证）：

  bash
  docker login registry.thousandeyes.com -u <your-account-email>
  docker pull registry.thousandeyes.com/enterprise-agent:latest
  

• 或通过企业内部私有仓库同步（联系ThousandEyes支持团队获取镜像包）

4.3 基本部署

4.3.1 使用docker run部署

bash
docker run -d \
  --name thousandeyes-agent \
  --net=host \  # 推荐使用host网络模式，确保网络监控准确性（需宿主机网络权限）
  -e AGENT_TOKEN="te-agent-xxxx-xxxx-xxxx-xxxx" \  # 替换为平台生成的Agent令牌
  -e ACCOUNT_TOKEN="te-account-xxxx-xxxx-xxxx-xxxx" \  # 替换为账户令牌
  -e AGENT_NAME="DC01-Floor2-Agent" \  # 自定义Agent名称（平台显示用）
  -v /var/lib/thousandeyes:/var/lib/thousandeyes \  # 持久化Agent数据（配置、缓存）
  --restart unless-stopped \  # 异常退出时自动重启
  registry.thousandeyes.com/enterprise-agent:latest

4.3.2 使用docker-compose部署

创建docker-compose.yml：

yaml
version: '3.8'
services:
  thousandeyes-agent:
    image: registry.thousandeyes.com/enterprise-agent:latest
    container_name: thousandeyes-agent
    network_mode: host  # 必须使用host模式以获取完整网络可见性
    environment:
      - AGENT_TOKEN=te-agent-xxxx-xxxx-xxxx-xxxx  # 必填：Agent令牌
      - ACCOUNT_TOKEN=te-account-xxxx-xxxx-xxxx-xxxx  # 必填：账户令牌
      - AGENT_NAME=K8s-Node-01-Agent  # 可选：自定义名称
      - LOG_LEVEL=info  # 可选：日志级别（debug/info/warn/error，默认info）
      - HTTP_PROXY=http://proxy.example.com:8080  # 可选：HTTP代理（需代理时配置）
      - HTTPS_PROXY=https://proxy.example.com:8080  # 可选：HTTPS代理
      - NO_PROXY=127.0.0.1,localhost,.example.com  # 可选：不通过代理的地址
    volumes:
      - thousandeyes-data:/var/lib/thousandeyes  # 持久化数据卷
    restart: unless-stopped
    deploy:
      resources:
        limits:
          cpus: '2'  # 限制CPU使用（根据监控任务量调整）
          memory: 2G  # 限制内存使用
volumes:
  thousandeyes-data:  # 声明持久化卷（自动创建）

启动服务：

bash
docker-compose up -d

4.4 核心配置参数（环境变量）

4.5 启动与验证

4.5.1 检查容器状态

bash
docker ps | grep thousandeyes-agent  # 确认容器状态为Up
docker logs -f thousandeyes-agent  # 查看实时日志，确认无报错信息

正常日志示例：

2024-05-20T08:30:00Z [INFO] Agent initialized with token: te-agent-xxxx
2024-05-20T08:30:02Z [INFO] Connected to cloud endpoint: agent.thousandeyes.com:443
2024-05-20T08:30:05Z [INFO] Successfully registered with account: your-account@example.com

4.5.2 在ThousandEyes平台验证

1. 登录ThousandEyes控制台，进入 Agents > Enterprise Agents
2. 确认目标Agent状态为 Online（绿色），名称与AGENT_NAME一致
3. 点击Agent名称，查看监控任务执行状态及历史数据

4.6 高级配置

4.6.1 持久化数据

通过挂载/var/lib/thousandeyes目录至宿主机或持久化卷，确保Agent配置、证书和缓存数据不丢失：

bash
# 宿主机目录挂载示例
mkdir -p /data/thousandeyes-agent
docker run ... -v /data/thousandeyes-agent:/var/lib/thousandeyes ...

4.6.2 网络模式说明

• 推荐使用--net=host模式：直接使用宿主机网络栈，确保网络监控（如Traceroute、TCP握手）结果与宿主机一致，避免容器网络NAT干扰。
• 若不支持host模式（如Kubernetes环境），需配置hostNetwork: true（Kubernetes Pod配置），并开放必要端口（443/tcp用于云平台通信）。

4.6.3 资源限制

根据监控任务数量调整资源配置（单Agent支持最多100个并发监控任务）：

• 最低配置：1 CPU核心、1GB内存
• 推荐配置：2 CPU核心、2GB内存（适用于50+监控任务）

5. 常见问题

5.1 Agent状态显示“Offline”

• 检查网络连通性：确保容器可访问agent.thousandeyes.com:443（使用docker exec -it thousandeyes-agent curl -v https://agent.thousandeyes.com测试）
• 验证AGENT_TOKEN和ACCOUNT_TOKEN是否正确（令牌有效期为90天，过期需重新生成）

5.2 监控数据缺失

• 确认容器网络模式为host（非host模式可能导致路径追踪数据不准确）
• 检查宿主机防火墙规则，开放ThousandEyes所需端口（443/tcp、ICMP等）

5.3 容器频繁重启

• 查看日志定位错误（docker logs thousandeyes-agent）
• 检查资源是否不足（通过docker stats查看CPU/内存使用率）

6. 版本更新

通过重新拉取镜像并重启容器完成升级：

bash
docker pull registry.thousandeyes.com/enterprise-agent:latest
docker restart thousandeyes-agent

注意：升级前建议备份/var/lib/thousandeyes目录数据。