How to show Grafana dashboards in Pisignage players

Steps to Create a Service Account and Generate Token for Pi Signage Integration with Grafana

1) Create Service Account

1. Go to Grafana.
2. Navigate to Administration > Users and Access > Service Accounts.
3. Click on “Add service Account”.
4. Provide a name, e.g., “pisignage”.
5. Assign the Role as “Viewer” from the dropdown (you can change this based on requirements).
6. Click Apply
7. Click Create.

2) Generate Token

1. After creating the service account, click on it to open its details.
2. Click on “Add Service Account Token”.
3. Provide a name for the token (e.g., PiSignage-Token).
4. Click “Generate Token”.
5. Copy the token generated (this is critical for Pi Signage integration).
• Ensure the token never expires (or set an appropriate expiry based on your security policy).
• Example token:
  glsa_P7TUMwo7rTXnbGjYh1P1y4xxxxx_bae5ff42

3) Assign Dashboard Permissions

1. Go to Dashboards and select the dashboard you want to share.
2. Click on “Edit” 
3. Navigate to Settings > Permissions.
4. Add View Permission to the Service Account (pisignage) for this dashboard.
5. Save the dashboard and Exit Edit mode.

4) Enable Kiosk Mode

1. Click on the “Enable Kiosk Mode” button (located at the top-right corner of the dashboard).
2. Copy the URL displayed in the browser’s address bar while in Kiosk mode.

5) Configure Pi Signage

1. Log in to Pi Signage.
2. Go to Assets.
3. Click on Add Link.
4. Choose the type as WebPage.
5. Update the Link Address field with the URL copied earlier from Grafana (Kiosk mode).
6. For Optional Headers, add the token generated earlier in the following format:
   
   Authorization: Bearer <Token>
   
   Example:
   Authorization: Bearer glsa_3Vr2BR6UUDBxxxxxx_06a66dc8
   

6) Save and Verify

1. Save the configuration in Pi Signage and deploy.
2. Verify that the Grafana dashboard is displayed correctly on the Pi Signage screen.
3. Consideration: Grafana is a resource-intensive web page. It is recommended that while scheduling, the page be kept open for 60 seconds or more.