Skip to content
Redis & node.js powered dashboard skeleton
JavaScript Ruby Perl Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


This is a simple dashboard-skeleton, which allows the submission of events into a rotating buffer. New events push out old ones, and we cap the events to the the most recent 1000.

Submission is handled via node.js, and storage is handled by Redis.

This server was discussed in the article Building a simple dashboard with redis and node.js .


Assuming you have node.js and redis installed then you may launch the server by running:

 nodejs ./dashboard.js

This will result in a process accepting UDP submissions on port 4433.

Submitting Events

Submitting events is as simple as firing UDP packets at the server which is now running.

NOTE: The server will bind on all available interfaces, so you should firewall submissions from malicious hosts.

There is a sample perl-client included to submit events to the dashboard.js server running on the localhost.

perl "This is a test"
perl "I like cake."

Viewing Events

There is a simple Ruby-based server supplied which would make a good starting point for a more featureful event-viewer.

Assuming you have Ruby, and the sinatra + redis gems installed you can launch the server with:

 cd ./viewer/

This will launch a server which will process two URLs:

The front-page uses jQuery to dynamically load the JSON array and display it. You can see a screenshot here.


Please report any issue via the github repository:


BSD 3-clause.


Steve Kemp

You can’t perform that action at this time.