Sherlog.js

Javascript error and event tracker application.

Features

• Tracks javascript errors
• Tracks erroneous ajax requests
• Tracks custom events
• Reporting dashboard
• Lightweight tracking framework (~2KB Minified)

Prerequisites

• Node
• Npm
• MongoDB

Installation

$ git clone git://github.com/burakson/sherlogjs.git
$ cd sherlogjs
$ npm install && bower install

Configuration & Usage

• Open config/config.json and configure the application

• Hit gulp to prepare the framework

• Start the server:

  $ node server.js

• Add the following script into your web document before any <script> tag

<script src="sherlog.min.js" data-environment="production"></script>

• Done! Sherlog is now tracking errors.

API

Sherlog provides a public method for event tracking as shown in the below examples.

_sherlog.push( String/Object , callback )

Example 1:

_sherlog.push({
    username: 'John Doe',
    age: 35,
    action: 'Clicked on an image'
}, function() {
    // event tracking pixel is fired.
});

Example 2:

_sherlog.push('User has clicked to the button', function() {
    // event tracking pixel is fired.
});

License

MIT License © Burak Son