Skip to main content

Grafana Dashboard Setup Guide

This guide will help you configure the provided Grafana dashboard JSON files to work with your Prometheus datasource.

Prerequisites​

  • Grafana instance with Prometheus datasource configured
  • Access to your Prometheus instance
  • DynamoAI version 3.24 or later (metrics are only available from version 3.24)
  • The dashboard JSON files provided

Step 1: Find Your Prometheus Datasource UID​

  1. Log into your Grafana instance
  2. Copy UID of the datasource (it's usually a short alphanumeric string like abc123xyz) - you'll need it in the next step

Step 2: Replace the Datasource UID in Dashboard JSON Files​

The dashboard JSON files contain a placeholder datasource UID (DATASOURCE_UID_PLACEHOLDER) that needs to be replaced with your Prometheus datasource UID.

Step 3: Import the Dashboard​

  1. In Grafana, navigate to Dashboards → Import
  2. Click Upload JSON file or paste the JSON content
  3. Select the modified dashboard JSON file
  4. In the import screen:
    • Name: Keep the default or customize
    • Folder: Choose where to save the dashboard
    • Unique identifier (uid): You can keep the default or change it
  5. Click Import

Step 4: Verify the Dashboard​

After importing:

  1. Check that all panels are loading data
  2. If you see "No data" errors:
    • Verify your Prometheus datasource is working (test in Explore)
    • Check that the metric names match
    • Verify label selectors match your Prometheus labels
  3. Test the dashboard variables (if any) to ensure they work correctly

Troubleshooting​

"Datasource not found" errors​

  • Verify you replaced all occurrences of DATASOURCE_UID_PLACEHOLDER
  • Check that your Prometheus datasource UID is correct
  • Ensure the datasource is accessible in Grafana

"No data" in panels​

  • Verify the metric names exist in your Prometheus instance
  • Check that label selectors match your data
  • Test queries directly in Grafana Explore to see what data is available
  • Ensure you're running DynamoAI version 3.24 or later

Quick Reference: What to Replace​

ItemFindReplace With
Datasource UIDDATASOURCE_UID_PLACEHOLDERYour actual Prometheus datasource UID

Summary​

  1. Download the dashboard JSON files from the Visualization Overview page
  2. Find your Prometheus datasource UID in Grafana (Configuration → Data Sources)
  3. Replace all occurrences of DATASOURCE_UID_PLACEHOLDER with your actual UID
  4. Import the modified JSON file into Grafana
  5. Verify that panels are displaying data correctly

Note: These dashboards require DynamoAI version 3.24 or later to display metrics.

Last updated on