History

Michal Kuratczyk a5106c6a61 Trigger a 4.2.x alpha release build / trigger_alpha_build (push) Waiting to run Details Test (make) / Build and Xref (1.18, 26) (push) Waiting to run Details Test (make) / Build and Xref (1.18, 27) (push) Waiting to run Details Test (make) / Build and Xref (1.18, 28) (push) Waiting to run Details Test (make) / Test (1.18, 28, khepri) (push) Waiting to run Details Test (make) / Test (1.18, 28, mnesia) (push) Waiting to run Details Test (make) / Test mixed clusters (1.18, 28, khepri) (push) Waiting to run Details Test (make) / Test mixed clusters (1.18, 28, mnesia) (push) Waiting to run Details Test (make) / Type check (1.18, 28) (push) Waiting to run Details Expose ra counters (#13895 ) Switch from ra_metrics to ra_counters * Expose many more metrics (they are also up to date) * Bump Seshat, Ra, Osiris, Prometheus.erl * switch from proplists to maps		2025-07-24 10:43:20 +02:00
..
dashboards	Expose ra counters (#13895 )	2025-07-24 10:43:20 +02:00
publish	Publish RabbitMQ-Stream dashboard to grafana.com	2021-07-29 19:34:05 +01:00
README.md	Add README.md for creating/updating dashboards	2022-08-05 17:41:47 +01:00
dashboards.yml	Preconfigure Grafana on boot	2019-04-16 15:48:44 +01:00
datasources.yml	Extract __requires from Grafana dashboards, template all datasources	2019-10-03 17:32:40 +01:00

README.md

RabbitMQ Grafana Dashboards

Creating or updating dashboards

Making changes

First, from the rabbitmq_prometheus directory, run make overview metrics to spin up a local environment using docker-compose. This will provide you with a full Prometheus + Grafana stack, and sample workloads to make the dashboards 'come alive' with non-zero metrics. To tear down this infrastructure, run make down.

Login to localhost:3000 with the credentials admin:admin and begin creating / updating your dashboard in the Grafana UI.

Once you have finished editing your dashboard, navigate to the 'Share' menu next to the name of the dashboard, go to 'Export', and be sure to tick 'Export for sharing externally'. Either save the dashboard JSON to a file or click 'View JSON' and copy-paste over into this repo.

At this point, you can test your changes work on different versions of Grafana, by editing services.grafana.image in docker-compose-metrics.yml and running make metrics to rebuild the Grafana server. Be sure to test on the latest version publicly available.

If creating a new dashboard

You will need some additional files for a new dashboard:

A description of the dashboard; see the Erlang-Distribution one for example
Screenshots of the dashboard in action, saved in ./publish/

Create a PR

Create a pull request in rabbitmq-server with the above changes.

Making a dashboard available on grafana.com

If you are on the RabbitMQ team, navigate to our GrafanaLabs dashboard at https://grafana.com/orgs/rabbitmq/dashboards, and log in with the team credentials.

Once a PR is merged, either create a new revision of a dashboard from the JSON checked in under ./dashboards/, or create a new dashboard from the JSON.