diff --git a/docs/visualization/consoles.md b/docs/visualization/consoles.md index 453955ee4..5b8e14f61 100644 --- a/docs/visualization/consoles.md +++ b/docs/visualization/consoles.md @@ -1,6 +1,6 @@ --- title: Console templates -sort_rank: 3 +sort_rank: 4 --- Console templates allow for creation of arbitrary consoles using the [Go diff --git a/docs/visualization/perses.md b/docs/visualization/perses.md new file mode 100644 index 000000000..021782d25 --- /dev/null +++ b/docs/visualization/perses.md @@ -0,0 +1,37 @@ +--- +title: Perses support for Prometheus +nav_title: Perses +sort_rank: 3 +--- + +[Perses](https://perses.dev) is an open-source dashboard and visualization platform designed for observability, with +native support for Prometheus as a data source. +It enables users to create, manage, and share dashboards for monitoring metrics and visualizing data. +Perses aims to provide a simple, flexible, and extensible alternative to other dashboarding tools, focusing on ease of +use, community-driven development, GitOps capabilities and dashboard as code approach. + +Here is an example of a Perses dashboard querying Prometheus for data: + +[![Perses screenshot](/assets/docs/perses_prometheus.png)](/assets/docs/perses_prometheus.png) + +## Installing + +To install Perses, see the official [Perses documentation](https://perses.dev/perses/docs/installation/in-a-container/). + +## Using + +By default, Perses will be listening on port `8080`. You can access the web UI at `http://localhost:8080`. There is no +login by default. + +### Creating a Prometheus data source + +To learn about how to set up a data source in Perses, please refer +to [Perses documentation](https://perses.dev/perses/docs/concepts/datasources). +Once this connection to your Prometheus instance is configured, you are able to query it from the Dashboard and Explore +views. + +### Importing pre-built dashboards + +Perses is providing a set of pre-built dashboards that you can import into your instance. These dashboards are +maintained by the community and can be found in +the [Perses dashboard repository](https://github.com/perses/community-dashboards) diff --git a/public/assets/docs/perses_prometheus.png b/public/assets/docs/perses_prometheus.png new file mode 100644 index 000000000..72b621c8c Binary files /dev/null and b/public/assets/docs/perses_prometheus.png differ