mirror/infrastructure
1
1
Fork 0
mirror of https://gitlab.archlinux.org/archlinux/infrastructure.git synced 2026-09-08 00:44:05 +02:00
Code Issues Activity
Files
buildbtw-remove-chain-bind-mount
infrastructure/docs/grafana.md
T
Robin Candau 4abfcedf05 docs: Update Grafana documentation 
- Out of date bits (e.g. regarding the way to export the dashboard from Grafana and the way to extend the `remote_write` regex when adding new dashboards to `dashboards.archlinux.org`)
- Wrong filenames (e.g. missing `.yml` at the end of the playbooks filenames)
- Missing a few details (e.g. about the way to extend the `remote_write` regex and deploy dashboards when adding new dashboard to `dashboards.archlinux.org`)
2025-12-09 23:39:11 +01:00

1.6 KiB
Raw Permalink Blame History

Grafana

Our Grafana is hosted on https://monitoring.archlinux.org and is accessible only to DevOps Staff.

A public accessible instance is hosted on https://dashboards.archlinux.org with selected metrics using prometheus "remote write" feature.

Dashboards and datasources are automatically provisioned by Grafana with Grafana's built-in provisioning configuration.

Adding a new Dashboard

A new dashboard can be configured in our Grafana instance to try it out and if satisfactory checked in to Git as following:

  • Export the dashboard to json (top right, Export => Export as code => Download file).
  • Save the json file in roles/grafana/files/dashboards.
  • Git add the file and run ansible-playbook playbooks/monitoring.archlinux.org.yml -t grafana.

Adding new metrics to dashboards.archlinux.org

Metrics can be added to the public grafana instance if they are already collected on monitoring.archlinux.org:

  • Verify that the metrics are allowed to be made public and check with another DevOps member.
  • Create a symlink in roles/grafana/files/public-dashboards to the dashboard in roles/grafana/files/dashboards.
  • Edit roles/prometheus/defaults/main.yml and extend the prometheus_remote_write_relabel_configs block with the job name matching the prometheus config from roles/prometheus/templates/prometheus.yml.j2.
  • Run ansible-playbook playboks/monitoring.archlinux.org.yml -t prometheus to update the remote_write configuration.
  • Run ansible-playbook playboks/dashboards.archlinux.org.yml -t grafana to deploy the dashboard to dashboards.archlinux.org.
View Git Blame Copy Permalink