让开源，少一点语言距离。
npm包中文文档

@adonis-agora/telescope

中文文档
0.27.1发布于 2026/11/02MITTypeScriptES Module零依赖构建来源已验证近 30 天下载 1.1万

Laravel Telescope-style headless observability for AdonisJS — records HTTP requests and every Agora diagnostics event as queryable entries, plus opt-in subpaths for per-technology watchers, a web dashboard, AI exception diagnosis, and alerting.

原始使用文档
中文原文

@adonis-agora/telescope

npm version npm downloads CI license

Laravel Telescope-style headless observability for AdonisJS — records every HTTP request and every agora:<lib>:<event> diagnostics publish as a queryable entry.

npm i @adonis-agora/telescope
node ace configure @adonis-agora/telescope

import { TelescopeService } from '@adonis-agora/telescope'

const telescope = await app.container.make(TelescopeService)
telescope.list({ type: 'request', size: 50 })
telescope.byTrace('abc123')
telescope.topFamilies(10, 'diagnostic')

See the repo README and DESIGN.md for the full contract, the cross-repo decoupling design, and the deferred roadmap.

License

MIT © Davi Carvalho

版本与发布记录

@adonis-agora/telescope 共发布 44 个版本，首次发布于 2026/06/23；过去 12 个月发布了 44 个版本。最新版本附带 npm provenance 构建来源证明，可追溯到公开的 CI 构建记录。

版本发布日期距今
0.27.1latest2026/11/023 天前
0.27.02026/10/307 天前
0.26.22026/10/289 天前
0.26.12026/10/289 天前
0.26.02026/10/289 天前
0.25.02026/10/289 天前

关于 @adonis-agora/telescope 的常见问题

@adonis-agora/telescope 是什么？

Laravel Telescope-style headless observability for AdonisJS — records HTTP requests and every Agora diagnostics event as queryable entries, plus opt-in subpaths for per-technology watchers, a web dashboard, AI exception diagnosis, and alerting.

如何安装 @adonis-agora/telescope？

在项目目录运行 npm install @adonis-agora/telescope，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@adonisjs/core（^7.3.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

@adonis-agora/telescope 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

@adonis-agora/telescope 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。

@adonis-agora/telescope 需要什么版本的 Node.js？

package.json 的 engines 字段要求 Node.js >=24。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

@adonis-agora/telescope 可以商用吗？

@adonis-agora/telescope 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

@adonis-agora/telescope 的下载量有多少？

根据 npm 官方下载统计，@adonis-agora/telescope 在 2026/10/05 – 2026/11/03 这 30 天内被下载 11,370 次，日均约 379 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

@adonis-agora/telescope 还在维护吗？

最新版本 0.27.1 发布于 2026/11/02（3 天前）；至今共发布 44 个版本，其中过去 12 个月发布了 44 个；首次发布于 2026/06/23。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。