An open specification for dashboards.
The open dashboard tool for Prometheus and other data sources.
Website · Documentation · Live demo · Slack · Discussions
Perses is first and foremost a dashboard tool to display observability data. It supports all four observability pillars through Prometheus metrics, Tempo traces, Loki logs and Pyroscope profiles, and many other datasources through plugins.
Beyond that, Perses aims to be:
- Open: it defines a standardized dashboard specification, fostering interoperability across observability tools.
- Extensible: its plugin-based architecture lets you add new panels, datasources, queries and variables.
- Embeddable: npm packages let you integrate Perses panels and dashboards into your own UI.
- GitOps-friendly: a CLI, static validation and SDKs in Go and CUE provide a great Dashboard-as-Code experience.
- Kubernetes-native: the Perses Operator manages Perses, dashboards and datasources as custom resources.
Explore the live demo, or run Perses locally with Docker:
docker run --name perses -d -p 127.0.0.1:8080:8080 persesdev/persesThen open http://localhost:8080 and follow the getting started guide to create your first dashboard. Perses can also be installed with Homebrew, Helm or the Perses Operator.
| Repository | Description |
|---|---|
| perses | The Perses server and web UI, the percli CLI, and the Go and CUE Dashboard-as-Code SDKs. |
| plugins | The core plugins: datasources (Prometheus, Tempo, Loki, Pyroscope...), panels and variables. |
| shared | The @perses-dev/* UI libraries, to build plugins or embed Perses panels and dashboards. |
| spec | The dashboard and datasource specification, available in CUE, Go, Java and TypeScript. |
| perses-operator | Kubernetes operator to deploy Perses and manage dashboards and datasources as custom resources. |
| helm-charts | Helm charts for Perses and the Perses Operator. |
| community-mixins | Ready-to-use dashboards, alerting rules and recording rules, written with the Go SDK. |
| cli-actions | GitHub Actions to build, validate, preview and deploy dashboards as code with percli. |
| mcp-server | MCP server that lets LLM hosts interact with Perses. |
| metrics-usage | Track where metrics are used across dashboards, alerting rules and recording rules. |
| promql-builder | Go library to build PromQL expressions. |
- Chat with us in #perses-dev on the CNCF Slack (get an invite).
- Ask questions and share ideas in GitHub Discussions.
- Report bugs and request features in the issue tracker.
- Join the weekly team meeting, open to everyone.
- Follow us on X and LinkedIn.
Contributions of all kinds are welcome! Start with the contributing guide, and have a look at the roadmap and the governance of the project.
Perses follows the CNCF Code of Conduct. To report a security vulnerability, please follow our security policy.
Perses is a Cloud Native Computing Foundation sandbox project.
