GreptimeDB DataSource for Grafana

This is a Grafana data source plugin built for GreptimeDB. This plugin is built on top of original Grafana Prometheus data source and enhanced for GreptimeDB's additional features.

Screenshots

PromQL query builder with additional field selector.

Time-series data rendered with GreptimeDB data source.

Installation

Grab the latest release from release page, Unzip the file to your grafana plugin directory.

You can also use grafana cli to download and install

grafana cli --pluginUrl https://github.com/GreptimeTeam/greptimedb-grafana-datasource/releases/latest/download/info8fcc-greptimedb-datasource.zip plugins install info8fcc

Note that you may need to restart your grafana server after installing the plugin.

Docker image

We also build Grafana docker image that ships GreptimeDB data source by default. To get the docker image, run

docker pull greptime/grafana-greptimedb:latest
docker run -p 3000:3000 greptime/grafana-greptimedb:latest

Docs

See our setup guide from our docs.

Features and Roadmap

We started this plugin from forking Grafana's built-in Prometheus plugin. The goal of this plugin is to provide visualization support for all native types of GreptimeDB data.

• Time series panels
  • PromQL
    • GreptimeDB's additional field selector
  • SQL
    • Time macro
• Event UI
  • Event
• Settings UI
  • DB name input
  • Authentication

Development

Yarn 1.x is required for this project. Execute these commands in code root folder

1. Install dependencies

   yarn install

2. Build plugin in development mode and run in watch mode

   yarn run dev

3. Build backend plugin binaries for Linux, Windows and Darwin:

   mage -v build:linux

4. Start Docker Service

   docker compose up

Community

Join our community slack channel #grafana for discussion of this plugin.

License

GreptimeDB uses the Apache License 2.0 to strike a balance between open contributions and allowing you to use the software however you want.