Plugins 〉Business Charts


Developer

Volkov Labs

Sign up to receive occasional product news and updates:


Grafana Cloud
Grafana Cloud
  • Grafana, of course
  • 10k series Prometheus metrics
  • 50 GB logs
  • 50 GB traces
  • 2,232 app o11y host hours
  • ...and more
Create free account

No credit card needed, ever.


Panel
community

Business Charts

  • Overview
  • Installation
  • Change log
  • Related content

Business Charts for Grafana

Business Charts Dashboard

Grafana YouTube Playlist CI E2E Codecov CodeQL

Business Charts is a powerful Grafana plugin that integrates the Apache ECharts library to create dynamic, interactive visualizations for your dashboards. Built with pure JavaScript and lightweight rendering via zrender, this plugin offers a wide variety of chart types and advanced statistical tools to enhance business data analysis.

📺 Watch the Tutorial:

Business Charts 6.0.0 | Visual Editor Tutorial

🚀 Key Features

  • Monaco Code Editor: Customize charts using JavaScript for Grafana data frames, JSON for configurations, and theme adjustments.
  • Code Assistance: Enjoy autocomplete for parameters and variables.
  • Rendering Options: Choose between SVG and Canvas renderers for optimal performance.
  • Interactivity: Leverage variables and locationService for dynamic visualizations.
  • Maps: Includes USA and World GeoJSON maps, with support for dynamically loading additional maps.
  • External Map APIs: Integrate with Baidu, Gaode, and Google Maps (API key required).
  • Extensions:
    • ECharts-GL: 3D plots, globe visualizations, and WebGL acceleration.
    • ecStat: Advanced statistical and data mining tools.
    • Liquid Fill Chart: Visualize percentages with fluid animations.
    • Wordcloud: Create engaging word cloud charts.
  • Real-Time Updates: Support for streaming data sources and Grafana Live.
  • Theming: Seamlessly adapts to Grafana’s light and dark themes.
  • ECharts Version: Powered by Apache ECharts 5.5.1.

Explore Examples

Discover over 100 ready-to-use chart examples at echarts.volkovlabs.io.
Example Charts

📋 Requirements

Plugin VersionCompatible Grafana Versions
Business Charts 7.xGrafana 11 or 12
Business Charts 6.xGrafana 10 or 11
Apache ECharts 5.xGrafana 9 or 10
Apache ECharts 3.x/4.xGrafana 8.5 or 9

🛠️ Installation

Install the Business Charts plugin via the Grafana Plugins Catalog or using the Grafana CLI:

grafana-cli plugins install volkovlabs-echarts-panel

After installation, restart Grafana and add the Business Charts panel to your dashboard.

📚 Documentation

Dive into detailed guides to make the most of Business Charts:

SectionDescription
Charts FunctionConfigure core Apache ECharts functions.
Visual EditorCreate charts effortlessly with the Visual Editor.
ExamplesStart with ready-made Apache ECharts examples.
FeaturesExplore all plugin capabilities.
MapsLearn to work with various map types.
TutorialsFollow step-by-step guides.
Release NotesStay updated with the latest features and fixes.

🌟 Business Suite for Grafana

Business Charts is part of the Business Suite, a collection of open-source Grafana plugins by Volkov Labs. Designed for common business needs, these plugins feature intuitive interfaces, detailed documentation, and supporting video tutorials.

Business Suite for Grafana

Enterprise Support

Upgrade to Business Suite Enterprise for premium benefits:

  • Dedicated Zendesk support team.
  • Priority handling for feature requests and bug fixes.
  • In-person consultations.
  • Access to advanced Business Intelligence tools.

💬 Feedback & Contributions

We welcome your input to improve Business Charts:

  • Issues: Report bugs or suggest features on GitHub Issues.
  • YouTube: Subscribe to Volkov Labs and share your thoughts in video comments.
  • Contributions: Fork the repository, make changes, and submit a pull request!

🙏 Acknowledgments

Apache ECharts, ECharts, Apache, the Apache feather logo, and the Apache ECharts project logo are registered trademarks or trademarks of The Apache Software Foundation.

