这篇文章以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

部分配置文件设定

缺省段设定