This is a set of packages to configure Grafana and install dashboards, data sources and other resources used by perfSONAR.
This repository provides a Docker setup that runs Grafana and installs the dashboards in an editable mode. The datasources can be updated to point at a development archive so you also have data with which to work. You can do this by editing the Dockerfile to update the datasource with the URL of your archive (see comments in Dockerfile). To use the development environment perform the following steps:
- Run the following to start the container:
cd perfsonar-grafana/perfsonar-grafana
docker compose up --build -d
- Open your web browser to http://localhost:3000
- Login with user/pass admin/admin (in case its not obvious, use this for a local dev environment, not production).
- Change the password on the next screen if you so desire.
- Navigate to the dashboard you want to edit
- Make your changes and save.
- To export to git, in the UI on the dashboard to export click the Share icon, click the Export tab then click "View JSON" to see the JSON.
- Copy and paste the JSON to the appropriate file in the
dashboardssubdirectory.
The grafana subdirectory grabs the Grafana RPM and Debian packages of the version that is ships with perfSONAR. In grafana/packages.yaml update the URLs and file names with the new version of Grafana to grab a new version.
The build process of the perfsonar-grafana package downloads certain plugins since many users install perfSONAR on hosts without general internet the variable in perfsonar-grafana/perfsonar-grafana/grafana_common.sh with the new plugin information. See the comments in that file for more details.