Plugins 〉SCADAvis Synoptic Panel
SCADAvis Synoptic Panel
Powerful SCADA-like synoptic graphics panel for Grafana
This panel plugin allows unleashing the power of SCADA-like graphics in Grafana.
The SCADAvis.io online service provides an incredibly powerful SVG Editor that can be used to create free-form graphics animated with Grafana data.
Learn how to obtain and use the SCADAvis.io editor here.
In the SVG file, graphical objects should be marked with tags that match metrics or aliases names from Grafana data queries.
Step-by-step example:
- Create a new SVG file using the SCADAvis.io Synoptic Editor.
- Put a text object the top left position.
- Change the text to %f (use printf convention to format numbers).
- Select the text object and click the right mouse button, choose "Object Properties".
- Go to the "Get" tab and type in the "Tag" field some tag name such as "TAG1".
- Save the SVG file (do not change the default format).
- Upload the file to some server to make it available online (you can use a Github raw url such as "https://raw.githubusercontent.com/riclolsen/displayfiles/master/helloworld.svg").
- Edit the Grafana panel with the SCADAvis.io plugin.
- In the "Options" tab, field "SVG File URL", enter the URL for your SVG file.
- To embed the SVG file in the panel, first convert the SVG contents to Base64 encoding (there are online encoders) and paste the results in the SVG File URL field.
- In the "Metrics" choose a Data Source and use the tag name that is inside the SVG file (e.g. "TAG1") as the metric name. Example query: "SELECT <value column> as value, "TAG1" as metric FROM ...".
- Save the panel and it will display the value obtained from the query in the panel as a float value.
- There are many animations possible such as filll/stroke color, position, opacity, etc. (see "Learn" section on https://scadavis.io site).
This plugin requires Internet connectivity to work properly!
Installation
Use the new grafana-cli tool to install scadavis-synoptic-panel from the commandline:
grafana-cli plugins install scadavis-synoptic-panel
The plugin will be installed into your grafana plugins directory; the default is /var/lib/grafana/plugins if you installed the grafana package.
More instructions on the cli tool can be found here.
You need the lastest grafana build for Grafana 3.0 to enable plugin support. You can get it here : http://grafana.org/download/builds.html
Alternative installation method
It is also possible to clone this repo directly into your plugins directory.
Afterwards restart grafana-server and the plugin should be automatically detected and used.
git clone https://github.com/riclolsen/scadavis-synoptic-panel.git
sudo service grafana-server restart
Clone into a directory of your choice
If the plugin is cloned to a directory that is not the default plugins directory then you need to edit your grafana.ini config file (Default location is at /etc/grafana/grafana.ini) and add this:
[plugin.scadavissynoptic]
path = /home/your/clone/dir/scadavis-synoptic-panel
Note that if you clone it into the grafana plugins directory you do not need to add the above config option. That is only if you want to place the plugin in a directory outside the standard plugins directory. Be aware that grafana-server needs read access to the directory.
Changelog
1.0.4
- Added "Load SVG from local file" config option.
- Better auto resize handling.
- Compatible also with Grafana 6.7.
1.0.3
- Added "Auto Resize" config option.
- Supported Grafana Templating Variables.
- More efficient data update and display rendering.
- Generic tagging (@1, @2, @3, ...) compatible to the Power BI plugin.
- Better responsiveness to configuration changes.
1.0.2
- Better README.md.
1.0.1
- Revised version. Watermark removed.
1.0.0
- Initial version.
Grafana Cloud Pro
- $25 / user / month and includes a free trial for new users
- Available with a Grafana Cloud Pro plan
- Access to 1 Enterprise plugin
- Fully managed service (not available to self-manage)
Grafana Cloud Advanced / Grafana Enterprise
- Available with a Grafana Cloud Advanced plan or Grafana Enterprise license
- Access to all Enterprise plugins
- Run fully managed or self-manage on your own infrastructure
Installing SCADAvis Synoptic Panel 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.
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 SCADAvis Synoptic Panel 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.