Skip to main content
Fentaris ships a structured logger with pluggable drivers.

Logger

new Logger({
  level,
  driver,
  context,
  onWrite,
  redact,
});

Options

  • level: debug, info, warn, error, fatal.
  • driver: implements write(entry).
  • context: base context merged into every log.
  • onWrite: callback for side effects.
  • redact: true by default for sensitive keys, false to disable, or an object with keys, paths, replacement, and a custom redact(value, path, key) callback.
Redaction runs before entries reach the configured driver or onWrite. Fentaris redacts common credential fields such as tokens, secrets, passwords, authorization headers, API keys, and credential values by default. It also masks high-confidence token-like values, including bearer tokens, JWT-like strings, and GitHub-style tokens, even when they appear under generic fields such as input, body, or query.

Methods

  • debug(message, metadata?)
  • info(message, metadata?)
  • warn(message, metadata?)
  • error(message, metadata?)
  • fatal(message, metadata?)
  • child(context) to derive a logger.
  • annotate(key, value) to add metadata.
  • setTag(key, value) to tag entries.

ConsoleLoggerDriver

new ConsoleLoggerDriver();
Writes logs to stdout using structured metadata.