Plugins 〉Druid


Developer

Grafadruid

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.


Data Source
community

Druid

  • Overview
  • Installation
  • Related content

Druid as a Data Source for Grafana

Table of Contents

What is this Druid-Grafana plugin?

Grafana doesn't supports Druid as a Data Source, this plugin aims to do so.

Features

At the time of writing, the plugin supports all Grafana features and all Druid queries:

  • Druid queries: SQL, timeseries, topn, groupby, timeboundary, segmentmetadata, datasourcemetadata, scan, search, JSON
  • Variables: Grafana global variables replacement, query variables, formatter druid:json (provide support for multi-value variables within rune queries).
  • Alerts
  • Explore
  • Logs

if you're using a self-signed TLS certificate, an option to "Skip TLS verify" will be shown when "https" is used in datasource URI)

Screenshots

Datasource - Connection

Datasource - connection

Datasource - Default settings

Datasource - default settings

Panels

Panels

Query builder - JSON

Query builder - JSON

Query builder - SQL

Query builder - SQL

Query builder - Timeseries

Query builder - timeseries

Query builder - Settings

Query builder - settings

Variables

Variables

Variables - Formatter - druid:json

Variables - formatter - druid:json

Explore - Logs

Explore - logs

Query builder - Settings - Logs

Query builder - settings - logs

Contribute

Any contribution is welcome! Feel free to join on Slack to discuss :) To go further, see Contribute

Install

  • From Grafana.com: grafana-cli plugins install grafadruid-druid-datasource $VERSION
    • If $VERSION is not specified latest version will be installed
  • From remote archive: grafana-cli --pluginUrl https://github.com/grafadruid/druid-grafana/releases/download/v$VERSION/grafadruid-druid-datasource-$VERSION.zip plugins install grafadruid-druid-datasource
  • From local archive: unzip grafadruid-druid-datasource-$VERSION.zip -d $YOUR_PLUGIN_DIR

Where $VERSION is for instance 1.0.0 and $YOUR_PLUGIN_DIR is for instance /var/lib/grafana/plugins

(Source: https://grafana.com/docs/grafana/latest/plugins/installation/)

Examples

You can try out various advanced features of the plugin by importing the demo dashboard and running it against the Wikipedia dataset used in the Druid quickstart tutorial.

When using the provided docker based environment (./mage env:start && ./mage), the dataset is automatically ingested in Druid, the datasource and dashboard are automatically provisionned in Grafana.

Installing Druid 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 Data Source

Use the grafana-cli tool to install Druid 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. 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.