Apache Flagon User Ale (Incubating)

Clone this repo:
  1. 1be2d78 adding disclaimer and deprecation notice by poorejc · 2 years, 4 months ago master
  2. 528d6fb Added clientIp and userAgent to logs by Rob Foley · 6 years ago
  3. 24eba9e SENSSOFT-61 Add ALv2.0 License Headers to UserALEv3 by Lewis John McGibbney · 7 years ago
  4. 6db0332 Update userale.js by Rob · 7 years ago
  5. 430f8ef Merge pull request #6 from draperlaboratory/issues/system-logs by Rob · 7 years ago

Maintenance deprecated License

Apache Flagon User-ALE (Incubating)

Apache Flagon User-Ale is a deprecated product version and is no longer maintained. It will be retired soon. Find current Apache Flagon developments in user logging in our UserALE.js project.


The User Analytic Logging Engine (User ALE) is part of Draper's Softare as a Sensor™ Project. User ALE is for Software Developers, HCI/UX researchers, and project managers who develop user facing software tools—applications that are used for manipulating, analyzing, or visualizing data or other systems.

User ALE provides an API for instrumenting software tools, turning them into a human usability sensors. With every user interaction User ALE will transmit specially structured messages (JSON) from software tools to an activity logging server (Elastic). These messages not only report user activities and their timing, but provide sufficient context to understand how those activities are related to the functional organization of the software tool. This allows for greater utility in understanding how users are interacting with software tool features, and seeds more rigorous modeling and analytic approaches to understand not just what users do in software tools, but how they perform tasks with them.

User ALE provides data provides insight into software tool usage frequency, users' cognitive/behavioral strategy in using tools to complete tasks, their workflows, as well as their integrative use of software tool features.

##Who is the package for?

The User Analytic Logging Engine (User ALE) is for Software Developers, HCI/UX researchers, and project managers who develop user facing software tools.

Want to learn more? See the wiki.

Want to see an example client? Check out the demo.

Quick Startup Guide

1. Install Dependencies

If behind a proxy, modify Vagrantfile

  • Modifiy the vagantfile to point to your proxy.
  • Don't forget to add “http://” as leaving that off may break apt-get in the vagrant vm
  • Example: config.proxy.http=“
  • If your host system is also the proxy (e.g. CNTLM): setting the proxy as or localhost may confuse the Vagrant VM and prevent net access

2. Startup Vagrant ELK Stack and Developer

This will provision the base box which is an Ubuntu 14.04 machine. The ELK server is running on while the developer box is running on

vagrant up elk
vagrant up developer

3. Send logs by using our test-app:

####View the logs you send on the test-app Kibana Dashboard: