observable-default
observable-defaultDefault console observable plugin for logging output
observable-default
observable-default is the built-in observable plugin for BSB.
It provides baseline logging and trace-aware output to stdout/stderr.
What It Provides
- Debug/info/warn/error logging
- Trace-aware message formatting
- Lightweight diagnostics for development
Minimal Example
default:
observable:
observable-default:
plugin: observable-default
enabled: true
config: {}
Behavior Notes
- Debug logs are typically suppressed in production mode
- Output is console-based (no external collector by default)
- No plugin-specific config fields are required for
observable-default
When To Replace
Use a dedicated observable plugin (observable-pino, observable-winston, observable-opentelemetry, observable-graylog, syslog) when you need centralized logs, metrics, and tracing pipelines.
Observable-Default In Production
observable-default is intentionally lightweight. It is good for local and baseline runtime logs, but it is not a full external observability backend.
Behavior
- Console output only
- Trace metadata formatting
- Debug logs suppressed in production mode
- No external transport, retention, or aggregation
Recommended Migration Path
For production-grade operations, switch to one of:
observable-pinoobservable-winstonobservable-opentelemetryobservable-graylogsyslog
Default Plugin Config Example
default:
observable:
observable-default:
plugin: observable-default
enabled: true
config: {}
observable-default itself has no required plugin-specific options.
Why Replace
- Centralized log search
- Long-term retention
- Distributed trace export
- Metrics dashboards/alerts
Installation
npm i @bsb/base
Configuration
Configuration options for this plugin:
No configuration required
Supported Features
Observable capabilities implemented by this plugin:
Logging
debug
available
info
available
warn
available
error
available
Metrics
createCounter
unavailable
createGauge
unavailable
createHistogram
unavailable
incrementCounter
unavailable
setGauge
unavailable
observeHistogram
unavailable
Tracing
spanStart
unavailable
spanEnd
unavailable
spanError
unavailable