Sourcegraph Grafana

We ship a custom Grafana image as part of a standard Sourcegraph distribution. Learn more about it in our monitoring architecture.

Adding dashboards, panels, etc. to this image is handled by the monitoring generator.

The image is defined in docker-images/grafana.

Dashboards

See the metrics and dashboards documentation.

To learn more about building dashboards, see the observability developer guides.

Upgrading Grafana

To upgrade Grafana:

  1. Make the appropriate version changes to the sourcegraph/grafana Dockerfile
  2. Ensure that no migration steps are required: Migrate from previous Grafana container versions
  3. Ensure the image still builds: ./docker-images/grafana/build.sh
  4. Run the monitoring stack locally and verify that all generated Grafana dashboards still render correctly