advanced-logger

Advanced logger module extendable with plugins. Works in nodejs and browsers


Keywords
logger, advanced-logger, logger-plugin, sumologic, strategy, typescript, library, webpack, dts-bundle, package, jest, elasticsearch, isomorphic-javascript, json-logger, json-logging, kibana, log, logging, logging-library, loggly, loggly-client, remote-logging, typescript-logger
License
MIT
Install
npm install advanced-logger@3.0.6

Documentation

advanced-logger

Feature branch build npm version install size

Quality checks Quality Gate Status Bugs Code Smells Coverage Duplicated Lines (%) Lines of Code Maintainability Rating Reliability Rating Security Rating Technical Debt Vulnerabilities

Conventional Commits

FOSSA Status

What is it?

It is an extendable isomorphic log sending library written in TypeScript for javascript application in nodejs and browsers.

It can be extended with custom strategy ("when to send logs") and service ("where to send logs").

It does not restrict you with conventions, for example, existence of "logSeverity", "ErrorId" or "message" fields in log.

It supports any format of logs via custom serializer.

Features

  • πŸ™€ It works in browsers and nodejs
  • πŸš› It is able to send single logs and bundles of them to an external logger
  • It supports different log sending strategies:
    1. ⏰ interval (for example, every 10 seconds)
    2. πŸ“’ on request (only when you ask)
    3. ⏰ βž• πŸ“’ mixed ("interval" + "on request") (will be done soon)
    4. πŸš‚ πŸšƒ πŸšƒ πŸšƒ on bundle size (for example, sends bundles of 100 logs)
    5. 🚽 instant (received 1 log -> sent 1 log)
  • πŸ‘₯ It is able to group duplicated logs in certain time interval (for rapid fire of the same logs)
  • πŸ™ It is not afraid of circular links in log objects
  • πŸ—οΈ It supports custom format for logs (custom serializer)
  • 🎯 It supports different remote logger endpoints (SumoLogic, Loggly and Elasticsearch). Who is the next? α•™(ΰ² .ΰ² )α•—

Runtime environment support πŸƒβ€β™€οΈ

Builds are generated as ES2015 bundles for nodejs and browser environments.

πŸ€– NodeJS - tested on latest lts

🌐 Browser - all latest browsers, that support ES2015 JS.

Documentation

Complete documentation and examples can be found here:

Advanced Logger's Homepage

NPM package link

Simplest usage

Now, the boring part πŸ€“

Installation

Axios is a required peer dependency. It means that axios is not bundled into logger package, but required to be installed.

As a dependency in a npm project:

npm i --save advanced-logger axios
import {AdvancedLogger, service, strategy} from 'advanced-logger';
// or
const {AdvancedLogger, service, strategy} = require('advanced-logger');

As script tags with CDN:

<!--minified-->
<script src="https://cdn.jsdelivr.net/npm/axios@latest/dist/axios.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/advanced-logger@latest/dist/browser/advanced-logger.browser.min.js"></script>
<!--dev version-->
<script src="https://cdn.jsdelivr.net/npm/axios@latest/dist/axios.js"></script>
<script src="https://cdn.jsdelivr.net/npm/advanced-logger@latest/dist/browser-debug/advanced-logger.browser.js"></script>

Configuration

Lets initiate a logger that sends all logs instantly to Sumologic service.

import {AdvancedLogger, service, strategy} from 'advanced-logger';

const defaultLogConfig = {
    UserAgent: window.userAgent,
    Channel: "my-company",
    BuildVersion: 123,
    Platform: "browser",
    Severity: "DEBUG",
    Data: "",
    Timestamp: "",
    Message: "",
    Category: ""
};

const serviceConfig = {
    url: "https://www.google.nl",
    sourceName: "advancedLoggerTest",
    host: "advanced-logger",
    sourceCategory: "MY/SUMO/namespace",
    method: "POST"
};

const config = {serviceConfig, defaultLogConfig};

const logger = new AdvancedLogger({
    service: new service.SumologicService(config),
    strategy: new strategy.InstantStrategy()
});

logger.log({test: "instant log u1"}); // sends log message :rocket:
logger.log({test: "instant log u2"}); // sends log message :rocket:
logger.log({test: "instant log u3"}); // sends log message :rocket:

Upgrading between breaking changes

2.x to 3.x

  • Install axios to your project or just keep using it if it is already installed
  • Logger is compiled to ES2015 JS target. If your project requires support of old browsers and nodejs, please, make sure that you transpile and add necessary pollyfills to the build