Skip to content

Perses logo

Perses

An open specification for dashboards.
The open dashboard tool for Prometheus and other data sources.

Website · Documentation · Live demo · Slack · Discussions

What is Perses?

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.

Getting started

Explore the live demo, or run Perses locally with Docker:

docker run --name perses -d -p 127.0.0.1:8080:8080 persesdev/perses

Then 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.

Repositories

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.

Community

Contributing

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.

Cloud Native Computing Foundation logo

Pinned Loading

  1. perses perses Public

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

    Go 2.5k 267

  2. plugins plugins Public

    The core and community plugins for Perses

    TypeScript 33 97

  3. perses-operator perses-operator Public

    Perses Operator - Manage Perses on Kubernetes - Deploy dashboard as CR

    Go 53 24

  4. helm-charts helm-charts Public

    Perses helm chart

    Go Template 22 26

  5. community-mixins community-mixins Public

    Perses mixins : alertRules and dashboards

    Go 39 15

  6. spec spec Public

    The Perses dashboard and datasource specification defined in various languages

    Go 4 12

Repositories

Showing 10 of 22 repositories
  • perses Public

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

    perses/perses's past year of commit activity
    Go 2,538 Apache-2.0 267 238 (12 issues need help) 36 Updated Nov 16, 2026
  • plugins Public

    The core and community plugins for Perses

    perses/plugins's past year of commit activity
    TypeScript 33 Apache-2.0 97 10 37 Updated Nov 16, 2026
  • spec Public

    The Perses dashboard and datasource specification defined in various languages

    perses/spec's past year of commit activity
    Go 4 Apache-2.0 12 0 4 Updated Nov 16, 2026
  • shared Public

    Monorepo for the Perses UI shared packages

    perses/shared's past year of commit activity
    TypeScript 7 Apache-2.0 50 0 29 Updated Nov 16, 2026
  • metrics-usage Public

    A tool for tracking the usage of metrics across dashboards, alerting rules & recording rules

    perses/metrics-usage's past year of commit activity
    Go 55 Apache-2.0 7 2 1 Updated Nov 16, 2026
  • common Public

    Utility libraries for Perses

    perses/common's past year of commit activity
    Go 7 Apache-2.0 10 0 1 Updated Nov 16, 2026
  • mcp-server Public

    MCP Server for Perses

    perses/mcp-server's past year of commit activity
    Go 32 Apache-2.0 6 2 2 Updated Nov 15, 2026
  • perses-operator Public

    Perses Operator - Manage Perses on Kubernetes - Deploy dashboard as CR

    perses/perses-operator's past year of commit activity
    Go 53 Apache-2.0 24 13 11 Updated Nov 13, 2026
  • .github Public
    perses/.github's past year of commit activity
    0 0 0 0 Updated Nov 13, 2026
  • community-mixins Public

    Perses mixins : alertRules and dashboards

    perses/community-mixins's past year of commit activity
    Go 39 Apache-2.0 14 9 (1 issue needs help) 1 Updated Nov 13, 2026