bunyan - npm Package Versions

Automatic paging support in the bunyan CLI (similar to git log et al). IOW, bunyan will open your pager (by default less) and pipe rendered log output through it. A main benefit of this is getting colored logs with a pager without the pain. Before you had to explicit use --color to tell bunyan to color output when the output was not a TTY:

  bunyan foo.log --color | less -R        # before
  bunyan foo.log                          # now

Disable with the --no-pager option or the BUNYAN_NO_PAGER=1 environment variable.

Limitations: Only supported for node >=0.8. Windows is not supported (at least not yet).

Switch test suite to nodeunit (still using a node-tap'ish API via a helper).

[issue #33] Log rotation support:

  var bunyan = require('bunyan');
  var log = bunyan.createLogger({
      name: 'myapp',
      streams: [{
          type: 'rotating-file',
          path: '/var/log/myapp.log',
          count: 7,
          period: 'daily'
      }]
  });

Tweak to CLI default pretty output: don't special case "latency" field. The special casing was perhaps nice, but less self-explanatory. Before:

  [2012-12-27T21:17:38.218Z]  INFO: audit/45769 on myserver: handled: 200 (15ms, audit=true, bar=baz)
    GET /foo
    ...

After:

  [2012-12-27T21:17:38.218Z]  INFO: audit/45769 on myserver: handled: 200 (audit=true, bar=baz, latency=15)
    GET /foo
    ...

Exit CLI on EPIPE, otherwise we sit there useless processing a huge log file with, e.g. bunyan huge.log | head.

Guards on -c CONDITION usage to attempt to be more user friendly. Bogus JS code will result in this:

  $ bunyan portal.log -c 'this.req.username==boo@foo'
  bunyan: error: illegal CONDITION code: SyntaxError: Unexpected token ILLEGAL
    CONDITION script:
      Object.prototype.TRACE = 10;
      Object.prototype.DEBUG = 20;
      Object.prototype.INFO = 30;
      Object.prototype.WARN = 40;
      Object.prototype.ERROR = 50;
      Object.prototype.FATAL = 60;
      this.req.username==boo@foo
    Error:
      SyntaxError: Unexpected token ILLEGAL
          at new Script (vm.js:32:12)
          at Function.Script.createScript (vm.js:48:10)
          at parseArgv (/Users/trentm/tm/node-bunyan-0.x/bin/bunyan:465:27)
          at main (/Users/trentm/tm/node-bunyan-0.x/bin/bunyan:1252:16)
          at Object.<anonymous> (/Users/trentm/tm/node-bunyan-0.x/bin/bunyan:1330:3)
          at Module._compile (module.js:449:26)
          at Object.Module._extensions..js (module.js:467:10)
          at Module.load (module.js:356:32)
          at Function.Module._load (module.js:312:12)
          at Module.runMain (module.js:492:10)

And all CONDITION scripts will be run against a minimal valid Bunyan log record to ensure they properly guard against undefined values (at least as much as can reasonably be checked). For example:

  $ bunyan portal.log -c 'this.req.username=="bob"'
  bunyan: error: CONDITION code cannot safely filter a minimal Bunyan log record
    CONDITION script:
      Object.prototype.TRACE = 10;
      Object.prototype.DEBUG = 20;
      Object.prototype.INFO = 30;
      Object.prototype.WARN = 40;
      Object.prototype.ERROR = 50;
      Object.prototype.FATAL = 60;
      this.req.username=="bob"
    Minimal Bunyan log record:
      {
        "v": 0,
        "level": 30,
        "name": "name",
        "hostname": "hostname",
        "pid": 123,
        "time": 1355514346206,
        "msg": "msg"
      }
    Filter error:
      TypeError: Cannot read property 'username' of undefined
          at bunyan-condition-0:7:9
          at Script.Object.keys.forEach.(anonymous function) [as runInNewContext] (vm.js:41:22)
          at parseArgv (/Users/trentm/tm/node-bunyan-0.x/bin/bunyan:477:18)
          at main (/Users/trentm/tm/node-bunyan-0.x/bin/bunyan:1252:16)
          at Object.<anonymous> (/Users/trentm/tm/node-bunyan-0.x/bin/bunyan:1330:3)
          at Module._compile (module.js:449:26)
          at Object.Module._extensions..js (module.js:467:10)
          at Module.load (module.js:356:32)
          at Function.Module._load (module.js:312:12)
          at Module.runMain (module.js:492:10)

A proper way to do that condition would be:

  $ bunyan portal.log -c 'this.req && this.req.username=="bob"'

[issue #56] Support bunyan -p NAME to dtrace all PIDs matching 'NAME' in their command and args (using ps -A -o pid,command | grep NAME or, on SunOS pgrep -lf NAME). E.g.:

  bunyan -p myappname

This is useful for usage of node's cluster module where you'll have multiple worker processes.