Stacklenzz
v1.0.0
LIVE TRACETracking Express & NestJS in real-time ⚡

Effortless Observability,
Zero Boilerplate.

A production-grade instrumentation toolkit providing Express and NestJS telemetry, Prometheus metrics, structured Winston JSON logs, and mountable React & Next.js admin dashboards.

Telemetry Stream
EXPRESS200 OKGET /api/v1/telemetry/stats
npx stacklenzz dashboard -y

The 3 Pillars of Stacklenzz

Everything you need for backend instrumentation, dashboard rendering, and tooling.

@stacklenzz/server

Plug-and-play middleware for Express and NestJS. Exposes /metrics for Prometheus scrapers, Winston JSON logging, and error tracking with automatic request-response latency percentiles (p50, p95, p99).

  • Express setupObservability(app)
  • NestJS ObservabilityModule.forRoot()
  • Breadcrumbs & Error Fingerprinting
SDK Documentation

@stacklenzz/ui

Embeddable observability dashboard package with 6 pre-built layout views, 6 runtime color themes (Tokyo Night, Nord, Dracula, etc.), and deep stack-trace inspection.

  • Native React component: <ObservabilityDashboard />
  • 6 Runtime Theme Switchers
  • Live Auto-polling & Mock Fallback Mode
UI Component Docs

@stacklenzz/cli

Command-line companion for developer happiness. Auto-detects Next.js App or Pages router, scaffolds dashboard routes, and validates server health with stacklenzz doctor.

  • stacklenzz dashboard - Auto-scaffold
  • stacklenzz doctor - Health validation
  • stacklenzz init - Configuration generator
CLI Reference
server.ts
listening :5000
import express from "express";
import { setupObservability, addBreadcrumb } from "@stacklenzz/server";

const app = express();

// 1. One line adds Prometheus metrics, OTEL tracing, Winston logs & stats API
setupObservability(app, {
  serviceName: "payment-service",
  environment: "production",
});

// 2. Track custom business breadcrumbs on any route
app.post("/api/checkout", async (req, res) => {
  addBreadcrumb({ category: "billing", message: "Processing card payment" });
  res.json({ status: "confirmed" });
});

app.listen(5000, () => console.log("🚀 Server running on port 5000"));

Ready to monitor your application?

Browse the interactive documentation for copy-paste examples, CLI commands, and complete SDK reference.

Stacklenzz • Apache 2.0 Licensed • Built with Node.js & React