Perses Spec is a specification repository that defines the dashboard and datasource formats for the Perses observability platform across multiple programming languages.
The repository addresses the need for a standardized, language-agnostic definition of how Perses dashboards and datasources should be structured. Rather than embedding format definitions in a single implementation, the project provides formal specifications in various languages, allowing different tools and plugins to generate, validate, and consume Perses configurations consistently. The specifications cover core dashboard and datasource features while remaining extensible; plugin authors can add custom fields to the base specifications to support their own functionality.
Teams building dashboards or datasources for Perses, or creating plugins that integrate with the platform, should use this repository as the authoritative reference for the expected structure and behavior of these components. The multi-language approach makes it suitable for projects written in different programming languages that need to work with Perses configurations. The repository explicitly acknowledges that it provides partial specifications covering only core features, with the understanding that the plugin ecosystem extends these definitions.
The project maintains active development with regular updates to the specifications and consistent engagement with pull requests and issues. The codebase shows ongoing refinement of the specification definitions across supported languages. Contributions from the community are actively reviewed and integrated into the project.
