yal

    1.3.4 • Public • Published

    Build Status

    Yet Another Logger that pushes logs to log servers with axon/tcp to delegate network overhead.

    If you're like us and you distribute logs to several remote services, you may be using a tool like Winston to do so, and while this is helpful it's also brittle to use in mission-critical applications.

    YAL's solution is to simply distribute messages over TCP (via axon) to one or more log servers, delegating the task of processing or shipping messages off to these services. This is especially problematic when logging services are enabled only in production, and thus may not be tested properly locally or in staging environment. This can and likely will bite you.

    Check out the YAL server.

    Installation

    $ npm install yal
    

    About

    • through axon re-connection and failover is supported
    • when NODE_ENV is "development" the log level defaults to "debug"
    • when NODE_ENV is not "development" the log level defaults to "info"
    • when NODE_ENV is "test" the logger will not write to stdio
    • the log level may be altered via the LOG_LEVEL environment variable
    • standard syslog levels are supported: debug, info, warn, error, critical, alert, emergency
    • you may distribute messages to one or more axon log servers
    • YAL writes to stdio for local logging / debuggin
    • YAL sends a creation .timestamp
    • YAL sends the .hostname

    Example

    The following example shows two servers, with the logger doing round-robin requests between the two.

    var Logger = require('yal');
     
    var log = new Logger([
      'tcp://localhost:5000',
      'tcp://localhost:5001'
    ]);
     
    setInterval(function(){
      log.info('viewed page', { user: 'tobi' });
    }, 300);
     
    setInterval(function(){
      log.info('signed in', { user: 'jane' });
    }, 1000);
     
    setInterval(function(){
      log.error('oh no boom', { something: 'here' });
    }, 3000);

    API

    Logger(addresses)

    Pass a string or array of addresses.

    .LEVEL(type, msg)

    Send a log message.

    .silent()

    Disable stdio.

    License

    MIT

    Install

    npm i yal

    DownloadsWeekly Downloads

    9

    Version

    1.3.4

    License

    MIT

    Last publish

    Collaborators

    • segment-admin
    • tjholowaychuk