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):

docker run -p 8008:8008 -p 6343:6343/udp -d 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:

Software is 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>
<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:

UserApplicationDescription
sflow-rtdashboard-exampleReal-time dashboard example
sflow-rtflow-graphReal-time graph of network associations
sflow-rttop-flowsReal-time top network flows table
sflow-rtsvg-weatherReal-time network weathermap example
sflow-rtfabric-viewReal-time visibility for leaf / spine ECMP fabrics
sflow-rtddos-blackholeReal-time DDoS flood mitigation using null route
sflow-rtactive-routesReal-time active BGP route cache
sflow-rtsflow-testTest data center switch sFlow implementation
sflow-rtix-metricsReal-time monitoring of Internet Exchange (IX) traffic
sflow-rtmininet-dashboardReal-time dashboard for Mininet
sflow-rtworld-mapReal-time traffic displayed on world map
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.