Skip to content

Allow for custom Grafana Configuration

Summary

Grafana has many configuration options that are not directly exposed as configuration keys within the gitlab.rb.

Any custom configuration added directly/manually to the /var/opt/gitlab/grafana/grafana.ini is erased on reconfigure or upgrades.

This proposal is to add a custom configuration block that will allow administrations to add that custom configuration.

Proposal

Similar to what we do with custom NGINX settings add another configuration option within the gitlab.rb for custom Grafana settings.

https://docs.gitlab.com/omnibus/settings/nginx.html#inserting-custom-nginx-settings-into-the-gitlab-server-block

# Example Nginx
nginx['custom_gitlab_server_config'] = "location ^~ /foo-namespace/bar-project/raw/ {\n deny all;\n}\n"

# Example Grafana
grafana['custom_gitlab_server_config'] = "allow_embedding = true"

This would allow for administrators to add configuration specific to Grafana without the need for GitLab's gitlab.rb to support every parameter.

References