Plugins 〉Business Media
Business Media
Business Media for Grafana
Business Media is a powerful Grafana plugin designed to display a variety of media files, including PNG, JPG, GIF, MP4, WEBM, MP3, OGG, and PDF, using base64 encoding or direct URLs. Seamlessly integrate multimedia content into your Grafana dashboards with ease and flexibility.
🚀 Features
- Versatile Media Support: Render images, videos, audio, and PDFs using base64-encoded data or URLs.
- Pagination: Display multiple media files with intuitive pagination controls.
- Flexible Data Handling: Supports base64 content with or without format definitions (e.g.,
data:image/jpg;base64,ENCODED-CONTENT). - Field Selection: Choose specific fields from data sources returning multiple string fields.
- Customizable Display: Fit media to panel size, retain original dimensions, or set custom dimensions.
- Interactive Navigation: Add clickable URLs with titles to link to other dashboards, supporting dashboard variables.
- User-Friendly Toolbar: Download, zoom, and navigate between media files effortlessly.
📋 Requirements
Ensure your Grafana version meets the requirements for the Business Media panel:
| Plugin Version | Compatible Grafana Versions |
|---|---|
| Business Media 6.X | Grafana 10, Grafana 11 |
| Business Media 5.X | Grafana 10, Grafana 11 |
| Base64 Image/PDF 4.X | Grafana 9, Grafana 10 |
| Base64 Image/PDF 3.X | Grafana 8.5, Grafana 9 |
| Base64 Image/PDF 2.X | Grafana 8 |
| Base64 Image/PDF 1.X | Grafana 7.1 |
🛠️ Installation
Install the Business Media panel via the Grafana Plugins Catalog or using the Grafana CLI.
Using Grafana CLI
grafana cli plugins install volkovlabs-image-panel
📚 Documentation
Explore detailed guides and resources to make the most of the Business Media panel:
| Section | Description |
|---|---|
| Supported Formats | Learn about supported media formats and how to display them. |
| Options | Understand all available configuration options. |
| Features | Discover the full range of panel capabilities. |
| Tutorials | Follow step-by-step guides for common use cases. |
| Release Notes | Stay updated with the latest features and improvements. |
🌟 Business Suite for Grafana
The Business Suite is a collection of open-source plugins developed and maintained by Volkov Labs. Designed to address common business needs, these plugins offer intuitive interfaces, comprehensive documentation, practical examples, and video tutorials.
Enterprise Support
Elevate your experience with Business Suite Enterprise. Benefits include:
- Dedicated support via Zendesk.
- Priority handling for feature requests and bug fixes.
- In-person consultations.
- Access to exclusive Business Intelligence features.
💬 Get in Touch
We value your feedback and are eager to assist:
- Ask Questions or Report Issues: Use GitHub Issues.
- Watch Tutorials: Subscribe to our YouTube Channel and leave comments.
📜 License
This project is licensed under the Apache License Version 2.0. See the LICENSE file for details.
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Installing Business Media on Grafana Cloud:
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
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 Media 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.
Alternatively, you can manually download the .zip file for your architecture below and unpack it into your grafana plugins directory.
Alternatively, you can manually download the .zip file and unpack it into your grafana plugins directory.
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 this project will be documented in this file. This project adheres to Semantic Versioning.
The format is based on Keep a Changelog, and this changelog is maintained to provide a clear history of updates, features, and breaking changes for the Business Media plugin for Grafana.
[Unreleased]
- No unreleased changes at this time.
[6.3.0] - 2025-05-05
Added
- Updated console error messages during build (#152).
- Removed dependency on
@volkovlabs/grafana-utils(#154). - Updated dependencies to support Grafana 11.6 (#155).
[6.2.0] - 2024-12-03
Added
- Improved data state handling for timeouts and errors (#145).
- Updated end-to-end (E2E) tests for better coverage (#150).
- Updated dependencies to support Grafana 11.3 (#151).
[6.1.0] - 2024-09-05
Added
- Enhanced media sources state management (#137).
- Introduced WebSocket server for streaming capabilities (#140).
- Updated dependencies to support Grafana 11.2 (#141).
- Added scroll option for images (#142).
[6.0.0] - 2024-07-29
Breaking Changes
- Image links in panel options must now use Data Links.
- PDF fields require updating the media source type to PDF.
Added
- Added poster support for videos (#120).
- Updated current index handling on data series decrease (#121).
- Converted Image URL to Data Links (#122).
- Introduced slideshow functionality for mixed media (#123).
- Refactored Media panel for improved performance (#124).
- Added support for multiple queries in Media Field and Poster Image (#127).
- Updated dependencies to support Grafana 11.1 (#128).
- Documented PDF breaking changes and prepared for 6.0.0 release (#132).
[5.1.0] - 2024-06-23
Added
- Updated video overview documentation (#100).
- Added plugin E2E tests and removed Cypress dependency (#101, #102, #103, #105).
- Added support for loading images and videos from URLs, along with a video toolbar (#111, #116).
- Updated dependencies to support Grafana 11 (#114).
- Updated to use frame utilities from packages (#115).
- Improved E2E workflow using Docker (#117).
[5.0.0] - 2024-03-25
Breaking Changes
- Requires Grafana 10 or Grafana 11.
Added
- Added customization options for alert messages (#96).
- Updated dependencies to support Grafana 10.4.1 (#97).
- Removed deprecated
ArrayVectorin preparation for Grafana 11 (#99).
[4.2.0] - 2024-02-22
Added
- Updated ESLint configuration and performed code refactoring (#92).
- Updated dependencies and GitHub Actions (#94).
- Added infinity play option for media playback (#93).
[4.1.0] - 2023-10-29
Added
- Updated ESLint configuration for better code quality (#84).
- Added Image Scale Algorithm option for better image rendering (#89).
- Updated to Plugin Tools 2.1.1 and Grafana 10.1.5, and used Grafana Access Policy to sign the plugin (#90).
[4.0.0] - 2023-06-26
Breaking Changes
- Requires Grafana 9 or Grafana 10.
Added
- Added pan and pinch zooming options for images (#78).
- Moved pan and pinch buttons to the toolbar for better usability (#79).
- Updated dependencies to support Grafana 10.0.0 (#80).
- Added description label for media items (#82).
- Removed support for Grafana 8.5 (#83).
[3.6.0] - 2023-06-06
Added
- Updated dependencies to support Grafana 9.5.2 (#70).
- Added E2E testing with Cypress (#71).
- Migrated to Plugin Tools 1.5.2 and updated to Node 18 (#72, #73).
- Increased test coverage for better reliability (#72).
- Tested compatibility with Grafana 10 Preview (#74).
- Added toolbar for downloading, zooming, and navigating between images (#75, #76, #77).
[3.5.0] - 2023-03-07
Added
- Updated CI and release workflows for better automation (#64).
- Updated dependencies to support Grafana 9.4.3 (#65).
- Set
NoPaddingto utilize panel space corner-to-corner (#66).
[3.4.0] - 2023-01-08
Added
- Updated dependencies to support Grafana 9.3.2 (#60).
- Added documentation links for better user guidance (#61).
- Updated README and documentation for clarity (#62).
[3.3.0] - 2022-10-30
Added
- Added support for sanitized variables in URL fields (#53).
- Updated CI to Node 16 and synchronized with release workflow (#55).
- Updated dependencies to support Grafana 9.2.2 (#56).
[3.2.0] - 2022-10-05
Added
- Updated dependencies to support Grafana 9.1.4 (#47).
- Added Compatibility Check Workflow for CI (#48).
- Added option to disable PDF toolbar (#50).
- Updated dependencies to support Grafana 9.1.7 (#51).
[3.1.0] - 2022-08-13
Added
- Updated README and provisioning dashboards documentation (#43).
- Added YouTube video in README for user guidance (#44).
- Rebuilt based on Grafana 9.0.7 (#45).
- Updated Grafana Marketplace image (#46).
[3.0.0] - 2022-06-16
Breaking Changes
- Requires Grafana 8.5+ or 9.0+.
Added
- Rebuilt based on Grafana 9.0.0-beta3 (#36).
- Updated PDF loader to start in Docker environments (#38).
- Added support for short videos encoded in Base64 (#39).
- Added support for MP3 and OGG audio playback in Base64 (#40).
- Added options for video/audio controls and autoplay (#41).
- Rebuilt based on Grafana 9.0.0 (#42).
[2.6.0] - 2022-04-26
Added
- Rebuilt using Grafana 8.3.6 (#32).
- Rebuilt using Grafana 8.4.0 with PluginCheck v2 (#33).
- Rebuilt using Grafana 8.4.3 (#34).
- Based on Grafana 8.5.0 (#35).
[2.5.0] - 2022-01-24
Added
[2.4.0] - 2021-12-16
Added
- Upgraded to Grafana 8.2.5 (#22).
- Upgraded to Grafana 8.3.0 (#23).
- Updated to Grafana 8.3.2 (#24).
- Updated component naming for consistency (#25).
- Added support for PDF documents larger than 2MB (#26).
[2.3.1] - 2021-11-09
Added
- Added
display:blockto properly display href links (Grafana Issue #41445) (#21).
[2.3.0] - 2021-11-08
Added
[2.2.0] - 2021-11-02
Added
[2.1.1] - 2021-08-18
Added
- Added radio button to select image size modes (#14).
[2.1.0] - 2021-08-12
Added
- Updated README for better documentation (#10).
- Upgraded to Grafana 8.1.1 (#12).
- Added options and fields to resize images (#13).
[2.0.0] - 2021-06-19
Breaking Changes
- Supports Grafana 8.0+ only. For Grafana 7.x, use version 1.0.1 or 1.1.0.
Added
- Based on Grafana 8.0.2 (#9).
[1.1.0] - 2021-06-19
Added
- Added support for displaying Base64 images with headers (#7).
- Added support for displaying Base64 images from InfluxDB (#6).
- Increased test coverage for better reliability (#4).
[1.0.1] - 2021-06-07
Added
- Added screenshots for Static and Redis data sources (#5).
[1.0.0] - 2021-06-07
Added
- Initial release based on Grafana 7.5.7.
- Supports PNG, JPG, GIF, and PDF formats.
