|
| 1 | +--- |
| 2 | +title: Perses support for Prometheus |
| 3 | +nav_title: Perses |
| 4 | +sort_rank: 3 |
| 5 | +--- |
| 6 | + |
| 7 | +[Perses](https://perses.dev) is an open-source dashboard and visualization platform designed for observability, with |
| 8 | +native support for Prometheus as a data source. |
| 9 | +It enables users to create, manage, and share dashboards for monitoring metrics and visualizing data. |
| 10 | +Perses aims to provide a simple, flexible, and extensible alternative to other dashboarding tools, focusing on ease of |
| 11 | +use, community-driven development, GitOps capabilities and dashboard as code approach. |
| 12 | + |
| 13 | +Here is an example of a Perses dashboard querying Prometheus for data: |
| 14 | + |
| 15 | +[](/assets/docs/perses_prometheus.png) |
| 16 | + |
| 17 | +## Installing |
| 18 | + |
| 19 | +To install Perses, see the official [Perses documentation](https://perses.dev/perses/docs/installation/in-a-container/). |
| 20 | + |
| 21 | +## Using |
| 22 | + |
| 23 | +By default, Perses will be listening on port `8080`. You can access the web UI at `http://localhost:8080`. There is no |
| 24 | +login by default. |
| 25 | + |
| 26 | +### Creating a Prometheus data source |
| 27 | + |
| 28 | +To learn about how to set up a data source in Perses, please refer |
| 29 | +to [Perses documentation](https://perses.dev/perses/docs/concepts/datasources). |
| 30 | +Once this connection to your Prometheus instance is configured, you are able to query it from the Dashboard and Explore |
| 31 | +views. |
| 32 | + |
| 33 | +### Importing pre-built dashboards |
| 34 | + |
| 35 | +Perses is providing a set of pre-built dashboards that you can import into your instance. These dashboards are |
| 36 | +maintained by the community and can be found in |
| 37 | +the [Perses dashboard repository](https://github.com/perses/community-dashboards) |
0 commit comments