bunyan - npm Package Versions

Allow an optional msg and arguments to the log.info(<Error> err) logging form. For example, before:

  log.debug(my_error_instance)            // good
  log.debug(my_error_instance, "boom!")   // wasn't allowed

Now the latter is allowed if you want to expliciting set the log msg. Of course this applies to all the log.{trace|debug|info...}() methods.

bunyan cli output: clarify extra fields with quoting if empty or have spaces. E.g. 'cmd' and 'stderr' in the following:

  [2012-02-12T00:30:43.736Z] INFO: mo-docs/43194 on banana.local: buildDocs results (req_id=185edca2-2886-43dc-911c-fe41c09ec0f5, route=PutDocset, error=null, stderr="", cmd="make docs")

[issue #2] Add guard on JSON.stringifying of log records before emission. This will prevent log.info et al throwing on record fields that cannot be represented as JSON. An error will be printed on stderr and a clipped log record emitted with a 'bunyanMsg' key including error details. E.g.:

  bunyan: ERROR: could not stringify log record from /Users/trentm/tm/node-bunyan/examples/unstringifyable.js:12: TypeError: Converting circular structure to JSON
  {
    "name": "foo",
    "hostname": "banana.local",
    "bunyanMsg": "bunyan: ERROR: could not stringify log record from /Users/trentm/tm/node-bunyan/examples/unstringifyable.js:12: TypeError: Converting circular structure to JSON",
  ...

Some timing shows this does effect log speed:

  $ node tools/timeguard.js     # before
  Time try/catch-guard on JSON.stringify:
   - log.info:  0.07365ms per iteration
  $ node tools/timeguard.js     # after
  Time try/catch-guard on JSON.stringify:
   - log.info:  0.07368ms per iteration

Use 10/20/... instead of 1/2/... for level constant values. Ostensibly this allows for intermediary levels from the defined "trace/debug/..." set. However, that is discouraged. I'd need a strong user argument to add support for easily using alternative levels. Consider using a separate JSON field instead.

s/service/name/ for Logger name field. "service" is unnecessarily tied to usage for a service. No need to differ from log4j Logger "name".

Add log.level(...) and log.levels(...) API for changing logger stream levels.

Add TRACE|DEBUG|INFO|WARN|ERROR|FATAL level constants to exports.

Add log.info(err) special case for logging an Error instance. For example log.info(new TypeError("boom") will produce:

  ...
  "err": {
    "message": "boom",
    "name": "TypeError",
    "stack": "TypeError: boom\n    at Object.<anonymous> ..."
  },
  "msg": "boom",
  ...

Add new Logger({src: true}) config option to have a 'src' attribute be automatically added to log records with the log call source info. Example:

  "src": {
    "file": "/Users/trentm/tm/node-bunyan/examples/src.js",
    "line": 20,
    "func": "Wuzzle.woos"
  },