每个服务程序,基本上都会指定一个或多个配置文件,用来定制其所要启用的功能,Grafana 也不例外,那么 Grafana 的配置文件有哪些,以及提供了什么样的配置选项呢?

Grafana 的配置文件

Grafana 后端的配置文件可以是多个以 .ini 结尾的文件,grafana 主要从三个配置文件中读取配置选项:

默认配置

Grafana 的默认配置在:

1
$WORKING_DIR/conf/defaults.ini

这里面放的是 Grafana 最原始的配置,我们不要随意修改这个文件。

用户自定义配置

Grafana 也给用户提供了自定义配置文件,位置在:

1
$WORKING_DIR/conf/custom.ini`、

deb 或 rpm 包安装方式的配置文件

如果以 deprpm 方式安装的 grafana,则默认的配置文件在:

1
/etc/grafana/grafana.ini

这个文件是在 init.d 的启动脚本中通过 –config 参数指定的

Note: 以上配置文件的位置均为默认位置,用户在实际使用中可以使用 --config 来指定配置文件的位置。

用环境变量指定配置

所有在配置文件中的配置都可以通过环境变量来覆盖, 使用的语法如下:GF_<SectionName>_<KeyName>, 例如:

1
2
3
4
5
6
7
8
 # default section
instance_name = ${HOSTNAME}

[security]
admin_user = admin

[auth.google]
client_secret = oldSecretKey

如果使用环境变量,则是:

1
2
3
export GF_DEFAULT_INSTANCE_NAME=my-instance
export GF_SECURITY_ADMIN_USER=true
export GF_AUTH_GOOGLE_CLIENT_SECRET=newS3cretKey

Grafana 的配置选项

Grafana V5.2

default section

1
2
app_mode: 应用名称,默认是 production (另一个值为:development)
instance_name:实例名称,默认取 $HOSTNAME 的值, $HOSTNAME 为空,则用常量 `hostname ` 表示

……

See Also

Thanks to the authors 🙂