Perses

Overview

Dash0 provides a Prometheus-compatible API that can be configured as a data source in Perses, allowing you to create custom dashboards and visualizations using your telemetry data.

Use Cases

• Migration Path: Migrate step by step to Dash0 while maintaining existing dashboard workflows.

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):

# Span count per service
sum by(service_name) (increase({otel_metric_name = "dash0.spans"}[$__interval]) > 0)

# P95 span duration in milliseconds
histogram_quantile(0.95, sum by (service_name) (rate({otel_metric_name = "dash0.spans.duration"}[$__interval]))) * 1000

# Logs grouped by their severity
sum by (otel_log_severity_range) (increase({otel_metric_name = "dash0.logs"}[$__interval])) > 0