GreptimeDB 现已成为 @PersesDev 的原生数据源 —— 该 CNCF 可观测性仪表盘项目。相关插件已合并至 Perses 官方插件仓库。

在一个仪表盘中： • 通过 PromQL 查询指标（复用你的 Prometheus 仪表盘） • 通过 SQL 查询日志、链路追踪和时间序列聚合

列出所有追踪只需一行：

SELECT * FROM web_trace_demo WHERE parent_span_id IS NULL

点击一行，右侧即打开甘特图视图。

PR 地址：https://github.com/perses/plugins/pull/629…

完整博客：https://greptime.com/blogs/2026-06-24-greptimedb-perses-observability…

perses/plugins

来源：https://github.com/perses/plugins

Perses Plugins

本仓库包含 Perses（https://github.com/perses/perses）的核心插件。

开发

前置依赖：

• NodeJS 22 或更高版本（https://nodejs.org/）。
• npm 10 或更高版本（https://www.npmjs.com/）。

首先在仓库根目录执行 npm install。

然后在 perses（https://github.com/perses/perses）仓库中：

1. 更新 Perses 配置文件 config.yaml，为该插件启用开发服务器：

   plugin:
     enable_dev: true
   

2. 启动后端：./scripts/api_backend_dev.sh

3. 使用 percli 登录后端：percli login http://localhost:8080

4. 启动插件开发服务器：percli plugin start /path/to/the/plugin/dir

使用 Snapshot

通过 snapshot 可以获取 perses 核心的最新更新，以便在插件中测试更改。

1. 在 perses/perses 中创建 snapshot（https://github.com/perses/perses/blob/30758a963337564ab58c78646a1134e51d74e146/RELEASE.md?plain=1#L109-L146）。Snapshot 会发布到 npm：

   • https://www.npmjs.com/package/@perses-dev/components/
   • https://www.npmjs.com/package/@perses-dev/core
   • https://www.npmjs.com/package/@perses-dev/plugin-system
   • https://www.npmjs.com/package/@perses-dev/dashboards
   • https://www.npmjs.com/package/@perses-dev/explore

2. 复制你的 snapshot 名称，例如 v0.0.0-snapshot-panel-actions-520389b。

3. 在 perses/plugins 中，进入你正在修改的插件目录，安装 snapshot npm 包，这些包应作为 “dependencies” 而非 “peerDependencies” 安装，例如：

   # perses/plugins/timeserieschart/package.json
   
   "dependencies": {
       "color-hash": "^2.0.2"
   +   "@perses-dev/components": "v0.0.0-snapshot-panel-actions-520389b",
   +   "@perses-dev/core": "v0.0.0-snapshot-panel-actions-520389b",
   +   "@perses-dev/plugin-system": "v0.0.0-snapshot-panel-actions-520389b"
     },
     "peerDependencies": {
       "@emotion/react": "^11.7.1",
       "@emotion/styled": "^11.6.0",
       "@hookform/resolvers": "^3.2.0",
   -   "@perses-dev/components": "^0.51.0-rc.1",
   -   "@perses-dev/core": "^0.51.0-rc.1",
   -   "@perses-dev/plugin-system": "^0.51.0-rc.1",
       "date-fns": "^4.1.0",
       "date-fns-tz": "^3.2.0",
       "echarts": "5.5.0",
       "lodash": "^4.17.21",
       "react": "^17.0.2 || ^18.0.0",
       "react-dom": "^17.0.2 || ^18.0.0",
       "use-resize-observer": "^9.0.0",
       "immer": "^10.1.1"
     }
   

4. 然后在插件文件夹中执行 npm install 以更新依赖（例如 cd perses/plugins/timeserieschart && npm install）。