Perses

Setup

This guide will walk you through setting up Perses to use Dash0 as a Prometheus-compatible data source, allowing you to create custom dashboards with your telemetry data.

Step 1: Adding Dash0 as a Data Source

1. Log in to your Perses instance
2. Navigate to Admin > Global Datasources
3. Click Add Global Datasource
4. In the dialog that appears:
5. Set Name to a descriptive name (e.g., Dash0)
6. Set Source to Prometheus Datasource
7. Under HTTP Settings > Proxy:
8. Set the URL to {{endpoint_api_prometheus}}
9. In the Headers section, add:
   • An Authorization header with the value Bearer {{token}}
   • A Dash0-Dataset header with the value {{dataset}}
10. Click Save to create the data source

Step 2: Using PromQL with Dash0

Dash0's Prometheus-compatible API supports all the PromQL queries you are used to from Dash0. Here are some examples to get you started (find more in the Dash0 documentation):