Guides
Task-oriented recipes for Telescope — write a custom watcher, implement a custom storage backend, build a dashboard extension, shape what gets captured with tags and redaction, correlate by request context, and add AI exception diagnosis.
Concept pages explain how Telescope works; these guides are how to do a specific thing. Each one is a worked example against the real APIs, ending with a short "how it works" dissection of the load-bearing lines.
| Guide | When you reach for it |
|---|---|
| Custom watcher | A subsystem you want in Telescope that no built-in watcher covers. |
| Custom storage adapter | You need a backend other than memory or Lucid (Mongo, Redis, …). |
| Building an extension | A sibling library should add its own dashboard page. |
| Tags & redaction | Shape what gets captured — extra tags, drop noise, scrub secrets. |
| Request context | Correlate entries to a user / trace and pivot on them. |
| AI exception diagnosis | Turn an exception into a cause + fix with Claude. |
Looking for a concept rather than a task? Start at Capture & correlation.
Advanced / programmatic
The lower-level store-decorator and helper exports of @adonis-agora/telescope — bounded redaction (redactBounded / RedactingTelescopeStore / compileRedactSpec), tail-sampling (SamplingTelescopeStore / passesSampling / resolveSampling), and the live-stream bus (EntryEvents / StreamingTelescopeStore / streamEntries) — for wiring a custom store chain by hand.
Custom watcher
Build your own Telescope watcher — implement the Watcher contract over the AdonisJS event emitter, record through the guarded safeRecord helper with trace correlation, and register it so it starts and stops with your app.