perses

The CNCF sandbox for observability visualisation. Supports Prometheus, Tempo, Loki, Pyroscope, and more!

What is perses?

The CNCF sandbox for observability visualisation. Supports Prometheus, Tempo, Loki, Pyroscope, and more!

Overview of perses

What it is

Perses is a dashboard tool for displaying observability data. It is a Cloud Native Computing Foundation (CNCF) sandbox project. The tool supports data from Prometheus metrics, Tempo traces, Loki logs, and Pyroscope profiling, along with additional datasources available through plugins. Perses also aims to define an open specification for dashboards, provide integrable npm packages for embedding panels, support extensibility through plugins, enable GitOps workflows with SDKs and a CLI, and offer a Kubernetes-native mode using Custom Resource Definitions (CRDs). An online demo is available at https://demo.perses.dev.

Key features

  • Supports Prometheus, Tempo, Loki, Pyroscope, and more datasources via plugins.
  • Provides an open specification for dashboard definitions to foster interoperability.
  • Offers npm packages for embedding panels and dashboards into custom UIs.
  • Includes a plugin architecture for extending native capabilities.
  • Supports GitOps workflows with SDKs (Golang and Cuelang), a CLI, and static validation.
  • Kubernetes-native mode allows dashboard definitions as Custom Resource Definitions (CRDs).

Use cases

Perses can be used to visualize observability data across metrics, traces, logs, and profiling signals. It is suitable for teams that need a standardized, interoperable dashboard specification. Developers can embed Perses panels into their own applications using the provided npm packages. Organizations using GitOps practices can manage dashboards as code with the provided SDKs and CLI. Kubernetes users can deploy dashboard definitions into application namespaces using CRDs.

Getting started

Precompiled binaries are available in the GitHub release. Docker images are available on Docker Hub. To launch a Perses container: bash docker run --name perses -d -p 127.0.0.1:8080:8080 persesdev/perses On macOS or Linux, install via Homebrew: brew install perses/tap/perses for the server and web UI, brew install perses/tap/percli for the CLI. To build from source, clone the repository and run make build: bash git clone https://github.com/perses/perses.git cd perses make build ./bin/perses --config=your_config.yml

License and pricing

The code is licensed under Apache 2.0. Pricing is not stated; the project is open source.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/persesperses.svg)](https://yunodb.com/tools/persesperses?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/persesperses?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/persesperses.svg" alt="Featured on YunoDB" height="20"></a>