Skip to content

telemetry-profiler 1.0.11

Install from the command line:
Learn more about npm packages
$ npm install @oslabs-beta/telemetry-profiler@1.0.11
Install via package.json:
"@oslabs-beta/telemetry-profiler": "1.0.11"

About this version

Telemetry Profiler

Telemetry Profiler is an open-source library that enables developers to acquire real time performance measurements for rapid testing and analytics.

Install via npm

$npm install @oslabs-beta/telemetry-profiler@latest

Install via package.json:

"@oslabs-beta/telemetry-profiler": "1.0.8"

Features

  • Measurement of data via duration time
  • EventLoop usage metrics
  • Log history of previous runtimes
  • Custom runtime intervals for throttling to match site limits
  • Lightweight with no large required dependencies

Disclaimer

Telemetry Profiler is currently in beta and many features are still experimental and may not work as intended. If you have any feature ideas or would like to provide feedback, please put in an Issue. Thanks.

Usage

To get started, simply import the Profiler module into your application.

import { Profiler } from '@oslabs-beta/telemetry-profiler'

Once imported, simply instantiate a new Profiler as shown below along with any of the relevant options:

const profiler = new Profiler({ eventloopData: BOOLEAN, batch: BOOLEAN, url: '<YOUR URL HERE>' })

Afterwards, you can simply wrap any function you want telemetry data on and will receive immediate feedback.

Note: If batching is set to true, you must pass a { emit: true } object along with your function in the profiler.measure function in order for it to be sent off to the provided URL properly. Otherwise, data will be sent immediately.

The below sample is

profiler.measure(myCoolFunction)(coolOptions);
profiler.measure(myCoolFunction2)(otherCoolOptions);
profiler.measure(myCoolFunction3, { emit: true })(someOtherOptions);

Asynchronous and synchronous functions are wrapped in the same manner and do not need to be differentiated in any way.

Testing input functions

Basic testing with Jest is implemented. This feature is still being expanded upon.

  • jest test runner

Details


Assets

  • telemetry-profiler-1.0.11-npm.tgz

Download activity

  • Total downloads 1
  • Last 30 days 0
  • Last week 0
  • Today 0