Plugins 〉Business Media


Developer

Volkov Labs


Sign up to receive occasional product news and updates:



Panel
community

Business Media

  • Overview
  • Installation
  • Change log
  • Related content

Business Media for Grafana

Media

Grafana CI E2E codecov CodeQL

Introduction

The Business Media panel is a Grafana plugin that renders PNG, JPG, GIF, MP4, WEBM, MP3, OGG, and PDF files encoded in the base64 format and URL.

Display images and PDF on Grafana using Business Media panel

Requirements

The Business Media panel version requirements for Grafana are as follows:

  • Business Media panel 6.X requires Grafana 10 or Grafana 11.
  • Business Media panel 5.X requires Grafana 10 or Grafana 11.
  • Base64 Image/PDF panel 4.X requires Grafana 9 or Grafana 10.
  • Base64 Image/PDF panel 3.X requires Grafana 8.5 or Grafana 9.
  • Base64 Image/PDF panel 2.X requires Grafana 8.
  • Base64 Image/PDF panel 1.X requires Grafana 7.1.

Getting Started

You can install the Business Media Panel from the Grafana Plugins catalog or use the Grafana command line tool.

For the latter, please use the following command.

grafana cli plugins install volkovlabs-image-panel

Install Business Suite plugins in Cloud, OSS, Enterprise | Open source community plugins

Highlights

  • The media file can be specified in the base64 format or as a URL link.
  • Multiple media files display with pagination functionality.
  • The returned value can include base64 encoded content with or without a specified definition. The formats for the definition can look like data:image/jpg;base64,ENCODED-CONTENT or data:application/pdf;base64,ENCODED-CONTENT.
  • If the data source returns more than one field of the string type, you can select the Field Name in the panel's display options.
  • You can fit image dimensions to the panel size, keep the original values, or adjust dimensions based on the manually supplied values.
  • Allows adding a URL with a title to navigate to other dashboards when clicking the image. URL supports dashboard variables.
  • Provides a toolbar to download, zoom, and navigate between media files.

Documentation

SectionDescription
Supported formatsExplains what formats are supported and how to display media files.
OptionsDescribes all plugin options
FeaturesDemonstrates panel capabilities.
TutorialsEasy to follow tutorials
Release NotesStay up to date with the latest features and updates.

Business Suite for Grafana

The Business Suite is a collection of open source plugins created and actively maintained by Volkov Labs.

The collection aims to solve the most frequent business tasks by providing an intuitive interface with detailed written documentation, examples, and video tutorials.

Business Suite for Grafana

Enterprise Support

With the Business Suite Enterprise, you're not just getting a product, you're getting a complete support system. You'll have a designated support team ready to tackle any issues.

You can contact us via Zendesk, receive priority in feature requests and bug fixes, meet with us for in-person consultation, and get access to the Business Intelligence. It's a package that's designed to make your life easier.

Always happy to hear from you

License

Apache License Version 2.0, see LICENSE.

Installing Business Media on Grafana Cloud:

For more information, visit the docs on plugin installation.

Changelog

6.2.0 (2024-12-03)

