Skip to content

Yet Another Logger — send logs to dedicated logging servers.

Notifications You must be signed in to change notification settings

segment-boneyard/yal

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

52 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

About

Yet Another Logger — send logs to dedicated logging servers.

Resources

Stars

Watchers

Forks

Packages

No packages published