Skip to content
This repository has been archived by the owner on Apr 20, 2021. It is now read-only.

CyrexEnterprise/elastic-event-js

Repository files navigation

Elastic Event

Use elastic-event-js to feed and query an ElasticSearch API with data from the browser.

Event logging using ElasticSearch

API Reference

Features

  • No dependencies
  • Small: 3.13 KB
  • No pre-flight requests
  • Simple Interface
  • Bulk saving of events for reduced overhead
  • Save queued events before unload of window

Install

npm install elastic-event-js
bower install Cloudoki/elastic-event-js
<script src="https://cloudoki.github.io/elastic-event-js/dist/elastic-event.min.js" type="text/javascript"></script>

Usage

Configuration

var elasticevent = new ElasticEvent({
  host: 'https://api.elasticsearch.com',
  index: 'your_index',
  setupIntervalSend: true,
  setupBeforeUnload: true
});

Identify a session

elasticevent.identify({
  sessionId: new Date().getTime()
});

Track an event, this sets _type to click.

function onClick () {
  elasticevent.track('click');
}

Track an event with more details

function onClick(event) {
  elasticevent.track('click', {
    x: (event.clientX / window.innerWidth).toPrecision(8),
    y: (event.clientY / window.innerHeight).toPrecision(8)
  });
}

Querying with an elastic DSL helper library, here we use the Bodybuilder but you may also use others, like esq or elastic.js

elasticevent.search(
  new Bodybuilder()
    .filter('term', 'sessionId.raw', elasticevent.traits.sessionId)
    .size(50)
    .build('v2'),
    null,
  function(err, resp) {
    console.log(resp);
  });

Examples

You may need to disable your ad blocker for the examples to work.

  • simple-click: A simple click event and query by identity

  • track-mouse: An example were the mouse movement and clicks are tracked and queried. More details on this example on this blog post.

To run the examples locally you can serve them with:

npm run static

Building

npm run build -s

Linting check

npm run lint -s

Documentation

You may also build and serve the API reference locally:

npm run docs -s

Documentation will be generated at ./docs

To inspect the ./docs you may want to serve your local files.

npm run static