Features / Enhancements

  • Updated Data state for timeout and errors (#145)
  • Updated E2E tests (#150)
  • Updated Grafana 11.3 dependencies (#151)

6.1.0 (2024-09-05)

Features / Enhancements

  • Updated media sources state (#137)
  • Added Websocket server for streaming (#140)
  • Updated Grafana 11.2 dependencies (#141)
  • Added Scroll option for images (#142)

6.0.0 (2024-07-29)

Breaking changes

  • Image links in panel options should be updated to use Data links.
  • PDF fields require to update the type of the media source to PDF.

Features / Enhancements

  • Added poster for video (#120)
  • Updated current index on data series decrease (#121)
  • Updated Image URL to data links (#122)
  • Added slideshow between mixed media (#123)
  • Refactored Media panel (#124)
  • Added multiple queries support in Media Field and Poster Image (#127)
  • Updated to Grafana 11.1 and dependencies (#128)
  • Added PDF Breaking change and prepare 6.0.0 (#132)

5.1.0 (2024-06-23)

Features / Enhancements

  • Updated video overview (#100)
  • Added plugin e2e tests and remove cypress (#101, #102, #103, #105)
  • Added ability to load image, videos from URL and video toolbar (#111, #116)
  • Updated to Grafana 11 and dependencies (#114)
  • Updated to use frame utils from packages (#115)
  • Updated E2E workflow using Docker (#117)

5.0.0 (2024-03-25)

Breaking changes

  • Requires Grafana 10 and Grafana 11

Features / Enhancements

  • Added the ability to customize the alert message (#96)
  • Updated to Grafana 10.4.1 (#97)
  • Remove ArrayVector deprecated in Grafana 11 (#99)

4.2.0 (2024-02-22)

Features / Enhancements

  • Update ESLint configuration and refactoring (#92)
  • Update dependencies and Actions (#94)
  • Add infinity play option (#93)

4.1.0 (2023-10-29)

Features / Enhancements

  • Update ESLint configuration (#84)
  • Add Image Scale Algorithm option (#89)
  • Update to Plugin Tools 2.1.1 (#90)
  • Use Grafana Access Policy to sign plugin (#90)
  • Update to Grafana 10.1.5 (#90)

4.0.0 (2023-06-26)

Breaking changes

  • Requires Grafana 9 and Grafana 10

Features / Enhancements

  • Add pan and pinch zooming option (#78)
  • Move pan pinch buttons to the toolbar (#79)
  • Update to Grafana 10.0.0 (#80)
  • Add description label (#82)
  • Remove Grafana 8.5 support (#83)

3.6.0 (2023-06-06)

Features / Enhancements

  • Update to Grafana 9.5.2 (#70)
  • Add E2E Cypress testing (#71)
  • Migrate to Plugin Tools 1.5.2 (#72, #73)
  • Update to Node 18 (#72)
  • Increase Test Coverage (#72)
  • Tested with Grafana 10 Preview (#74)
  • Add Toolbar to Download, Zoom and Navigation between images (#75, #76, #77)

3.5.0 (2023-03-07)

Features / Enhancements

  • Update CI and Release workflows (#64)
  • Update to Grafana 9.4.3 (#65)
  • Set NoPadding to use panel corner to corner (#66)

3.4.0 (2023-01-08) "New Year" edition

Features / Enhancements

  • Update to Grafana 9.3.2 (#60)
  • Add Documentation links (#61)
  • Update README and documentation (#62)

3.3.0 (2022-10-30) "Halloween" edition

Features / Enhancements

  • Support for sanitized variables in URL field (#53)
  • Update CI to Node 16 and Synchronize with Release workflow (#55)
  • Update to Grafana 9.2.2 (#56)

3.2.0 (2022-10-05)

Features / Enhancements

  • Update to Grafana 9.1.4 (#47)
  • Add Compatibility Check Workflow (#48)
  • Add option to disable PDF Toolbar (#50)
  • Update to Grafana 9.1.7 (#51)

3.1.0 (2022-08-13)

Features / Enhancements

  • Update README and Provisioning dashboards (#43)
  • Add YouTube video in README (#44)
  • Rebuild based on 9.0.7 (#45)
  • Update Grafana Marketplace image (#46)

3.0.0 (2022-06-16)

Breaking changes

  • Requires Grafana 8.5+ and 9.0+

Features / Enhancements

  • Rebuild based on 9.0.0-beta3 (#36)
  • Update PDF loader to start in Docker (#38)
  • Support short Video encoded using Base64 (#39)
  • Support MP3, OGG Audio playback in Base64 (#40)
  • Add Options for Video/Audio Controls and Auto Play (#41)
  • Rebuild based on 9.0.0 (#42)

2.6.0 (2022-04-26)

Features / Enhancements

  • Rebuild using 8.3.6 (#32)
  • Rebuild using 8.4.0 and use PluginCheck v2 (#33)
  • Rebuild using 8.4.3 (#34)
  • Based on Grafana 8.5.0 (#35)

2.5.0 (2022-01-24)

Features / Enhancements

  • Update README to add Grafana Marketplace (#29)
  • Rebuild using 8.3.4 (#28)

2.4.0 (2021-12-16)

Features / Enhancements

  • Upgrade to Grafana 8.2.5 (#22)
  • Upgrade to Grafana 8.3.0 (#23)
  • Update to Grafana 8.3.2 (#24)
  • Update Components naming (#25)
  • Supporting PDF documents more than 2Mb size (#26)

2.3.1 (2021-11-09)

Features / Enhancements

  • Add display:block to display href properly [https://github.com/grafana/grafana/issues/41445] (#21)

2.3.0 (2021-11-08)

Features / Enhancements

  • Navigate to another dashboard from image click (#19)
  • Upgrade to Grafana 8.2.3 (#20)

2.2.0 (2021-11-02)

Features / Enhancements

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

2.1.1 (2021-08-18)

Features / Enhancements

  • Add Radio to select Image Size modes (#14)

2.1.0 (2021-08-12)

Features / Enhancements

  • Update README (#10)
  • Upgrade to Grafana 8.1.1 (#12)
  • Add Options and Fields to resize an image (#13)

2.0.0 (2021-06-19)

Breaking changes

  • Supports Grafana 8.0+, for Grafana 7.X use version 1.0.1 or 1.1.0

Features / Enhancements

  • Based on Grafana 8.0.2 (#9)

1.1.0 (2021-06-19)

Features / Enhancements

  • Display base64 image with header (#7)
  • Display base64 Image from InfluxDB (#6)
  • Increase tests coverage (#4)

1.0.1 (2021-06-07)

Features / Enhancements

  • Add screenshots for Static and Redis data sources (#5)

1.0.0 (2021-06-07)

Features / Enhancements

  • Initial release based on Grafana 7.5.7
  • Supports PNG, JPG, GIF and PDF