Technology
Perses
Use Dash0 as a Prometheus-compatible data source in Perses. Create custom dashboards with your telemetry data.
Overview
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
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
- Log in to your Perses instance
- Navigate to Admin > Global Datasources
- Click Add Global Datasource
- In the dialog that appears:
- Set Name to a descriptive name (e.g., Dash0)
- Set Source to Prometheus Datasource
- Under HTTP Settings > Proxy:
- Set the URL to
{{endpoint_api_prometheus}} - In the Headers section, add:
- An
Authorizationheader with the valueBearer {{token}} - A
Dash0-Datasetheader with the value{{dataset}}
- An
- 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):
promql
# 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