Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Real time web analytics using node.js and web sockets
Branch: master
Pull request Compare This branch is 133 commits behind mnutt:master.

README.md

HUMMINGBIRD

Site tracking and analytics storage

Description

Hummingbird serves a 1x1 tracking pixel to users. In the browser's GET request it sends back tracking data generated by javascript.

Requirements

  • node.js v0.1.96
  • mongodb

Installation

git clone git://github.com/mnutt/hummingbird.git
cd hummingbird

# Update submodules
git submodule update --init
# If you are running an older version of git, you may have to run the following instead:
# git submodule init . && git submodule update .

# Initialize the express submodules
cd deps/express; git submodule update --init; cd ../..

# Copy the default configuration file
cp config/app.json.sample config/app.json

Running Hummingbird

To start the analytics server, run the following:

mongod &   (or start mongo some other way)
node server.js

To start the web monitor, run:

node monitor.js

Specs

sudo gem install jspec
jspec run --node

Tips

  • To run the UI locally but stream data from your production server, use the url http://localhost:8088/?ws_server=your-host.com&ws_port=12345

Contributors

License

Hummingbird is licensed under the MIT License. (See LICENSE)

Something went wrong with that request. Please try again.