Sidewinder Grafana Datasource
Grafana Datasource for Sidewinder Time Series Database
Sidewinder is an open source fast time series database designed for real-time analytics. It can be used for a variety of usage cases that need storage of metrics data like APM and IoT. You can learn more about Sidewinder at http://sidewinder.srotya.com or https://github.com/srotya/sidewinder
How to build?
To build this plugin:
git clone https://github.com/srotya/sidewinder-grafana.git
npm -g install yarn; yarn install; npm run build
cp -r ./dist /var/lib/grafana/plugins/sidewinderon Linux
How to use?
Make sure you have deployed Sidewinder and have the REST URL available. By default Sidewinder runs on
To create a new Sidewinder Grafana datasource:
- open Grafana
- Click Grafana Icon->Data Sources
- Click Add data source
- Give the data source a name
- Select Type to Sidewinder
- Provide the Url to http://sidewinder-host:sidewinder-port/database-name
- Leave Access to proxy
- [Optional] Configure Basic Auth if authentication is enabled on Sidewinder
- Click Add
Note: If you don't have a database created, you can use the _internal database used to store DB's performance metrics
Here's how an example data source should look like:
Create a Query Visually
Sidewinder support visual query building using an editor. There is support for auto-complete for all non-numeric fields (Measurement, Value Field, Tags). Please refer to Sidewinder data model to understand the significance of different concepts.
Note: As of plugin version 0.2.0, Tag Key Value support is added to the Grafana plugin. Sidewinder version 0.0.38+ is needed for Key Value support
Here's how an example Visual Query should look like:
Create a Query using TSQL
You can also use the Time Series Query Language to create panels. Please note that because Grafana provides the time ranges, you can't provide start and end time in the TSQL string. Please refer to the docs for more details on TSQL.
Here's how an example TSQL Query should look like:
Because Sidewinder supports TSQL, grafana templated dashboards can be created. You can create auto-complete suggestions for variables:
- For FIELD name suggestion simply type
measurementnamein the "metric name or tag query field"
- For TAG suggestion simply type
measurementname.*in the "metric name or tag query field"
Here's how an example Templated Dashboard should look like:
Installing Sidewinder on Grafana Cloud:
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
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 Data Source
Use the grafana-cli tool to install Sidewinder 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. Configure the Data Source
Accessed from the Grafana main menu, newly installed data sources can be added immediately within the Data Sources section.
Next, click the Add data source button in the upper right. The data source will be available for selection in the Type select box.
To see a list of installed data sources, click the Plugins item in the main menu. Both core data sources and installed data sources will appear.
Introducing the new Open Distro for Elasticsearch plugin for Grafana, also available in Amazon Managed Service for Grafana
Blog post 3 min
Want to visualize software development insights with Grafana? With our new Jira Enterprise plugin, you can!
Blog post 5 min
A closer look at the admin API and plugin for centralized tenant adminstration and control in Grafana Enterprise Logs
Blog post 4 min
The new Splunk Infrastructure Monitoring plugin brings the SaaS formerly known as SignalFx to your Grafana dashboards
Blog post 5 min
The Splunk plugin for Grafana now supports data links for jumping directly from logs to traces
Blog post 5 min
With the new AWS IoT SiteWise plugin, you can visualize and monitor your equipment data in Grafana dashboards
Blog post 2 min
The new Wavefront Enterprise plugin brings the high-scale, high-speed SaaS to your Grafana dashboards
Blog post 5 min