Plugins 〉Business Media


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 Media

  • Overview
  • Installation
  • Change log
  • Related content

Business Media for Grafana

Media

Grafana CI E2E Codecov CodeQL

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.

Display Images and PDFs in Grafana with Business Media

🚀 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 VersionCompatible Grafana Versions
Business Media 6.XGrafana 10, Grafana 11
Business Media 5.XGrafana 10, Grafana 11
Base64 Image/PDF 4.XGrafana 9, Grafana 10
Base64 Image/PDF 3.XGrafana 8.5, Grafana 9
Base64 Image/PDF 2.XGrafana 8
Base64 Image/PDF 1.XGrafana 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

Install Business Suite Plugins in Cloud, OSS, and Enterprise

📚 Documentation

Explore detailed guides and resources to make the most of the Business Media panel:

SectionDescription
Supported FormatsLearn about supported media formats and how to display them.
OptionsUnderstand all available configuration options.
FeaturesDiscover the full range of panel capabilities.
TutorialsFollow step-by-step guides for common use cases.
Release NotesStay 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.

Business Suite for Grafana

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:

📜 License

This project is licensed under the Apache License Version 2.0. See the LICENSE file for details.

Installing Business Media 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 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.

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 ArrayVector in 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 NoPadding to 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

  • Updated README to include Grafana Marketplace information (#29).
  • Rebuilt using Grafana 8.3.4 (#28).

[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

[2.3.0] - 2021-11-08

Added

  • Added navigation to other dashboards from image clicks (#19).
  • Upgraded to Grafana 8.2.3 (#20).

[2.2.0] - 2021-11-02

Added

  • Upgraded to Grafana 8.1.5 (#16).
  • Upgraded to Grafana 8.2.0 (#17).
  • Upgraded to Grafana 8.2.2 (#18).

[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.