Update README.md
1 file changed
tree: cda98c57a4a0a35eabb3f9e74a48629e8a72c54f
  1. dashboard/
  2. helper-libs/
  3. README.md
  4. WFSTATES.md
README.md

#User-ALE

##Background

The User Activity Logging Engine, or User-ALE, is a logging mechanism used to quantitatively assess the behavioural and cognitive state of a data analyst while interacting with Big Data Exploitation Systems (BDES).

To accurately measure the cognitive state of the user, tool developers associate model based workflow states with each user action. Did a user pan a map? Then they are exploring. Did a user click a search button? Then they are getting new data. These model based activities can then be processed to measure hidden empirical states that describe more accurately the user's workflow and behaviour.

##Who is the package for?

This package is for developers creating User facing tools, and who would like to log the users interaction with this tool, in order to gain an insight into the behavioural and cognitive state of the user.

##JavaScript Quickstart Download both the latest logging library and the latest worker library from Github.

###Instantiate the JavaScript Logger

// web worker url
var worker = 'js/draper.activity_worker-2.1.1.js'
var ac = new activityLogger(worker);
.testing(true) // simulate POST, won't send log
.echo(true) // log to console
.mute(['SYS']); // don't log SYSTEM actions

###Register the logger

ac.registerActivityLogger(
  "http://xd-draper.xdata.data-tactics-corp.com:1337", 
  "my-component", 
  "v0.1"
  );

###Log a User Action

$('#button').mouseenter(function() {
  ac.logUserActivity(
  'User hovered over element to read popup', // description
  'hover_start', // activity_code
  ac.WF_EXPLORE // workflow State
  );
})

##ELK stack installation

See the README file in the dasboard subdirectory