Connect GraphMe to Grafana

This page explains how to configure GraphMe to interact with your instance of Grafana.

Open the console

After installing the application for Slack, you are redirected to the console where you can configure the connection to Grafana. You can also obtain the URL to this console by using the following command from Slack:

/graph connect

Which would give the following response:

Configure connection

Configure the connection

The console to configure the connection to Grafana looks like the following:

Configure connection

There are three fields to fill in order to configure the connection to Grafana:

FieldRequired Description
HostYesBase URL of the Grafana host to connect to.
API keyNoAn API key or service account token. Only dashboards accessible by this key will be available via GraphMe. While this parameter can be omitted when connecting to a public instance, it is in practice always specified when connecting to your own private instance of Grafana
Org IDNoAn organization identifier. Only dashboards accessible to this organization will be available via GraphMe. This is only needed if your instance of Grafana uses multiple organizations. By default, the organization identifier of the first organization is assumed.

For security reasons, the API key is never displayed in the form, even if one is actually used. Consequently, when editing a connection that requires an API key, you must provide the API key every time.

Demo instance

By default, every new team is configured with a demo instance of Grafana: This allows new users to get started quickly. This demo instance is not maintained by GraphMe, and might be subject to some limitations (such as rate limiting).

Grafana Renderer API

GraphMe relies heavily the image renderer plugin to actually render graphs. This plugin must be installed in your Grafana instance in order for GraphMe to deliver graphs successfully.

Network connectivity

Your instance of Grafana should be publicly addressable in order for GraphMe to communicate with it. This is often the case when you use an instance of Grafana managed as a service, such as Grafana Cloud.