Download and install

sFlow-RT requires Java 1.7+. The following commands download, install and run the software:

wget http://www.inmon.com/products/sFlow-RT/sflow-rt.tar.gz
tar -xvzf sflow-rt.tar.gz
cd sflow-rt
./start.sh

Alternatively, the following command runs sFlow-RT in a Docker container (see sflow/sflow-rt for more options):

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

Use a web browser to connect to http://localhost:8008 to interact with the REST API.

The software is also available as RPM and DEB packages:

Package files are installed under the path /usr/local/sflow-rt/ and log files are directed to /usr/local/sflow-rt/log/sflow-rt-<N>.log

Note There are no access controls built into sFlow-RT. However, HTTP access can be restricted to the local host by settings the http.hostname property to 127.0.0.1 and a reverse proxy can then be used to secure remote access to the API. For example, the following Apache configuration settings make the interface accessible on port 80 under the path /sflow-rt/

<IfModule mod_proxy.c>
  ProxyRequests off
  ProxyVia off
  ProxyPass        /sflow-rt/ http://127.0.0.1:8008/ retry=0 timeout=5
  ProxyPassReverse /sflow-rt/ http://127.0.0.1:8008/
  <IfModule mod_headers.c>
    RequestHeader append X-Forwarded-Prefix "/sflow-rt/"
  </IfModule>
</IfModule>
<Location /sflow-rt/>
  # insert access policy
</Location>

Please read and accept the License Agreement before downloading this software.

Applications

The following command (run in the sFlow-RT home directory) downloads and installs an application:

./get-app.sh sflow-rt dashboard-example

The following applications are currently available on GitHub:

UserApplicationDocker ImageDescription
sflow-rtdashboard-exampleReal-time dashboard example
sflow-rtflow-graphReal-time graph of network associations
sflow-rttop-flowssflow/top-flowsReal-time top network flows table
sflow-rtflow-trendsflow/flow-trendReal-time top network flows trend chart
sflow-rtsvg-weatherReal-time network weathermap example
sflow-rtfabric-viewsflow/fabric-viewReal-time visibility for leaf / spine ECMP fabrics
sflow-rtddos-blackholesflow/ddos-blackholeReal-time DDoS flood mitigation using null route
sflow-rtactive-routessflow/active-routesReal-time active BGP route cache
sflow-rtsflow-testsflow/sflow-testTest data center switch sFlow implementation
sflow-rtix-metricssflow/ix-metricsReal-time monitoring of Internet Exchange (IX) traffic
sflow-rtmininet-dashboardReal-time dashboard for Mininet
sflow-rtworld-mapReal-time traffic displayed on world map
sflow-rttrace-flowReal-time traffic tracing against topology
sflow-rtvizceralsflow/vizceralReal-time traffic visualization using NetFlix Vizceral
pphaalovs-2015Overlay/underlay network virtualization visibility demo
pphaalsc15-weatherSC15 SCinet real-time weathermap

Writing Applications provides an introduction describing the structure of an sFlow-RT application. Post information on new applications to the sFlow-RT group to have them listed.

Support

Please post questions, suggestions and applications to the sFlow-RT group.

Production use

Contact sales@inmon.com to discuss production licensing options for sFlow-RT.