📜 License

This project is licensed under the Apache License 2.0.

Installing Business Charts on Grafana Cloud:

For more information, visit the docs on plugin installation.

Installing on a local Grafana:

For local instances, plugins are installed and updated via a simple CLI command. Plugins are not updated automatically, however you will be notified when updates are available right within your Grafana.

1. Install the Panel

Use the grafana-cli tool to install Business Charts from the commandline:

grafana-cli plugins install 

The plugin will be installed into your grafana plugins directory; the default is /var/lib/grafana/plugins. More information on the cli tool.

2. Add the Panel to a Dashboard

Installed panels are available immediately in the Dashboards section in your Grafana main menu, and can be added like any other core panel in Grafana.

To see a list of installed panels, click the Plugins item in the main menu. Both core panels and installed panels will appear.

Changelog

All notable changes to Business Charts will be documented in this file. This project adheres to Semantic Versioning.

[7.0.0] - 2025-07-21

Breaking Changes

  • Now requires Grafana 11 or Grafana 12.

Enhancements

  • Removed @volkovlabs/grafana-utils dependency (#362).
  • Upgraded to Grafana 12.0 and updated dependencies (#371).

[6.6.0] - 2025-02-20

Enhancements

  • Added end-to-end (E2E) tests (#349).
  • Updated packages for Code Editor (#352).
  • Upgraded to Apache ECharts 5.6.0 and updated dependencies (#355).
  • Upgraded to Grafana 11.5 and updated dependencies (#361).
  • Enhanced release workflow to include attestation (#361).

[6.5.0] - 2024-10-25

Enhancements

  • Improved autosize functionality in Code Editor toolbar (#341).
  • Updated refresh handling for dashboard scenes (#346).
  • Upgraded to Grafana 11.3.0 and updated dependencies (#346).

[6.4.1] - 2024-09-16

Enhancements

  • Updated Gauge dashboard example (#337).
  • Enhanced Code Editor toolbar (#338).

[6.4.0] - 2024-09-11

Enhancements

  • Added Boxplot chart to Visual Editor (#327).
  • Upgraded to Grafana 11.2 and updated dependencies (#330).
  • Added Scatter chart to Visual Editor and restricted selection to supported chart types (#332).
  • Enabled importing of promise-based libraries (#333).
  • Improved Code Editor toolbar (#334).

[6.3.0] - 2024-08-26

Enhancements

  • Introduced Visual Editor for Bar and Sunburst charts (#322).
  • Added expandable editors (#324).
  • Updated example dashboards (#325).

[6.2.0] - 2024-08-01

Enhancements

  • Upgraded to Apache ECharts 5.5.1 (#309).
  • Improved E2E workflow using Docker (#310).
  • Updated migration for context parameters (#317).
  • Added Radar chart to Visual Editor (#316).

[6.1.0] - 2024-05-26

Enhancements

  • Added plugin E2E tests and removed Cypress (#281, #283).
  • Updated context parameters in example dashboards (#282).
  • Added Business Charts video tutorial (#291).
  • Enhanced provisioning for events (#289).
  • Improved panel options (#289).
  • Enhanced code suggestions in editor (#293).
  • Upgraded to Grafana 11.0 and updated dependencies (#294).

[6.0.0] - 2024-03-24

Breaking Changes

  • Now requires Grafana 10 or Grafana 11.
  • Removed non-context code parameters; update scripts to use context (see migration guide below).

Migration Guide

Update your code parameters as follows:

  • datacontext.panel.data
  • themecontext.grafana.theme
  • echartsInstancecontext.panel.chart
  • echartscontext.echarts
  • ecStatcontext.ecStat
  • replaceVariablescontext.grafana.replaceVariables
  • eventBuscontext.grafana.eventBus
  • locationServicecontext.grafana.locationService
  • notifySuccesscontext.grafana.notifySuccess
  • notifyErrorcontext.grafana.notifyError

Enhancements

  • Renamed plugin to "Business Charts" (#268).
  • Added Apache acknowledgment and updated description (#268).
  • Upgraded to Grafana 10.4.1 (#270).
  • Removed deprecated ArrayVector for Grafana 11 compatibility (#272).
  • Addressed Apache ECharts deprecation warnings (#272).

[5.3.0] - 2024-03-06

Enhancements

  • Upgraded to Apache ECharts 5.5.0 (#257).
  • Enhanced code parameters with Code Parameters Builder (#261).
  • Improved autosize functionality in Code Editor (#263).

[5.2.0] - 2024-02-15

Breaking Changes

  • Now requires Grafana 9.2 or Grafana 10.

Enhancements

  • Updated README and documentation (#214).
  • Added Visual Editor for data source integration (#211).
  • Updated ESLint configuration and refactored code (#237).
  • Updated dependencies and GitHub Actions (#238).
  • Added context parameter in non-visual mode (#245).
  • Implemented refresh function via Application Event Bus (#247).
  • Prevented selection of already chosen fields (#251).
  • Updated echarts.volkovlabs.io to leverage Visual Editor and data sources (#248).
  • Improved draggable handler in Visual Editor (#256).

[5.1.0] - 2023-08-11

Enhancements

  • Upgraded to Grafana 10.0.3 (#206).

Bug Fixes

  • Fixed memory leak caused by resubscribing to restore events (#208).

[5.0.0] - 2023-07-19

Breaking Changes

  • Now requires Grafana 9 or Grafana 10.

Enhancements

  • Updated documentation (#182).
  • Updated examples for Grafana 10 (#190).
  • Added Result v2 with unsubscribe function (#188).
  • Enhanced streaming to redraw charts (#188).
  • Upgraded to Grafana 10.0.0 (#191).
  • Improved README and panel options (#192).
  • Removed Grafana 8.5 support (#193).
  • Upgraded to Grafana 10.0.2 dependencies (#195).
  • Updated ESLint configuration (#196).
  • Added Wordcloud extension (#198).
  • Upgraded to Apache ECharts 5.4.3 (#199).

[4.5.0] - 2023-06-03

Enhancements

  • Migrated to Plugin Tools 1.5.2 (#171, #176).
  • Upgraded to Node 18 and npm (#172, #173).
  • Added alert for theme parsing errors (#175).
  • Updated default function to support Grafana 10 (#178).
  • Tested compatibility with Grafana 10 Preview (#179).

[4.4.0] - 2023-05-25

Enhancements

  • Increased test coverage and updated testing library (#163).
  • Upgraded to Grafana 9.5.2 (#164).
  • Updated Google Maps extension to 1.6.0 (#164).
  • Added E2E Cypress testing (#165).
  • Introduced Theme Editor for custom themes (#167).
  • Updated documentation (#166, #168).

[4.3.1] - 2023-04-21

Breaking Changes

  • Removed getDataSourceSrv parameter for security reasons (#156).

[4.3.0] - 2023-04-16

Enhancements

  • Upgraded to Grafana 9.4.7 (#146).
  • Added getDataSourceSrv parameter for data source access (#146).
  • Upgraded to Apache ECharts 5.4.2 (#147).
  • Updated USA and World GeoJSON for GeoMap (#154).
  • Added support for Alert State and Annotations (#155).

[4.2.0] - 2023-03-04

Enhancements

  • Added EventBus parameter for event publishing (#122).
  • Upgraded to Grafana 9.3.6 (#132).
  • Updated CI and release workflows (#134).
  • Removed extra padding with NoPadding (#138).
  • Set default background color to transparent (#139).
  • Added "Magic (JavaScript) Trio" tutorial (#141).
  • Upgraded to Grafana 9.4.3 (#142).

[4.1.0] - 2023-01-12

Enhancements

  • Synchronized README with documentation (#111).
  • Added streaming support for WebSockets and Grafana Live (#113).
  • Moved InfluxDB example to a guest blog post (#115).
  • Updated documentation and tutorials in README (#116).
  • Added Data Zoom to default Line example (#117).

[4.0.0] - 2022-12-20

Breaking Changes

  • World and USA GeoJSON maps are no longer loaded by default; select JSON in the Maps option.

Enhancements

  • Updated ECharts examples on https://echarts.volkovlabs.io (#103).
  • Added Calendar examples on https://echarts.volkovlabs.io (#105).
  • Updated README and moved documentation to docs.volkovlabs.io (#107).

Bug Fixes

  • Fixed JavaScript code in documentation (#102).

[3.8.0] - 2022-12-10

Enhancements

  • Updated documentation for event handling (#80).
  • Added Histograms, Clustering, and Regression tutorial (#83).
  • Added provisioning dashboards for ECharts examples on https://echarts.volkovlabs.io (#91).
  • Added Gaode map support (#95).
  • Upgraded to Grafana 9.3.1 (#97).
  • Added Google Maps support (#98).
  • Refactored map support (#99).
  • Upgraded to Apache ECharts 5.4.1 (#101).

Bug Fixes

  • Fixed disabled format options (#88).

[3.7.0] - 2022-11-16

Enhancements

  • Restricted URL loading for Baidu maps (#76).

[3.6.0] - 2022-11-13

Enhancements

  • Updated CI to Node 16 and synced with release workflow (#65).
  • Upgraded to Grafana 9.2.2 (#66).
  • Updated YouTube thumbnails (#66).
  • Updated CI to upload signed artifacts (#68).
  • Added Statistics tools (Regression, Clustering, etc.) (#69).
  • Added tutorial for reacting to mouse events (#71).
  • Added Monaco Code Editor suggestions for available parameters (#32).
  • Improved test coverage (#8).
  • Added status notifications for event handling (#74).
  • Added Baidu map support (#64).
  • Added tutorial on loading and using Baidu maps (#75).

[3.5.0] - 2022-10-04

Enhancements

  • Upgraded to Apache ECharts 5.4.0 (#52).
  • Added Stacked Bar Graph (InfluxDB) example (#55).
  • Added examples to README and updated links in plugin.json (#56).

[3.4.0] - 2022-09-21

Enhancements

  • Upgraded to Grafana 9.1.0 (#37).
  • Added YouTube tutorial for PNG/SVG images (#38).
  • Explained dashboard variable access in README (#39).
  • Upgraded to Grafana 9.1.4 (#44).
  • Added Grafana Variables video (#45).
  • Added data source instructions to README (#46).
  • Added Compatibility Check workflow (#49).
  • Upgraded to Grafana 9.1.6 (#50).
  • Added ECharts-GL extension for 3D plots, globe visualization, and WebGL acceleration (#51).

[3.3.0] - 2022-08-12

Breaking Changes

  • Signed as a Community Plugin.

Enhancements

  • Updated for inclusion in the Grafana Marketplace (#35).

[3.2.0] - 2022-08-09

Enhancements

  • Added YouTube video to README (#29).
  • Added YouTube tutorial (#31).
  • Upgraded to Grafana 9.0.6 (#34).

[3.1.0] - 2022-07-11

Enhancements

  • Added setOption() description in README and options (#12).
  • Fixed missing Maps JSON files (#14).
  • Registered USA and World maps (#20).
  • Added auto-formatting (#21).
  • Rebuilt using Grafana 9.0.2 (#22).
  • Added variables support (replaceVariables) in Code Editor (#9).
  • Added locationService parameter (#24).
  • Added Liquid Fill plugin (#25).

Bug Fixes

  • Fixed chart destruction on reset zoom (#13).

[3.0.0] - 2022-06-19

Breaking Changes

  • Now requires Grafana 8.5+ or 9.0+.
  • Switched to Monaco Code Editor from CodeMirror.
  • Upgraded to Apache ECharts 5.3.3.
  • Removed outdated ECharts extensions (echarts-wordcloud, echarts-liquidfill, echarts-gl).

Enhancements

  • Initial release based on bilibala-echarts-panel 2.2.4.
  • Updated using Volkov Labs Panel Template 2.0.0.
  • Refactored plugin (#2).
  • Replaced CodeMirror with Monaco Code Editor (#3).
  • Refactored panel and updated plugin files (#4).
  • Updated provisioning, screenshot, and removed Follow Theme (#5).
  • Added SVG and Canvas renderers (#6).