@grafana/scenes

中文文档
9.3.0发布于 2026/11/16Apache-2.0TypeScriptESM + CJS构建来源已验证近 30 天下载 28.9万

Grafana framework for building dynamic dashboards

原始使用文档
文档目录5 节
  1. About @grafana/scenes
  2. Development
  3. Setting up @grafana/scenes with a local Grafana instance
  4. Setting up local version of @grafana/scenes with app plugin
  5. Demo app
Grafana Logo

@grafana/scenes

Build highly interactive Grafana apps with ease.

About @grafana/scenes

@grafana/scenes provides a library to build highly interactive, dashboard-like experiences in Grafana's app plugins. It comes with the following features:

  • Versatile layout options.
  • Grafana panels rendering.
  • Querying & transformations support
  • Multiple time ranges support.
  • Template variables support.
  • URL sync.
  • ... and more.

For library documentation go to https://grafana.com/developers/scenes.

Development

To work on @grafana/scenes SDK, please follow the guides below.

Setting up @grafana/scenes with a local Grafana instance

To setup scenes with local Grafana, the following setup is required:

  1. Clone the Grafana Scenes repository.
  2. Clone the Grafana repository and follow the Development guide.
  3. Setup env variable GRAFANA_PATH to point to your Grafana repository directory, export GRAFANA_PATH=<path-to-grafana-directory>
  4. From Grafana Scenes root directory run ./scripts/dev.sh. This will compile @grafana/scenes with watch mode enabled and link it to your Grafana.
  5. From Grafana directory run yarn install.

If you are working on a feature in core, that needs a certain Scenes change:

  1. Add the "release" label to your PR. This will create a release for each commit you make and one when the PR is merged.
  2. Update the @grafana/scenes version in package.json to use the release you want to try
  3. Let people review your PR with this change
  4. Merge your Scenes PR
  5. Bump the Scenes version in core Grafana
  6. Sync with your branch
  7. Merge PR into grafana/grafana

Setting up local version of @grafana/scenes with app plugin

  1. Run YARN_IGNORE_PATH=1 yarn link from packages/scenes directory.
  2. Run yarn dev from packages/scenes directory.
  3. Run yarn link @grafana/scenes from app plugin directory.
  4. Start app plugin development server.

Demo app

Alternatively, use the demo app included in this repository.

版本与发布记录

@grafana/scenes 共发布 1,772 个版本,首次发布于 2023/01/09;过去 12 个月发布了 493 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
9.3.0latest2026/11/16今天
9.3.0--canary.1671.43883647610.0canary2026/11/16今天
9.2.22026/11/0412 天前
9.2.12026/11/0214 天前
9.2.1--canary.1710.41434162858.02026/11/0214 天前
9.2.02026/10/3017 天前

其他发布通道:old-version → 7.3.8-patch1,canary → 9.3.0--canary.1671.43883647610.0。

关于 @grafana/scenes 的常见问题

@grafana/scenes 是什么?

Grafana framework for building dynamic dashboards

如何安装 @grafana/scenes?

在项目目录运行 npm install @grafana/scenes,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:rxjs(^7.8.1)、react(^18.0.0 || ^19.0.0)、react-dom(^18.0.0 || ^19.0.0)、@grafana/ui(>=12.4)、@grafana/data(>=12.4)、@grafana/i18n(>=12.4)、@grafana/schema(>=12.4)、@grafana/runtime(>=12.4)、react-router-dom(^6.28.0)、@grafana/e2e-selectors(>=12.4)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@grafana/scenes 支持 TypeScript 吗?

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

@grafana/scenes 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@grafana/scenes 可以商用吗?

@grafana/scenes 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@grafana/scenes 的下载量有多少?

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

@grafana/scenes 还在维护吗?

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