appdynamics/machine-agent-netviz

支持Kubernetes网络可见性的机器代理镜像

镜像概述

该镜像是一个专为Kubernetes集群设计的机器代理，核心功能是提供网络可见性能力，通过监控集群网络流量、采集性能指标及可视化网络行为，帮助用户实时掌握集群网络状态，快速定位和解决网络相关问题。

主要用途

• 监控Kubernetes集群内Pod、Service间的网络流量
• 收集网络性能关键指标（吞吐量、延迟、丢包率等）
• 提供网络拓扑及流量路径可视化
• 支持网络异常行为检测与告警
• 辅助微服务通信问题排查及网络策略优化

核心功能和特性

网络流量监控

• 支持Pod间、Service间、节点间流量捕获与分析
• 兼容TCP、UDP等主流网络协议
• 支持流量按命名空间、标签等维度过滤

性能指标采集

• 实时采集吞吐量（bytes/s、packets/s）
• 记录网络延迟（往返时间RTT）
• 监控丢包率、重传率等异常指标
• 支持Prometheus等主流监控系统指标导出

网络可视化

• 自动生成Kubernetes网络拓扑图
• 展示流量路径及通信关系
• 支持历史流量趋势图表展示

Kubernetes原生集成

• 适配Kubernetes API，自动发现集群资源（Pod、Service、Node）
• 支持自定义资源标签关联
• 兼容Kubernetes RBAC权限控制

问题排查支持

• 记录网络流量日志及异常事件
• 提供流量异常告警触发机制
• 支持与日志系统（如ELK）集成

使用场景和适用范围

适用场景

• Kubernetes集群网络性能日常监控
• 微服务间通信延迟或丢包问题排查
• 网络策略生效验证及优化
• 多租户集群网络隔离审计
• 大规模集群网络行为趋势分析

适用范围

• 各类Kubernetes环境（自建集群、云厂商托管集群如EKS/GKE/AKS等）
• 容器化微服务架构的应用集群
• 对网络稳定性、可观测性要求较高的生产环境
• 开发/测试环境网络行为验证

目标用户

• 运维团队（集群网络监控与维护）
• 开发团队（微服务通信问题排查）
• SRE团队（集群稳定性保障）
• 网络架构师（网络策略设计与优化）

使用方法和配置说明

部署方式

该代理需以DaemonSet形式部署在Kubernetes集群中，确保每个节点运行一个代理实例，以全面覆盖集群网络监控。

环境变量配置

部署示例（Kubernetes DaemonSet）

yaml
apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: machine-agent-network-visibility
  namespace: monitoring
  labels:
    app: machine-agent
spec:
  selector:
    matchLabels:
      app: machine-agent
  template:
    metadata:
      labels:
        app: machine-agent
    spec:
      hostNetwork: true  # 启用主机网络以捕获节点网络流量
      containers:
      - name: machine-agent
        image: [镜像名称]  # 替换为实际镜像地址
        ports:
        - containerPort: 9090  # Prometheus指标暴露端口
          name: metrics
        env:
        - name: KUBE_API_SERVER
          value: "https://kubernetes.default.svc:443"
        - name: METRICS_INTERVAL
          value: "30s"
        - name: LOG_LEVEL
          value: "info"
        - name: NETWORK_INTERFACE
          value: "eth0"
        - name: VISIBILITY_MODE
          value: "advanced"
        - name: PROMETHEUS_EXPORTER_PORT
          value: "9090"
        resources:
          limits:
            cpu: "500m"
            memory: "512Mi"
          requests:
            cpu: "200m"
            memory: "256Mi"
        volumeMounts:
        - name: var-log
          mountPath: /var/log
        - name: sys
          mountPath: /sys
        - name: run-xtables-lock
          mountPath: /run/xtables.lock
          readOnly: false
      volumes:
      - name: var-log
        hostPath:
          path: /var/log
      - name: sys
        hostPath:
          path: /sys
      - name: run-xtables-lock
        hostPath:
          path: /run/xtables.lock
          type: FileOrCreate

部署步骤

1. 将上述DaemonSet配置保存为machine-agent-daemonset.yaml
2. 替换配置中的[镜像名称]为实际镜像地址
3. 执行部署命令：kubectl apply -f machine-agent-daemonset.yaml -n monitoring
4. 验证部署状态：kubectl get pods -n monitoring -l app=machine-agent

验证部署

• 检查Pod运行状态：确保所有节点上的代理Pod均为Running状态
• 访问指标接口：通过kubectl port-forward <pod-name> 9090:9090 -n monitoring，访问http://localhost:9090/metrics验证指标输出
• 查看日志：kubectl logs <pod-name> -n monitoring，确认无错误日志输出

注意事项

• 该代理需在每个节点运行，建议为其配置资源限制（CPU/内存），避免影响集群性能
• 高级模式（VISIBILITY_MODE=advanced）会增加网络流量采集粒度，可能提升资源占用，建议根据集群规模评估
• 需确保代理Pod具备足够权限访问Kubernetes API（建议通过RBAC配置cluster-reader角色）
• 网络接口需与节点实际接口匹配，可通过kubectl exec -it <node-name> -- ip link查看节点网络接口名称