aurelia-logging-api v1.3.6

aurelia-logging-api

Catch, bundle and send all aurelia logs to an api endpoint.

aurelia-logging-api provides an easy to use log appender for Aurelia's LogManager to bundle logs and send them to an endpoint.

The received logs are enriched with the timestamp, source logger and loglevel of the message. The actual message will be sent as list or joined with a configurable separator:

[
  {
    timestamp: '2020-01-01T12:00:00Z',
    logger: 'my-app-logger',
    loglevel: 'info',
    message: ['log', 'data', 'list']
  },
  {
    ...
  }
]

It adds the abilities to throttle sending after failed requests and catches the following javascript information/errors if configured to do so:

• window errors
• unhandled promise rejections
• requests/responses to the api

Installation

npm i aurelia-logging-api --save

Usage

aurelia-logging-api uses aurelia-fetch-client or aurelia-http-client to send logs to a server by providing it with the application's client or creating a new one. This makes reusing the connection configuration and authorization easier. Use the plugin by loading it in the app's main.js. The configuration's default values are shown, but can be changed or omitted.

import { HttpClient } from 'aurelia-fetch-client';

...

config = {
  targetUrl: '',
  client: new HttpClient(),
  bufferSize: 100,
  minLevel: logLevel.debug,
  joinMessage: false,
  requestMethod: 'post',
  requestParams: {},
  throttleRetries: true,
  retryIntervals: [5, 60, 3600],
  catchWindowErrors: false,
  catchPromiseRejections: false,
  flushOnUnload: true
};
aurelia.use.plugin('aurelia-logging-api', config);
// for webpack user, use PLATFORM.moduleName wrapper
aurelia.use.plugin(PLATFORM.moduleName('aurelia-logging-api'), config);

Using the Appender

All used logging appenders are registered with Aurelia's dependency injection under the BackendAppender class:

...

import { BackendAppender } from 'aurelia-logging-api';

@inject(BackendAppender)
class App {
  constructor(appender) {
    this.appender = appender;
  }

  irregularSend() {
    this.appender.requestQueue.sendRequest();
  }
}

Configuration

Additional error catching

aurelia-logging-api provides some convenience function to catch and log the following errors in the application.

Window errors

All javascript errors caught by the window's error handler can be logged as error by setting the config's catchWindowErrors value to true.

Undhandled promise rejections

All unhandled promise rejections (if supported by the browser) can be logged as error by setting the config's catchPromiseRejections value to true.

Api requests/responses

All requests and responses to and from a client can be logged as info by adding aurelia-logging-api's apiRequestLogger interceptor:

import { addRequestLogger } from 'aurelia-logging-api';

...

const client = new HttpClient().configure((config) => {
  config.withInterceptor(apiRequestLogger);
});