diff --git a/README.md b/README.md index d27030c..25ee8f9 100644 --- a/README.md +++ b/README.md @@ -1,44 +1,56 @@ -# Grafana Panel Plugin Template - -[![Build](https://github.com/grafana/grafana-starter-panel/workflows/CI/badge.svg)](https://github.com/grafana/grafana-starter-panel/actions?query=workflow%3A%22CI%22) - -This template is a starting point for building Grafana Panel Plugins in Grafana 7.0+ - -## What is Grafana Panel Plugin? - -Panels are the building blocks of Grafana. They allow you to visualize data in different ways. While Grafana has several types of panels already built-in, you can also build your own panel, to add support for other visualizations. - -For more information about panels, refer to the documentation on [Panels](https://grafana.com/docs/grafana/latest/features/panels/panels/) - -## Getting started - -1. Install dependencies - - ```bash - yarn install - ``` - -2. Build plugin in development mode or run in watch mode - - ```bash - yarn dev - ``` - - or - - ```bash - yarn watch - ``` - -3. Build plugin in production mode - - ```bash - yarn build - ``` - -## Learn more - -- [Build a panel plugin tutorial](https://grafana.com/tutorials/build-a-panel-plugin) -- [Grafana documentation](https://grafana.com/docs/) -- [Grafana Tutorials](https://grafana.com/tutorials/) - Grafana Tutorials are step-by-step guides that help you make the most of Grafana -- [Grafana UI Library](https://developers.grafana.com/ui) - UI components to help you build interfaces using Grafana Design System +# Grafana Chartwerk Panel (beta) + +

+ +[![Build Status](https://travis-ci.org/chartwerk/grafana-chartwerk-app.svg?branch=master)](https://travis-ci.org/chartwerk/grafana-chartwerk-app) + + **Grafana Chartwerk Panel** renders metrics using ChartWerk libraries. For now, it can render as a line and a series of bars. We are working on adding new visualizations. + +![image](https://user-images.githubusercontent.com/66464000/84491085-10416280-acb5-11ea-8af0-2761ed97aecc.png) +![image](https://user-images.githubusercontent.com/66464000/84491069-0b7cae80-acb5-11ea-959b-ef67835c8055.png) + +## Features + +- 2 types of visualizations: + - line-chart + - bar-chart +- ability to make panel's time range independent of dashboard's (doesn't work in Grafana 7). +- ability to display template variables inside the panel. +- "Charge" mode: green color for positive graph's slope, red color for negative graph's slope. +- confidence interval (for line). +- customizable X-axis labels. +- customizable grid interval. + +## Installation +### Linux / Mac OS X +- Navigate to either: + - `/data/plugins` (when installed from tarball or source) + - or `/var/lib/grafana/plugins` (when installed from `.deb`/`.rpm` package) + +- Download ChartWerk panel +``` +wget https://github.com/chartwerk/grafana-chartwerk-app/archive/0.3.3.zip +``` + +- Unpack downloaded files +``` +unzip 0.3.3.zip +``` + +- Restart grafana-server + - For grafana installed via Standalone Linux Binaries: + - Stop any running instances of grafana-server + - Start grafana-server by: + ```$GRAFANA_PATH/bin/grafana-server``` + - For grafana installed via Package Manager: + - type in ```systemctl restart grafana-server``` + +### Grafana in Docker +You can install ChartWerk panel to Grafana in Docker passing it as environment variable (as described in [Grafana docs](http://docs.grafana.org/installation/docker/#installing-plugins-from-other-sources)) + +```bash +docker run \ + -p 3000:3000 \ + -e "GF_INSTALL_PLUGINS=https://github.com/chartwerk/grafana-chartwerk-app/archive/0.3.3.zip;corpglory-chartwerk-panel" \ + grafana/grafana +```