Installation¶
Minimum Software Requirements¶
PCP | Redis | Grafana | grafana-pcp |
---|---|---|---|
5.2+ | 5+ | 7.x | 3.x |
5.2+ | 5+ | 8.x | 4.x |
5.2+ | 5+ | 9.x | 5.x |
Note: Redis is only required for the PCP Redis data source.
Distribution Package¶
Distribution Package is the recommended method of installing grafana-pcp.
Fedora¶
$ sudo dnf install grafana-pcp
$ sudo systemctl restart grafana-server
GitHub Release¶
If there is no package available for your distribution, you can install a release from GitHub. Replace X.Y.Z with the version of grafana-pcp you wish to install.
$ wget https://github.com/performancecopilot/grafana-pcp/releases/download/vX.Y.Z/performancecopilot-pcp-app-X.Y.Z.zip
$ sudo unzip -d /var/lib/grafana/plugins performancecopilot-pcp-app-X.Y.Z.zip
$ sudo systemctl restart grafana-server
Container¶
You can also run Grafana with grafana-pcp in a container, using podman or docker. Keep in mind that with the default configuration, every container has its own isolated network, and you won’t be able to reach pmproxy through localhost. Replace X.Y.Z with the version of grafana-pcp you wish to install.
$ podman run \
-e GF_INSTALL_PLUGINS="https://github.com/performancecopilot/grafana-pcp/releases/download/vX.Y.Z/performancecopilot-pcp-app-X.Y.Z.zip;performancecopilot-pcp-app" \
-p 3000:3000 \
docker.io/grafana/grafana
$ docker run \
-e GF_INSTALL_PLUGINS="https://github.com/performancecopilot/grafana-pcp/releases/download/vX.Y.Z/performancecopilot-pcp-app-X.Y.Z.zip;performancecopilot-pcp-app" \
-p 3000:3000 \
grafana/grafana
From Source¶
The yarn package manager, Go compiler, jsonnet and jsonnet bundler are required to build grafana-pcp.
$ git clone https://github.com/performancecopilot/grafana-pcp.git
$ make build
$ sudo ln -s $(pwd) /var/lib/grafana/plugins
$ sudo sed -i 's/;allow_loading_unsigned_plugins =/allow_loading_unsigned_plugins = performancecopilot-pcp-app,performancecopilot-redis-datasource,performancecopilot-vector-datasource,performancecopilot-bpftrace-datasource,performancecopilot-flamegraph-panel,performancecopilot-breadcrumbs-panel,performancecopilot-troubleshooting-panel/' /etc/grafana/grafana.ini
$ sudo systemctl restart grafana-server
To list all available Makefile targets, run make help
.