Skip to content
Ember library used to measure various metrics in your Ember app with ultra simple APIs.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
addon
app
config
tests
vendor
.bowerrc
.editorconfig
.ember-cli
.eslintrc.js
.gitignore
.npmignore
.travis.yml
.watchmanconfig
LICENSE.md
README.md
bower.json
ember-cli-build.js
index.js
package.json
testem.js

README.md

ember-appmetrics 🐹

Build Status Ember Observer Score

Ember library used to measure various metrics in your Ember app with ultra simple APIs. Especially useful for RUM in Ember SPAs.

Installation 💻

For Ember CLI >= 0.2.3:

ember install ember-appmetrics

For Ember CLI < 0.2.3:

ember install:addon ember-appmetrics

Compatibility

This addon is tested against the latest stable Ember version.

Usage 🏹

Inject the metrics service like 'metrics: Ember.inject.service()' into the class where you want to measure the performance or use initializers if you are going with one-time injection.

Addon provides three API for measuring the performance of a given period.

  • start : need to call this API with an event name as an argument to mark the starting point.

  • end : need to call this API with an event name as an argument to mark the ending point and it returns the duration for the corresponding mark.

  • measure : will return the latest calculated time for the given event. This API will be deprecated in the future release in the favor of end API as the end method itself return the duration.

  • getAllMetrics :

  1. will return an object containing all the previously measured metrics and its duration, if no arguments were passed.
  2. will return an array containing all the duration for the given metric name if the metric name is given as arguments.
  • clearAllMetrics : Will clear out all the performance marks and measures.
    this.get('metrics').start('accounts_page');
    Ember.run.scheduleOnce('afterRender', () => {
      let accountsPageRenderDuration = this.get('metrics').end('accounts_page');
      console.log(accountsPageRenderDuration); // will return the duration to for this render performance in milliseconds.
    });

Browser support 🌏

Since fall back mechanism of all level has been handled in the addon itself, the only thing addon need is that the browser must have Date API, which is supported in all major and minor browsers.

PS: In Safari, the User Timing API (performance.mark()) is not available, so the DevTools timeline will not be annotated with marks.

Installation 💻

  • git clone this repository
  • npm install
  • bower install

Running 👟👟

Running Tests 💉

  • ember test
  • ember test --server

Building

  • ember build

For more information on using ember-cli, visit http://www.ember-cli.com/.

Contribution 👨‍👧‍👦

Missing something? Let's work together to get that done 😉

You can’t perform that action at this time.