@adonis-agora/telescope-ui

中文文档
2.1.0发布于 2026/10/30MITTypeScriptES Module构建来源已验证近 30 天下载 3008

@adonis-agora/望远镜的可观察性仪表板——一个反应性SPA(概览、条目+活的尾巴、条目细节、痕迹和瀑布、例外组、脉冲健康、CPU简介、活的队列和时间表、扩展页、客户端导出)

中文使用文档
文档目录3 节
  1. 显示什么
  2. 安装
  3. 设计

@ados-agora/望远镜-ui

观察力 仪表板 页:1 @adonis-agora/telescope 依赖光反应 AdonisJS提供商提供的SPA服务 不变 它消耗的JSON API的护卫. 阿戈拉生态系统的一部分.

显示什么

  • 大赦国际 ——人工智能支出(按特征/型号/支付者分列的总和、平台和估计份额), 代理运行有队列 / 模型 / 工具计时和与跟踪相连的每步分解,以及 未定价的电话,从 @adonis-agora/agent 0.93.0号 usage.recorded 财务报告和审定财务报表 run.* 事件.
  • 脉搏 - 那个 getHealth "一览"卷起:吞吐量,出错率,p99 纬度,HTTP状态 分解出,收录得最慢,路由慢,最上等例外,N+1热点,负载逐用户,缓存命中比.
  • 条目 ——带有类型 + 自由文本过滤器和一个 SSE 活尾键 预支 记录时的新条目。 纵行深通入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入出出出出出出出出出出出入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入出出出出出出出出出出出出出入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入入.
  • 条目细节 ——完整条目:能识别类型头(请求的方法/url/状态),元数据 列表,并打印出 content. 例外/client_exception 附加条目 大赦国际诊断 面板( 仅在 @adonis-agora/telescope/ai 已安装和配置)—— "有AI的诊断"称Anthropic支持 DiagnosisCoordinator 并造成可能的原因 + 建议修复,由例外家族缓存,所以重开相同的错误不会燃烧第二个模型 电话. request 条目获得一个 重播 重新对现场发布抓获的请求的行动 服务器(由于默认服务器侧而失效;面板显示为什么是).
  • 追踪 ——近代有其类型组合的痕迹,外加每道追踪 瀑布 (手卷,无相图 库)和可追踪的条目视图.
  • 例外 ——窗外有例外组(类+消息),有计数和趋势花花纹.

这是一个 纯消费者 望远镜核心的真实路线 <path>/api/* (单位:千美元)/entries, (中文(简体) ), /entries/:id, (中文(简体) ), /trace/:id, (中文(简体) ), /metrics/{pulse,stats,traces,waterfall,n-plus-one}和SSE现场直播 流点 <path>/api/stream没有捆绑的 API , 没有 NestJS 模块 .

安装

// adonisrc.ts — after the core telescope providers
providers: [
  // …
  () => import('@adonis-agora/telescope/telescope_provider'),
  () => import('@adonis-agora/telescope/ui_provider'),          // JSON API + SSE under <path>/api/*
  () => import('@adonis-agora/telescope-ui'),                   // serves the SPA at <path>
]

SPA 挂载在 config('telescope_ui').path (默认) /telescope和再利用该块的 authorize 警卫 切换它或用可选选项覆盖挂载 telescope_ui.dashboard 块 :

// config/telescope_ui.ts
import { defineConfig } from '@adonis-agora/telescope/ui'

export default defineConfig({
  path: '/telescope',
  // authorize: (ctx) => ctx.auth.user?.isAdmin === true,
  // dashboard: { enabled: true, path: '/telescope' },
})

设计

尾风 + 一个销售的阴影式组件层 基础UI (单位:千美元)button, (中文(简体) ), badge, (中文(简体) ), dialog, (中文(简体) ), tabs, (中文(简体) ), tooltip, (中文(简体) ), popover, (中文(简体) ), input, (中文(简体) ), select, (中文(简体) ), table —— 说 src/app/primitives/, (中文(简体) ), 编辑 飞行员 agora生态系统控制台共享的设计标志——相同的中性/状态 胡为: @dudousxd/nestjs-telescope-ui (这个仪表板的NestJS兄弟会) 同样的红色 --accent, (中文(简体) ), 所以无论主机框架如何,两台望远镜仪表板都匹配像素换像素. 黑暗模式第一 带有 .light- 类重置( 长期为 localStorage),反应. 仍然依赖 - 灯光在哪里 它算数:手卷的 SVG 火花和 CSS 瀑布(一个密集的、以网格为基础的失去的时间线) 像纯净的公用设施一样细微 useAsync 而不是查询库,和本地 EventSource 对于活的尾巴——没有反应路由器,没有图表库,没有表库.

版本与发布记录

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

版本发布日期距今
2.1.0latest2026/10/308 天前
2.0.22026/10/2810 天前
2.0.12026/10/2810 天前
2.0.02026/10/1721 天前
1.5.22026/10/1325 天前
1.5.12026/09/171 个月前

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

@adonis-agora/telescope-ui 是什么?

@adonis-agora/望远镜的可观察性仪表板——一个反应性SPA(概览、条目+活的尾巴、条目细节、痕迹和瀑布、例外组、脉冲健康、CPU简介、活的队列和时间表、扩展页、客户端导出)

如何安装 @adonis-agora/telescope-ui?

在项目目录运行 npm install @adonis-agora/telescope-ui,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@adonis-agora/telescope(>=0.11.0 <1.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@adonis-agora/telescope-ui 支持 TypeScript 吗?

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

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

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

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

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

@adonis-agora/telescope-ui 可以商用吗?

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

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

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

@adonis-agora/telescope-ui 还在维护吗?

最新版本 2.1.0 发布于 2026/10/30(8 天前);至今共发布 27 个版本,其中过去 12 个月发布了 27 个;首次发布于 2026/07/15。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。