Packages
The full suite — core, the dashboard, watchers, storage adapters, queue managers, the OpenTelemetry bridge, the AI exception diagnoser, and test utilities. Install only what your stack needs.
Telescope is a monorepo of small, single-purpose packages. You install core plus whichever watchers, storage adapter, and queue managers match your stack — every built-in is implemented against the same public SPIs, so a community watcher or store is a first-class citizen, not a second-class hook. A package can go further and ship a whole dashboard surface as an extension (a navigable entry type + declarative dashboard pages + data providers) — @dudousxd/nestjs-durable-telescope is the canonical example.
| Package | What it is |
|---|---|
@dudousxd/nestjs-telescope | Core — request + exception watchers, recorder, ALS correlation, SQLite store, headless API, guard, pruner. |
@dudousxd/nestjs-telescope-ui | Bundled dashboard SPA + composable React components / hooks / client. |
@dudousxd/nestjs-telescope-mikro-orm | MikroORM query watcher + N+1 detector + MySQL/SQLite storage. |
@dudousxd/nestjs-telescope-typeorm | TypeORM query watcher (host-wired logger). |
@dudousxd/nestjs-telescope-prisma | Prisma query watcher ($on('query'); see correlation caveat). |
@dudousxd/nestjs-telescope-mail | Mail watcher (nodemailer sendMail). |
@dudousxd/nestjs-telescope-cache | Cache watcher (get/set hit/miss). |
@dudousxd/nestjs-telescope-schedule | Schedule watcher (@nestjs/schedule cron/interval/timeout). |
@dudousxd/nestjs-telescope-events | Event watcher (@nestjs/event-emitter). |
@dudousxd/nestjs-telescope-logs | Log watcher (Nest Logger output). |
@dudousxd/nestjs-telescope-redis-watcher | Redis command watcher (wrapped ioredis). |
@dudousxd/nestjs-telescope-mikro-orm-watcher | Model watcher (MikroORM entity lifecycle changes). |
@dudousxd/nestjs-telescope-redis | Redis-backed shared storage (multi-instance). |
@dudousxd/nestjs-telescope-bullmq | BullMQ job watcher + live queue manager (browse + mutations). |
@dudousxd/nestjs-telescope-sqs | SQS live-queue manager (depth + DLQ inspection + redrive). |
@dudousxd/nestjs-telescope-otel | OpenTelemetry trace-context provider. |
@dudousxd/nestjs-telescope-ai | AI exception diagnoser (Vercel AI SDK — Bedrock, OpenAI, any model). |
@dudousxd/nestjs-telescope-testing | In-memory store, FakeClock, watcher test harness. |
Core
The module, recorder, API, guard, and SQLite store.
Dashboard (-ui)
Turnkey SPA + composable React layers + typed client.
Watchers
Query, mail, cache, schedule, events, logs, redis, model.
Storages
MikroORM (MySQL/SQLite) and Redis adapters.
Queue managers
BullMQ and SQS live consoles + mutations.
OpenTelemetry (-otel)
Stamp entries with the active trace/span.
AI diagnosis (-ai)
Turn a captured exception into a probable-cause report.
Testing
FakeClock, watcher harness, in-memory store.
Dashboard auth
Gate the Telescope dashboard so only your logged-in admins see it — all the way to prod, no infra required. Two modes, one signed-cookie mechanism, both copy-pasteable.
@dudousxd/nestjs-telescope (core)
The core module — request + exception watchers, the recorder, ALS correlation, the zero-config SQLite store, the headless API, the gate, and the pruner.