这篇文章以6.5.1版本的Grafana为例,对于Grafana配置文件的使用进行介绍。
事前准备
本文使用Docker方式准备Grafana环境,执行如下命令即可启动Grafana服务
执行命令:docker run -d -p 3000:3000 --name grafana grafana/grafana:6.5.1
配置文件说明
缺省配置文件
项目 | 设定值 |
默认配置文件目录 | /usr/share/grafana/conf |
默认配置文件名称 | defaults.ini |
liumiaocn:config liumiao$ docker exec -it grafana ls /etc/grafana/grafana.ini
/etc/grafana/grafana.ini
liumiaocn:config liumiao$
注意:分号是ini配置文件的标准注释方式。
配置文件设定方式
- 方式1: 使用–config指定配置文件
- 方式2: 通过环境变量GF_PATHS_CONFIG指定配置文件
比如官方Grafana 镜像中这两种方式都设定为同一值,配置文件的目录信息如下所示:
项目 | 设定值 |
配置文件目录 | /etc/grafana |
配置文件名称 | grafana.ini |
liumiaocn:config liumiao$ docker exec -it grafana sh
/usr/share/grafana $ env |grep PATHS_CONFIG
GF_PATHS_CONFIG=/etc/grafana/grafana.ini
/usr/share/grafana $ ps -ef |grep -v ps |grep -v -w sh
PID USER TIME COMMAND
1 grafana 0:09 grafana-server --homepath=/usr/share/grafana --config=/etc/grafana/grafana.ini --packaging=docker cfg:default.log.mode=console cfg:default.paths.data=/var/lib/grafana cfg:default.paths.logs=/var/log/grafana cfg:default.paths.plugins=/var/lib/grafana/plugins cfg:default.paths.provisioning=/etc/grafana/provisioning
/usr/share/grafana $
配置文件设定格式
配置文件的格式如下所示
[段名称]
键的名称 = 键的设定值
...
环境变量的使用方式
所有在配置文件设定的变量都可以通过环境变量来进行覆盖,相应的环境变量的名称规则如下所示:
环境变量映射规则:GF_段名称_键的名称
以Grafana启动时缺省的用户名和密码的设定为例,配置文件中可通过如下设定登录的用户名和密码为admin/admin.
[security]
# default admin user, created on startup
admin_user = admin
# default admin password, can be changed before first start of grafana, or in profile settings
admin_password = admin
在使用的时候,比如可以通过Dockerfile或者启动的docker run命令中指定如下环境变量来进行设定:
- 设定管理用户名名称的环境变量:GF_SECURITY_ADMIN_USER
部分配置文件设定
缺省段设定