weaveworks/cloud-agent

Weave Cloud Agent 镜像文档

镜像概述

Weave Cloud Agent是Weaveworks公司推出的轻量级代理组件，作为Weave Cloud平台与用户容器集群之间的核心通信桥梁。该镜像通过在容器集群节点部署代理实例，实现集群数据采集、命令下发及状态同步，支持Kubernetes、Docker Swarm等主流容器编排平台，为用户提供容器化应用的全方位监控、管理与运维能力。

核心功能与特性

1. 全面数据采集

• Metrics采集：实时收集容器、Pod、节点的资源使用率（CPU、内存、网络、磁盘）及自定义业务指标
• 日志收集：集中采集容器标准输出日志，支持结构化日志解析与过滤
• 事件捕获：记录容器生命周期事件（启动/停止/重启）、集群状态变更事件（节点加入/退出、Pod调度等）

2. 远程管理与控制

• 通过Weave Cloud平台实现集群远程访问，支持容器终端连接、Pod日志实时查看
• 支持通过平台下发命令，执行集群配置更新、资源调整等操作
• 状态同步机制确保平台与集群状态一致性，实时反馈操作结果

3. 性能分析能力

• 内置应用性能分析模块，采集应用响应时间、错误率等关键指标
• 支持分布式追踪数据（如Jaeger、Zipkin格式）的转发与存储
• 提供性能瓶颈识别建议，辅助优化容器资源配置

4. 多平台兼容性

• 原生支持Kubernetes集群（包括EKS、GKE、AKS等托管集群）
• 兼容Docker Swarm、Mesos等容器编排平台
• 支持混合云/多云环境部署，统一管理跨云厂商的容器集群

5. 轻量级设计

• 镜像体积小（约20-30MB），启动速度快
• 低资源占用（默认配置下CPU占用<5%，内存占用<128MB）
• 支持自动扩缩容，根据集群规模动态调整代理实例数量

使用场景与适用范围

适用场景

• Kubernetes集群监控：对生产环境Kubernetes集群进行7×24小时监控，及时发现并告警异常状态
• 容器化应用运维：通过集中日志与指标分析，快速定位容器化应用故障根因
• 分布式系统调试：结合性能分析与分布式追踪，解决微服务架构下的跨服务调用问题
• 混合云容器管理：在私有云与公有云混合部署场景中，实现统一的容器集群监控与管理

适用范围

• 容器编排平台：Kubernetes 1.16+、Docker Swarm 18.09+、Mesos 1.10+
• 操作系统：Linux（Ubuntu 18.04+、CentOS 7+、Debian 10+）
• 部署环境：物理机、虚拟机、公有云EC2/ECS、私有云等

使用方法与配置说明

前置条件

• 已注册Weave Cloud账号并获取访问令牌（Token）
• 目标集群已安装Docker 19.03+或containerd 1.4+运行时
• 集群节点可访问Weave Cloud平台（默认需要443端口网络连通性）

1. Kubernetes集群部署（推荐）

通过kubectl部署

bash
# 替换<WEAVE_CLOUD_TOKEN>为实际令牌
kubectl apply -f "https://cloud.weave.works/k8s/scope.yaml?service-token=<WEAVE_CLOUD_TOKEN>"

自定义配置部署

创建自定义values文件（weave-agent-values.yaml）：

yaml
agent:
  collectionInterval: 15s  # 数据采集间隔，默认30s
  logLevel: info  # 日志级别，可选debug/info/warn/error
  resources:
    limits:
      cpu: 100m
      memory: 256Mi
    requests:
      cpu: 50m
      memory: 128Mi
  # 日志采集配置
  logs:
    enabled: true
    excludeContainers: ["pause-*"]  # 排除采集的容器名称模式

使用Helm部署：

bash
helm repo add weaveworks https://weaveworks.github.io/weave-cloud-helm-charts
helm install weave-agent weaveworks/weave-cloud-agent \
  --namespace weave \
  --create-namespace \
  --set token=<WEAVE_CLOUD_TOKEN> \
  -f weave-agent-values.yaml

2. Docker环境部署（单节点/非K8s集群）

bash
docker run -d \
  --name weave-cloud-agent \
  --privileged \
  --net=host \
  --pid=host \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /proc:/host/proc:ro \
  -v /sys:/host/sys:ro \
  -e WEAVE_CLOUD_TOKEN=<WEAVE_CLOUD_TOKEN> \
  -e COLLECTION_INTERVAL=15s \
  -e LOG_LEVEL=info \
  weaveworks/weave-cloud-agent:latest

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

验证部署

部署完成后，可通过以下方式验证代理状态：

Kubernetes环境

bash
# 查看Pod状态
kubectl get pods -n weave

# 查看代理日志
kubectl logs -n weave <weave-agent-pod-name> agent

Docker环境

bash
# 查看容器状态
docker ps | grep weave-cloud-agent

# 查看容器日志
docker logs weave-cloud-agent

成功部署后，登录Weave Cloud平台（[***]