Set up Grafana integration in Q-Play

Grafana

Introduction

With the Grafana integration in Q-Play, you can easily display your Grafana dashboards directly on your screens. This allows you to present real-time data from your preferred data sources in a visually appealing way. In this guide, we will walk you through how to set up the integration and upload your Grafana reports to Q-Play, so you can quickly get your data in front of your audience.

Notice

Start by creating a service account in Grafana. Follow Grafana's guide to create your service account.

Create service account

Also remember to add a token to the service account

Add the integration

1. Add integration

Open your Q-Play account, go to integrations, and then click "+ Add integration."
Add integration in Q-Play

2. Select Grafana SSO

You can now browse the available integrations. Select "Grafana SSO". 
Select Grafana SSO

3. Name the integration

Give the integration a descriptive name and then click Next. 
Name the integration

4. Select the host type and enter the Base URL

You have two options for the host type:

  1. Self-hosted: Uses your Base URL.
  2. Grafana Cloud: Uses your account's subdomain.

Enter the Base URL using the following format. It must not include https://.

  1. grafana.q-play.io

Then click Next.

Select the host type and enter the Base URL

5. Set up authentication

Click Authentication and select Service account token. Then enter the service account token that you generated in the previous section. 
Then click Create integration. 
Set up authentication

The integration has now been created, and you are ready to add a job to the integration.

Add a job

To add a job, click "+ Add job" in the center of the screen. 

1. New job

Give the new job a descriptive name and enter the URL of the dashboard you want to display on the screen.

The dashboard URL should only contain the path to the dashboard itself.

Here is an example of a URL:

  1. /d/<uid>/<slug>?orgId=1&refresh=10s

Then click "Save integration".

Set up a new job

The new job will now appear as a tab next to Overview. Click the job to view its options, then click "Run job now".

If you have followed the steps above correctly, the job should show "Success" as its status, and a screenshot of the selected dashboard will be displayed under "Resource output".

Run job


Set up the Grafana app

Your integration is now ready to be used with the Grafana app. 
Follow this guide to set up the app.