Grafana Plugin Flowcharting
Flowcharting is a Grafana plugin. Use it to display complexe diagrams using the online graphing library draw.io
Draw.io can create many types of diagrams :
Technical architecture schema (Legacy, Cloud, Azure, AWS, GCP, Kubernetes, Terraform)
Diagrams (network, electric, flows, ...)
Industrial processes
Organic plans
Floorplans
UML plan
Workflows (Jenkins, Ansible Tower, OpenShift, ...)
Draw your artwork, feed it live data and define in flowcharting how the data will interact with the diagram.
Monitor state and performance
Interact with the diagram
Change the displayed objects based on data or state
Add links to objects
Make full use of variables to modify shapes, colours, links, download paths and more.
Support for regular expressions for matching and substitutions
Use cases
Technical schema example
See more example at draw.io
Demo site
https://play.grafana.org/d/Unu5JcjWk/flowcharting-index?orgId=1
Getting started
https://algenty.github.io/flowcharting-repository/STARTED.html
Documentation
https://algenty.github.io/flowcharting-repository/
Project site
https://github.com/algenty/grafana-flowcharting
Sponsors and Funding
Click on the Sponsor button to help finance the project with the link below.
https://paypal.me/grafanaflowcharting
Thanks a lot
Arnaud
Sponsors
Special thanks to
Gold
Silver
Ian Jones, Tobias Dorn, Matti Orrberg
Bronze
Christopher Piggott, Tamer Salem, Gavin Smith, Roman Dodin
Changelog
Known issues
Shared cross on grafana 8.x (minor)
Flow animation on arrows (minor)
External image from diagrams.net not displayed (minor)
Added
Convert sync method to async : render graph before update states (speed x2)
clean dirty code
Support last version of grafana (8.5.x)
New initialization engine for drawio libs
New draw.io libs (17.x 2022-04-23)
New notifier handler in panel.
Change default url draw.io with https://embed.diagrams.net
New edit design for grafana v7-8 (See example )
New UX design and new concept "fast edit" :
Can edit without expand rules and flowcharts with icons
Advanced/detail mode on expand.
Fast edit mode
Add shape name and properties in inspect console (See example )
Add gaugePos property in Event Mapping for the gauge draw.io models See example )
Plugin is signed
Add Light theme support
New thresholds type : dates (accept units like d, w, m, y, h, s or a date)
New event mapping operators
Enable/Disable rule/state/mapping independently.
Colors (threshold and background) can be empty.
Fixed
Fixed : Inspect mode (issue #209) (See example )
Fixed : Label position in shape (issue #147)
Fixed : Initialization of first model
Fixed : Display refresh between "edit mode" and "dashboard mode" in grafana v7 (issue #205)
Fixed : zoom on text without witdth and height
Fixed : Disable select text when double click for zoom
Fixed : retro compatibility with grafana 6.x (issue #218)
Fixed : Zoom with 2 or more FlowCharting (issue #214)
Fixed : Background color edition in flowchart tab
See Changelog file for history
Annex
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog ,
and this project adheres to Semantic Versioning .
Roadmap
Upgrading Flowcharting to react components => 2022-08-31
Supporting Multi-graph in one panel => 2022-10-31
1.0 Next/Requested enhancements
Internat draw.io website (issue #43)
Display tooltip (0.4.0)
Export SVG, png, options
Google font
Add data in tooltip (0.4.0)
Use variables/templates in graph (0.4.0)
Add custom stencils/libs from draw.io (0.4.0)
Progressive change color like gauge
Support light theme
Annotation
Tooltips on text and arrow/line
Url source download (0.4.0)
Special rule according level (hide, show, change form, move, infront, in back, attributes, ...)
Custom variables like ${_label},${_value}, ${_alias}, ${_rule}, ${_level} ... (0.8.0)
Variable support in link (0.5.0)
Zoom/Unzoom (0.4.0)
Shared graph crosshair
CSV source (0.9.0)
Map/search shape by value (0.8.0)
Variables support for downloaded source and compressed source
Multi graph with auto link when errors
Gradient Mode for color (0.7.0)
More than 3 colors (0.7.0)
Graph in tooltip (0.6.0)
Histogram
carriage return after new rule in tooltips option
Filter for null values in graph
New style for image : imageBackground, imageBorder
Support cloud images from draw.io
Support images from draw.io (0.5.0)
Add append mode on text with CR or space (0.5.0)
Support or Contact
Dependencies
Grafane flowcharting plugin dependencies
[AngularJS] - HTML enhanced for web apps!
[lodash] - awesome web-based text editor
[jquery] - Markdown parser done right. Fast and easy to extend.
[mxGraph] - great UI boilerplate for modern web apps
[pako] - Zlib port to javascript (used by diagrams.net)
[vkbeautify] - Pretty prints and minifies XML/JSON/SQL/CSV
[sanitizer] - Caja's HTML Sanitizer
[chartist] - Graph for tooltip
[chroma-js] - Calculate interpolate colors
Build dependencies
[jest] - Delightful JavaScript Testing
[babel] - Soft cushion between you all the cool new file formats being developed for node.js such as CoffeeScript, SASS, and Jade.
[gulp] - The JavaScript Task Runner
[webpack] - Packs CommonJs/AMD modules for the browser. Allows to split your codebase into multiple bundles, which can be loaded on demand. Support loaders to preprocess files, i.e. json, jsx, es7, css, less, ... and your custom stuff.
Installation
Flowcharting requires Grafana v5+ to run (not tested older versions)
Download and install it
Manualy (deprecated)
$ cd $ grafana_home /data/plugin
$ wget --no-check-certificate https://github.com/algenty/grafana-flowcharting/archive/master.zip
$ unzip master.zip
grafana-cli
grafana-cli plugins install agenty-flowcharting-panel
Build
$ git clone https://github.com/algenty/grafana-flowcharting
$ yarn build
$ # Make zip file plugin in archives dir
$ yarn archive
$ # for dev watching
$ yarn dev
Class diagram
https://www.draw.io/?chrome=0&lightbox=1&url=https%3A%2F%2Fraw.githubusercontent.com%2Falgenty%2Fflowcharting-repository%2Fmaster%2Fgraphs%2FFlowcharting_carto.drawio
Event diagram (In progress)
https://www.draw.io/?chrome=0&lightbox=1&url=https%3A%2F%2Fraw.githubusercontent.com%2Falgenty%2Fflowcharting-repository%2Fmaster%2Fgraphs%2FFlowcharting_Events.drawio