Project study / Developer Tools
Published
glassjs
Structured logging and request tracing utility.
An observability helper for consistent logs and shared request context.
System portrait / documented flow
Diagram routes and groups
Request observability path
- Service request
- Middleware / trace context
- Structured event log
02 / Problem and response
Keep service logs structured and request context connected.
Constraint
Service logs only become operationally useful when structure and context stay consistent across services.
Approach
glassjs provides shared logging conventions and request-scoped trace helpers for Node.js services.
03 / Architecture and boundaries
Middleware carries trace context into consistent structured events.
Typed logger APIs for structured events.
Request tracing helpers designed to fit backend middleware.
Structured Events
The core logger stays focused on consistent event shape and predictable integration.
Trace Context
Request-scoped context helps teams keep logs related without building that plumbing repeatedly.
- 01
Observability tooling is most effective when it removes variance instead of introducing complexity.
04 / Package surface
A small interface, in use.
Install
npm install @krazybean/glassjsUsage
import { createLogger } from "@krazybean/glassjs";
const logger = createLogger({ service: "api" });05 / Current state and next work
What exists, and what follows.
Published
The published utility continues to expand formatting integrations and trace propagation helpers.
Started 2024 · Last updated Maintained
Next direction
- Expand formatting integrations and trace propagation helpers.
Shared conventions are often more valuable than a long feature list.
Working lesson / glassjs