sflow/sflow-rt

sFlow-RT 镜像文档

镜像概述

sFlow-RT 接收来自网络设备、主机和应用程序中嵌入的标准sFlow代理的持续遥测数据流，将其转换为可操作指标，并通过REST API提供访问。这些指标可轻松与各种现场和云、编排、DevOps及软件定义网络(SDN)工具集成。

!sFlow-RT 架构图

基于此镜像的包

以下包基于此镜像构建：

• https://hub.docker.com/r/sflow/prometheus
  探索sFlow数据的理想起点，包含实时浏览指标、数据包流、数据包丢弃的应用程序，以及Prometheus抓取格式的指标导出功能。

• https://hub.docker.com/r/sflow/ddos-protect
  提供DDoS缓解解决方案，可检测和缓解 volumetric ***。

• https://hub.docker.com/r/sflow/topology
  包含用于监控叶脊数据中心网络架构的工具。

• https://hub.docker.com/r/sflow/ixp-metrics
  为AI/ML RoCEv2集群提供实时指标。

• https://hub.docker.com/r/sflow/ixp-metrics
  为互联网交换点(IXP)提供实时指标，包括成员间流量矩阵。

• https://hub.docker.com/r/sflow/sflow-test
  包含测试sFlow代理合规性和准确性的工具。

使用方法

基本运行

console
docker run --rm -p 8008:8008 -p 6343:6343/udp sflow/sflow-rt

配置sFlow代理将数据发送到容器的UDP端口6343，通过端口8008访问HTTP/REST API。

调整内存分配

console
docker run --rm -e "RTMEM=2G" -p 8008:8008 -p 6343:6343/udp sflow/sflow-rt

将内存从默认1G增加到2G。大规模监控的配置建议参见性能调优。

设置系统属性

console
docker run --rm -p 8008:8008 -p 6343:6343/udp sflow/sflow-rt -Dgeo.country=resources/config/GeoLite2-Country.mmdb

设置系统属性以在定义流时启用国家/地区查找。

运行启动脚本

console
docker run --rm -p 8008:8008 -p 6343:6343/udp -v $PWD/script.js:/script.js sflow/sflow-rt -Dscript.file=/script.js

启动时运行JavaScript，用于初始化流、组、映射、BGP会话和拓扑。

运行sFlow-RT应用程序

console
docker run --rm -v $PWD/my-app:/sflow-rt/app/my-app -p 8008:8008 -p 6343:6343/udp sflow/sflow-rt

运行sFlow-RT应用程序。开发应用程序时可删除-d选项以查看日志命令输出，并使用control-c停止容器。

Dockerfile示例

dockerfile
FROM sflow/sflow-rt:latest
COPY /Users/pp/my-app /sflow-rt/app

简单Dockerfile用于生成包含应用程序的新镜像。

dockerfile
FROM sflow/sflow-rt:latest
ENV RTAPP="-Dgeo.country=resources/config/GeoLite2-Country.mmdb"
RUN /sflow-rt/get-app.sh sflow-rt browse-flows

可用于从已发布应用程序生成新镜像。Dockerfile中也可设置所需的系统属性。使用RTAPP环境变量设置应用程序特定属性，允许用户通过RTPROP变量设置其他属性。

下载已发布应用程序

console
docker run --rm -v $PWD:/sflow-rt/app --entrypoint /sflow-rt/get-app.sh --user $(id -u):$(id -g) sflow/sflow-rt sflow-rt browse-flows

将已发布应用程序下载到当前目录。--user $(id -u):$(id -g)选项允许容器以本地用户身份写入本地文件系统。

安装并运行多个应用程序

console
docker run --rm -v $PWD:/sflow-rt/app --entrypoint /sflow-rt/get-app.sh --user $(id -u):$(id -g) sflow/sflow-rt sflow-rt browse-flows
docker run --rm -v $PWD:/sflow-rt/app --entrypoint /sflow-rt/get-app.sh --user $(id -u):$(id -g) sflow/sflow-rt sflow-rt browse-metrics
docker run --rm -v $PWD:/sflow-rt/app -p 6343:6343/udp -p 8008:8008 sflow/sflow-rt

安装https://github.com/sflow-rt/browse-metrics%E5%92%8Chttps://github.com/sflow-rt/browse-flows%E5%BA%94%E7%94%A8%E7%A8%8B%E5%BA%8F%E5%B9%B6%E5%90%AF%E5%8A%A8sFlow-RT%E3%80%82%E8%BF%99%E4%BA%9B%E5%BA%94%E7%94%A8%E7%A8%8B%E5%BA%8F%E6%98%AF%E6%8E%A2%E7%B4%A2sFlow%E9%81%A5%E6%B5%8B%E6%B5%81%E4%B8%AD%E5%8F%AF%E7%94%A8%E6%8C%87%E6%A0%87%E5%92%8C%E6%B5%81%E9%87%8F%E7%9A%84%E6%9C%89%E7%94%A8%E5%B7%A5%E5%85%B7%E3%80%82

使用配置文件

若需设置大量系统属性和应用程序属性值，可先定义配置文件，例如以下local.conf文件：

console
dns.servers=resolv.conf
geo.country=resources/config/GeoLite2-Country.mmdb
geo.asn=resources/config/GeoLite2-ASN.mmdb
oui.names=resources/config/oui.txt
flow-trend.maxFlows=20
flow-trend.aggMode=sum

运行带配置设置的sFlow-RT：

console
docker run --rm -v $PWD/local.conf:/sflow-rt/local.conf -v $PWD/app:/sflow-rt/app \
-p 6343:6343/udp -p 8008:8008 sflow/sflow-rt -Dsystem.propertyFiles=local.conf

持久化应用状态

console
docker run --rm -v $PWD/local.conf:/sflow-rt/local.conf -v $PWD/app:/sflow-rt/app \
-v $PWD/store:/sflow-rt/store -p 6343:6343/udp -p 8008:8008 --user $(id -u):$(id -g) sflow/sflow-rt \
-Dsystem.propertyFiles=local.conf

某些应用程序使用/sflow-rt/store目录存储状态。若需应用程序设置在重启间持久化，可使用本地卷。

环境变量

• RTMEM
  设置Java堆内存分配，默认1G

• RTGC
  设置Java垃圾收集器配置，默认-XX:+UseZGC -XX:+UseCompactObjectHeaders -XX:+ExitOnOutOfMemoryError

• RTPROP
  用户定义的系统属性

• RTAPP
  在Dockerfile中设置系统属性

许可证

下载此软件前，请阅读并接受许可协议。