sflow/host-sflow

Host sFlow 镜像文档

镜像概述和主要用途

Host sFlow 是一个开源代理，使用行业标准 sFlow 协议 导出物理和虚拟服务器的性能指标（如CPU、内存、磁盘等）及网络流量流数据。其核心用途是为容器化环境（Docker、Kubernetes等）和物理/虚拟主机提供标准化的性能与流量监控能力，支持将遥测数据发送至sFlow collector进行集中分析。

核心功能和特性

• 多维度指标导出：支持物理/虚拟服务器性能指标（CPU、内存、网络、磁盘）和网络流量流数据的采集与导出。
• 灵活的网络流量捕获：可针对Docker桥接网络、物理网卡、虚拟网卡（通过正则表达式匹配）等多种网络设备进行流量采样。
• 自适应配置：根据链路速度自动配置数据包采样率，简化部署复杂度。
• 多环境支持：兼容Docker单机、Docker Swarm集群、Kubernetes集群等容器化环境。
• 多样化网络模式适配：支持host、macvlan、ipvlan、Calico等非桥接网络模式下的流量监控。

使用场景和适用范围

• 单节点Docker环境：监控单个Docker主机的容器性能与网络流量。
• Docker Swarm集群：通过全局服务模式监控集群中所有节点。
• Kubernetes集群：通过DaemonSet在所有节点部署，实现全集群监控。
• 特殊网络模式：容器使用host、macvlan、ipvlan等网络模式时，捕获物理网卡流量。
• 虚拟主机环境：通过正则表达式匹配特定虚拟网卡（如eth0、eth1）进行流量监控。

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

1. Docker 单节点部署

基本用法（监控Docker桥接网络）

默认监控Docker桥接网络（docker0、docker_gwbridge），将sFlow数据发送至collector：

console
docker run -d \
  -e "COLLECTOR=10.0.0.70" \
  --net=host \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  sflow/host-sflow

说明：sFlow数据默认发送至collector的UDP端口6343。

监控物理网卡（host网络模式等场景）

当容器使用host、macvlan、ipvlan、Calico等网络模式时，监控主机物理网卡：

console
docker run -d \
  -e "COLLECTOR=10.0.0.70" \
  -e "NET=host" \
  --net=host \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  sflow/host-sflow

说明：采样率根据链路速度自动配置。

监控匹配正则表达式的虚拟网卡

在虚拟主机上，监控名称匹配正则表达式的虚拟网卡（如eth0、eth1等）：

console
docker run -d \
  -e "COLLECTOR=10.0.0.70" \
  -e "NET=^eth" \
  --net=host \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  sflow/host-sflow

说明：NET=^eth 表示匹配以“eth”开头的网卡。

2. Docker Swarm 集群部署

通过全局服务模式监控Swarm集群所有节点：

console
docker service create \
  --mode global \
  --name host-sflow \
  --env "COLLECTOR=10.0.0.70" \
  --network host \
  --mount type=bind,src=/var/run/docker.sock,dst=/var/run/docker.sock,readonly \
  sflow/host-sflow

说明：--mode global 确保服务在集群每个节点上运行。

3. Kubernetes 集群部署

通过DaemonSet在Kubernetes所有节点部署：

1. 创建 host-sflow.yml 文件：

yaml
apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: host-sflow
spec:
  selector:
    matchLabels:
      name: host-sflow
  template:
    metadata:
      labels:
        name: host-sflow
    spec:
      hostNetwork: true
      containers:
      - name: host-sflow
        image: sflow/host-sflow:latest
        env:
          - name: COLLECTOR
            value: "10.0.0.70"
          - name: NET
            value: "host"  # 监控物理网卡，根据需求调整
        volumeMounts:
          - mountPath: /run/containerd/containerd.sock
            name: containerd-sock
            readOnly: true
      volumes:
        - name: containerd-sock
          hostPath:
            path: /run/containerd/containerd.sock

2. 应用配置：

console
kubectl apply -f host-sflow.yml

环境变量说明

许可证

使用前请阅读并接受 许可协议。