# spotify-heroic-datasource

**Repository Path**: mirrors_spotify/spotify-heroic-datasource

## Basic Information

- **Project Name**: spotify-heroic-datasource
- **Description**: Heroic datasource for Grafana
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-18
- **Last Updated**: 2025-10-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# spotify-heroic-datasource

[![Build Status](https://github.com/spotify/spotify-heroic-datasource/workflows/Build/badge.svg)](https://github.com/spotify/spotify-heroic-datasource/actions?query=workflow%3ABuild)

![heroic-datasource-screenshot](https://github.com/spotify/spotify-heroic-datasource/raw/master/heroic-datasource-screenshot.png "Heroic Datasource Plugin")

The Spotify Heroic datasource is the "official" plugin for [Heroic](https://github.com/spotify/heroic)!

It includes:
* Query builder with suggestions for metrics.
* Table support.
* Annotation support.

**Compatible with Grafana versions 6.0 -> 6.5.2**

This plugin is supersedes the previous [Heroic datasource](https://github.com/udoprog/udoprog-heroic-datasource).

Inspiration was taken from the [Grafana InfluxDB plugin](https://github.com/grafana/grafana/tree/master/public/app/plugins/datasource/influxdb).


# Installation

The recommened way to install the plugin is via the official cli:

`grafana-cli plugins install spotify-heroic-datasource`


The plugin can also be installed by directly pointing at a release. Useful if you want to test a feature that hasn't been released yet.

`grafana-cli --pluginUrl https://github.com/spotify/spotify-heroic-datasource/archive/master.zip plugins install spotify-heroic-datasource`


# Local Development

To develop locally:
- `yarn install`
- `yarn watch`

Add the following to your `grafana.ini` to deploy to your local Grafana instance:
```
[plugin.spotify-heroic-datasource]
path = /{path-to-spotify-heroic-datasource}
```

If using Docker, you can mount this repo into the Grafana plugin directory:

```
docker run -it -p 3000:3000 --name=grafana -v `pwd`/dist:/var/lib/grafana/plugins/spotify-heroic-datasource grafana/grafana
```


# Releasing

Travis will automatically bump the patch version of the plugin, tag the commit and make a GitHub Release.

The commit hash then needs to be appended to [repo.json](https://github.com/grafana/grafana-plugin-repository/blob/master/repo.json) in for it to be installable
via the `grafana-cli`.



# Code of Conduct

This project adheres to the [Open Code of Conduct][code-of-conduct]. By participating, you are expected to honor this code.

[code-of-conduct]: https://github.com/spotify/code-of-conduct/blob/master/code-of-conduct.md