# Grafana Data Exporter App

Grafana plugin for exporting data from Grafana panels as CSV.

Supported datasources:
- MySQL
- PostgreSQL

## Prerequisites
- [Grafana 9.0.0+](https://grafana.com/grafana/download)
- [Grafana Data Exporter](https://code.corpglory.net/corpglory/grafana-data-exporter)
- set Grafana `app_mode` as `development` (it won't be necessary after we sign the plugin):
  - find the configuration file: [https://grafana.com/docs/grafana/latest/setup-grafana/configure-grafana/#configuration-file-location](https://grafana.com/docs/grafana/latest/setup-grafana/configure-grafana/#configuration-file-location)
  - change `app_mode = production` to `app_mode = development`

## Plugin installation

The easiest way to install plugins is by using the `grafana-cli` tool which is bundled with Grafana. See [Using grafana-cli](#using-grafana-cli) paragraph.

If there is no `grafana-cli` tool in your system, plugins can be installed [manually](#manual-installation).

### Table of contents
- [Using grafana-cli](#using-grafana-cli)
  - [Install plugin](#install-update-plugin)
- [Manual installation](#manual-installation)
- [Docker installation](#docker-installation)

### Using grafana-cli

Grafana docs about plugin installation: [https://grafana.com/docs/plugins/installation/#installing-plugins](https://grafana.com/docs/plugins/installation/#installing-plugins).

#### Install / update plugin
```bash
grafana-cli --pluginUrl "https://code.corpglory.net/attachments/89ae5865-2ae7-474c-a6f0-f29d19e6b1dd" plugins install corpglory-dataexporter-app
sudo systemctl restart grafana-server
```

### Manual installation

- Navigate to Grafana plugins directory:
  - For Grafana installed from `.deb`/`.rpm` package:
    - `/var/lib/grafana/plugins`
  - For Grafana installed using Standalone Linux Binaries or source:
    - `<GRAFANA_PATH>/data/plugins`

- Download corpglory-dataexporter-app
```bash
wget http://code.corpglory.net/attachments/5f1c5e28-544b-416a-a425-7cdf49fa60ac -O corpglory-dataexporter-app.tar.gz
```

- Unpack downloaded files
```bash
tar -zxvf corpglory-dataexporter-app.tar.gz
```

- Restart Grafana
  - For Grafana installed from `.deb`/`.rpm` package:
    - `systemctl restart grafana-server`
  - For Grafana installed using Standalone Linux Binaries or source:
    - Stop any running instances of grafana-server
    - Start grafana-server: `cd <GRAFANA_PATH> && ./bin/grafana-server`

### Docker installation

You can install Data Exporter App to Grafana in Docker passing it as the environment variable.

```bash
docker run \
  -p 3000:3000 \
  -e "GF_INSTALL_PLUGINS=https://code.corpglory.net/attachments/89ae5865-2ae7-474c-a6f0-f29d19e6b1dd;corpglory-dataexporter-app" \
  grafana/grafana
```

#### Useful links
- Grafana docs about Docker installation: [https://docs.grafana.org/installation/docker/#installing-plugins-from-other-sources](https://docs.grafana.org/installation/docker/#installing-plugins-from-other-sources)

## Support and Consulting

Commercial support, professional services **or any help** — send us your inquiry at ping@corpglory.com

## About CorpGlory Inc.
Grafana Data Exporter is developed by [CorpGlory Inc.](https://corpglory.com/), a company which provides high quality software development, data visualization, Grafana and monitoring consulting.