插件 〉业务图表
业务图表
适用于 Grafana 的业务图表
简介
业务图表面板允许您将由 Apache ECharts 库创建的图表集成到您的 Grafana 仪表盘中。
Apache ECharts 是一个功能强大且多用途的数据可视化库,提供包括统计功能在内的多种图表类型。它完全用 JavaScript 编写,并基于 zrender,这是一个用于图表渲染的轻量级图形库。
业务图表插件提供了一种便捷的方式,可将直观、交互式且高度可定制的图表添加到您的 Grafana 仪表盘中。
要求
- 业务图表面板 6.X 需要 Grafana 10 或 Grafana 11。
- Apache ECharts 面板 5.X 需要 Grafana 9 或 Grafana 10。
- Apache ECharts 面板 3.X 和 4.X 需要 Grafana 8.5 或 Grafana 9。
入门指南
您可以从 Grafana 插件目录 或使用 Grafana 命令行工具安装业务图表面板。
对于后者,请使用以下命令。
grafana-cli plugins install volkovlabs-echarts-panel
亮点
- 提供 Monaco 代码编辑器,用于
- 处理 Grafana 数据帧(JavaScript)。
- 更新 JSON 格式的图表配置。
- 自定义主题配置。
- 支持代码编辑器对参数和变量的建议。
- 支持 SVG 和 Canvas 渲染器。
- 支持变量和 locationService 以使图表具有交互性。
- 包含美国和世界 GeoJSON 地图。可以动态加载更多地图。
- 支持百度地图、高德地图和谷歌地图(需提供访问密钥)。
- 包含 ECharts-GL,提供 3D 图、地球可视化和 WebGL 加速。
- 包含 ecStat,一个统计和数据挖掘工具。
- 包含 水球图,用于以百分比表示数据。
- 支持使用流数据源和 Grafana Live 进行实时数据更新。
- 支持根据 Grafana 主题调整的浅色和深色主题。
- 基于 Apache ECharts 5.5.1。
- 在 echarts.volkovlabs.io 提供 100+ 个即用示例。
- 支持词云扩展
文档
章节 | 描述 |
---|---|
图表功能 | 解释如何配置主要的 Apache ECharts 库函数。 |
可视化编辑器 | 解释如何使用可视化编辑器。 |
示例 | 解释如何在 Grafana 中开始使用 Apache ECharts 示例。 |
特性 | 演示业务图表面板的特性。 |
地图 | 演示如何使用不同的地图。 |
教程 | 业务图表面板教程。 |
发布说明 | 及时了解最新特性和更新。 |
适用于 Grafana 的 Business Suite
Business Suite 是 Volkov Labs 创建并积极维护的一系列开源插件。
该系列旨在通过提供直观的界面、详细的书面文档、示例和视频教程来解决最常见的业务任务。
企业支持
购买 Business Suite Enterprise,您获得的不仅是一个产品,更是一个完整的支持系统。您将拥有一支专门的支持团队,随时准备解决任何问题。
您可以通过 Zendesk 联系我们,在功能请求和错误修复方面获得优先权,与我们进行面对面咨询,并获得商业智能的访问权限。这是一个旨在让您的工作更轻松的打包方案。
期待您的来信
- 在 GitHub issues 上提问、请求新功能或报告问题。
- 订阅我们的 YouTube 频道并留下您的评论。
- 成为 Business Suite 赞助商。
致谢
Apache Software Foundation 的 Apache ECharts、ECharts、Apache、Apache feather 和 Apache ECharts 项目标志是 Apache Software Foundation 的注册商标或商标。
许可
Apache 许可证 2.0 版,参见 LICENSE。
在 Grafana Cloud 上安装业务图表
在 Grafana Cloud 实例上安装插件是一键完成的;更新也一样。很酷,对吧?
请注意,插件可能需要最多 1 分钟才会显示在您的 Grafana 中。
在 Grafana Cloud 实例上安装插件是一键完成的;更新也一样。很酷,对吧?
请注意,插件可能需要最多 1 分钟才会显示在您的 Grafana 中。
在 Grafana Cloud 实例上安装插件是一键完成的;更新也一样。很酷,对吧?
请注意,插件可能需要最多 1 分钟才会显示在您的 Grafana 中。
在 Grafana Cloud 实例上安装插件是一键完成的;更新也一样。很酷,对吧?
请注意,插件可能需要最多 1 分钟才会显示在您的 Grafana 中。
在 Grafana Cloud 实例上安装插件是一键完成的;更新也一样。很酷,对吧?
请注意,插件可能需要最多 1 分钟才会显示在您的 Grafana 中。
在 Grafana Cloud 实例上安装插件是一键完成的;更新也一样。很酷,对吧?
请注意,插件可能需要最多 1 分钟才会显示在您的 Grafana 中。
在 Grafana Cloud 实例上安装插件是一键完成的;更新也一样。很酷,对吧?
请注意,插件可能需要最多 1 分钟才会显示在您的 Grafana 中。
欲了解更多信息,请访问插件安装文档。
在本地 Grafana 上安装
对于本地实例,插件通过简单的 CLI 命令进行安装和更新。插件不会自动更新,但当有更新可用时,您会在 Grafana 中收到通知。
1. 安装面板
使用 grafana-cli 工具从命令行安装业务图表
grafana-cli plugins install
插件将被安装到您的 grafana 插件目录中;默认路径为 /var/lib/grafana/plugins。更多关于 cli 工具的信息。
2. 将面板添加到仪表盘
已安装的面板会立即显示在 Grafana 主菜单的“仪表盘”部分,并且可以像 Grafana 中的任何其他核心面板一样添加。
要查看已安装面板列表,请单击主菜单中的“插件”项。核心面板和已安装面板都会显示出来。
更新日志
6.6.0 (2025-02-20)
特性 / 增强功能
- 添加了端到端测试 (#349)
- 更新了代码编辑器包 (#352)
- 更新到 Apache ECharts 5.6.0 及依赖项 (#355)
- 更新到 Grafana 11.5 及依赖项 (#361)
- 更新了发布工作流以包含证明 (#361)
6.5.0 (2024-10-25)
特性 / 增强功能
- 更新了代码编辑器工具栏自动调整大小 (#341)
- 更新了仪表盘场景刷新 (#346)
- 更新到 Grafana 11.3.0 及依赖项 (#346)
6.4.1 (2024-09-16)
特性 / 增强功能
- 更新了 Gauge 仪表盘 (#337)
- 更新了代码编辑器工具栏 (#338)
6.4.0 (2024-09-11)
特性 / 增强功能
- 在可视化编辑器中添加了箱线图 (#327)
- 更新了 Grafana 11.2 依赖项 (#330)
- 在可视化编辑器中添加了散点图,并限制选择为支持的图表 (#332)
- 添加了 promise 库导入 (#333)
- 更新了代码编辑器工具栏 (#334)
6.3.0 (2024-08-26)
特性 / 增强功能
- 添加了柱状图和旭日图的可视化编辑器 (#322)
- 添加了可展开编辑器 (#324)
- 更新了示例仪表盘 (#325)
6.2.0 (2024-08-01)
特性 / 增强功能
- 更新到 Apache ECharts 5.5.1 (#309)
- 更新了使用 Docker 的端到端工作流 (#310)
- 更新了上下文参数迁移 (#317)
- 在可视化编辑器中添加了雷达图 (#316)
6.1.0 (2024-05-26)
特性 / 增强功能
- 添加了插件端到端测试并移除 cypress (#281, #283)
- 更新了示例中的上下文参数 (#282)
- 添加了业务图表视频教程 (#291)
- 更新了事件的 Provisioning (#289)
- 更新了面板选项 (#289)
- 更新了代码建议 (#293)
- 更新到 Grafana 11.0 及依赖项 (#294)
6.0.0 (2024-03-24)
重大变更
- 需要 Grafana 10 和 Grafana 11。
- 移除了非上下文代码参数。请更新参数以使用
context
。
代码参数迁移指南
- data -> context.panel.data
- theme -> context.grafana.theme
- echartsInstance -> context.panel.chart
- echarts -> context.echarts
- ecStat -> context.ecStat
- replaceVariables -> context.grafana.replaceVariables
- eventBus -> context.grafana.eventBus
- locationService -> context.grafana.locationService
- notifySuccess -> context.grafana.notifySuccess
- notifyError -> context.grafana.notifyError
特性 / 增强功能
- 名称更新为业务图表面板 (#268)
- 添加了 Apache 致谢并更新了描述 (#268)
- 更新到 Grafana 10.4.1 (#270)
- 移除了在 Grafana 11 中已弃用的 ArrayVector (#272)
- 更新了 Apache ECharts 弃用警告 (#272)
5.3.0 (2024-03-06)
特性 / 增强功能
- 更新到 Apache ECharts 5.5.0 (#257)
- 使用代码参数构建器更新了代码参数 (#261)
- 更新了代码编辑器自动调整大小 (#263)
5.2.0 (2024-02-15)
重大变更
- 需要 Grafana 9.2 和 Grafana 10
特性 / 增强功能
- 更新了 README 和文档 (#214)
- 添加了用于处理数据源的可视化编辑器 (#211)
- 更新了 ESLint 配置并进行了重构 (#237)
- 更新了依赖项和 Actions (#238)
- 为非可视化模式添加了 context 参数 (#245)
- 使用 Application Event Bus 添加了刷新功能 (#247)
- 更新为不允许选择已选字段 (#251)
- 更新了 echarts.volkovlabs.io 以使用可视化编辑器和数据源 (#248)
- 更新了可视化编辑器中的可拖动处理程序 (#256)
5.1.0 (2023-08-11)
特性 / 增强功能
- 更新到 Grafana 10.0.3 (#206)
错误修复
- 修复了重新订阅 restore 事件时的内存泄漏 (#208)
5.0.0 (2023-07-19)
重大变更
- 需要 Grafana 9 和 Grafana 10
特性 / 增强功能
- 更新了文档 (#182)
- 更新了示例以支持 Grafana 10 (#190)
- 添加了带有取消订阅功能的 Result v2 (#188)
- 更新了流式传输以重绘图表 (#188)
- 更新到 Grafana 10.0.0 (#191)
- 更新了 README 和面板选项 (#192)
- 移除了对 Grafana 8.5 的支持 (#193)
- 更新到 Grafana 10.0.2 依赖项 (#195)
- 更新了 ESLint 配置 (#196)
- 添加了词云扩展 (#198)
- 更新到 Apache ECharts 5.4.3 (#199)
4.5.0 (2023-06-03)
特性 / 增强功能
- 迁移到 Plugin Tools 1.5.2 (#171, #176)
- 更新到 Node 18 和 npm (#172, #173)
- 添加了主题解析错误的告警 (#175)
- 更新了 Default Function 以支持 Grafana 10 (#178)
- 在 Grafana 10 Preview 上测试 (#179)
4.4.0 (2023-05-25)
特性 / 增强功能
- 提高了测试覆盖率并更新了测试库 (#163)
- 更新到 Grafana 9.5.2 (#164)
- 将 Google Maps Extension 更新到 1.6.0 (#164)
- 添加了端到端 Cypress 测试 (#165)
- 添加了主题编辑器以允许自定义主题 (#167)
- 更新了文档 (#166, #168)
4.3.1 (2023-04-21)
重大变更
- 由于安全原因,移除了 getDataSourceSrv 参数 (#156)
4.3.0 (2023-04-16)
特性 / 增强功能
- 更新到 Grafana 9.4.7 (#146)
- 添加了 getDataSourceSrv 参数以获取数据源的入口点 (#146)
- 更新到 Apache ECharts 5.4.2 (#147)
- 更新了 GeoMap 中使用的美国和世界 GeoJSON (#154)
- 添加了告警状态和注释 (#155)
4.2.0 (2023-03-04)
特性 / 增强功能
- 将 EventBus 添加到可用参数中以发布事件 (#122)
- 更新到 Grafana 9.3.6 (#132)
- 更新了 CI 和发布工作流 (#134)
- 添加了 NoPadding 以移除额外的填充 (#138)
- 默认将背景颜色设置为透明 (#139)
- 添加了 Magic (JavaScript) Trio 教程 (#141)
- 更新到 Grafana 9.4.3 (#142)
4.1.0 (2023-01-12)
特性 / 增强功能
- 将 README 文件与文档同步 (#111)
- 添加了对 WebSockets 和 Grafana Live 的流式传输支持 (#113)
- 将 InfluxDB 示例移至访客博客文章 (#115)
- 更新了 README 中的文档和教程 (#116)
- 为默认折线图示例添加了数据缩放 (#117)
4.0.0 (2022-12-20)
重大变更
- 世界和美国 GeoJSON 地图默认不加载。请在地图选项中选择
JSON
。
特性 / 增强功能
- 更新了 https://echarts.volkovlabs.io 上的 ECharts 示例 (#103)
- 在 https://echarts.volkovlabs.io 添加了日历示例 (#105)
- 更新了 README 并将文档移至 docs.volkovlabs.io (#107)
错误修复
- 修复了文档中的 javascript 代码 (#102)
3.8.0 (2022-12-10)
特性 / 增强功能
- 更新了事件处理文档 (#80)
- 添加了直方图、聚类、回归教程 (#83)
- 为 https://echarts.volkovlabs.io 上的 ECharts 示例添加了 Provisioning 仪表盘 (#91)
- 添加了高德地图支持 (#95)
- 更新到 Grafana 9.3.1 (#97)
- 添加了谷歌地图支持 (#98)
- 重构了地图支持 (#99)
- 更新到 Apache ECharts 5.4.1 (#101)
错误修复
- 修复了禁用的格式选项 (#88)
3.7.0 (2022-11-16)
特性 / 增强功能
- 限制了加载百度地图的 URL (#76)
3.6.0 (2022-11-13)
特性 / 增强功能
- 将 CI 更新到 Node 16 并与发布工作流同步 (#65)
- 更新到 Grafana 9.2.2 (#66)
- 更新了 YouTube 缩略图 (#66)
- 更新了 CI 以上传签名工件 (#68)
- 添加了统计工具(回归、聚类等)(#69)
- 添加了如何响应鼠标事件 (#71)
- 为可用参数添加了 Monaco 代码编辑器建议 (#32)
- 提高了测试覆盖率 (#8)
- 在事件处理中添加了状态通知 (#74)
- 添加了百度地图支持 (#64)
- 添加了如何加载和使用百度地图的教程 (#75)
3.5.0 (2022-10-04)
特性 / 增强功能
- 更新到 Apache ECharts 5.4.0 (#52)
- 添加了堆叠柱状图 (InfluxDB) 示例 (#55)
- 在 README 中添加了示例并更新了 Plugin.json 中的链接 (#56)
3.4.0 (2022-09-21)
特性 / 增强功能
- 更新到 Grafana 9.1.0 (#37)
- 添加了 PNG/SVG 图像的 YouTube 教程 (#38)
- 访问仪表盘变量 - 在 README 中解释 (#39)
- 更新到 Grafana 9.1.4 (#44)
- 添加了 Grafana 变量视频 (#45)
- 在 README 中添加了数据源说明 (#46)
- 添加了兼容性检查工作流 (#49)
- 更新到 Grafana 9.1.6 (#50)
- 添加了 ECharts-GL 扩展,提供 3D 图、地球可视化和 WebGL 加速 (#51)
3.3.0 (2022-08-12)
重大变更
- 签名为社区插件。
特性 / 增强功能
- 更新以包含在 Grafana Marketplace 中 (#35)
3.2.0 (2022-08-09)
特性 / 增强功能
- 在 README 中添加了 YouTube 视频 (#29)
- 添加了 YouTube 教程 (#31)
- 更新到 Grafana 9.0.6 (#34)
3.1.0 (2022-07-11)
特性 / 增强功能
- 在 README 和选项中添加了 setOption() 描述 (#12)
- 地图 json 文件缺失 (#14)
- 注册美国和世界地图 (#20)
- 添加了自动格式化 (#21)
- 使用 Grafana 9.0.2 重建 (#22)
- 在代码编辑器中添加了变量支持 (
replaceVariables
) (#9) - 添加了
locationService
参数 (#24) - 添加了水球图插件 (#25)
错误修复
- 重置缩放会销毁图表 (#13)
3.0.0 (2022-06-19)
重大变更
- 需要 Grafana 8.5+ 和 9.0+
- 使用 Monaco 代码编辑器代替 Code Mirror
- 基于 ECharts 5.3.3
- 移除了过时的 ECharts 扩展 (echarts-wordcloud, echarts-liquidfill, echarts-gl)
特性 / 增强功能
- 基于 bilibala-echarts-panel 2.2.4 的初始版本
- 基于 Volkov Labs Panel Template 2.0.0 更新
- 重构插件 (#2)
- 用 Monaco 代码编辑器替换 Code Mirror (#3)
- 重构面板并更新插件文件 (#4)
- 更新 Provisioning、截图并移除跟随主题 (#5)
- 添加了 SVG 和 Canvas 渲染器 (#6)