Grafana文檔（配置）

配置

Grafana後端有許多配置選項，能夠在.ini配置文件中指定或使用環境變量指定。

注意，須要從新啓動Grafana才能使任何配置更改生效。

.ini文件中的註釋

分號（;字符）是註釋掉.ini文件中的行的標準方法。

一個常見的問題是忘記取消註釋custom.ini（或grafana.ini）文件中的一行，這會致使忽略配置選項。

配置文件位置

• 默認配置來自$WORKING_DIR/conf/defaults.ini
• 自定義配置來自$WORKING_DIR/conf/custom.ini
• 可使用--config參數覆蓋自定義配置文件路徑

注意，若是你使用 deb或 rpm軟件包安裝了Grafana，那麼你的配置文件位於 /etc/grafana/grafana.ini，此路徑使用 --config文件參數在Grafana init.d腳本中指定。

使用環境變量

可使用如下語法使用環境變量覆蓋配置文件（下面列出）中的全部選項：

GF_<SectionName>_<KeyName>

SectionName是括號內的文本，全部都應該是大寫的，.應該替換爲_。例如，給定這些配置設置：

# default section
instance_name = ${HOSTNAME}

[security]
admin_user = admin

[auth.google]
client_secret = 0ldS3cretKey

而後你可使用如下方法覆蓋它：

export GF_DEFAULT_INSTANCE_NAME=my-instance
export GF_SECURITY_ADMIN_USER=true
export GF_AUTH_GOOGLE_CLIENT_SECRET=newS3cretKey

---

instance_name

設置grafana-server實例的名稱，用於記錄和內部指標以及羣集信息，默認爲：${HOSTNAME}，將替換爲環境變量HOSTNAME，若是它是空的或不存在，Grafana將嘗試使用系統調用來獲取機器名稱。

[paths]

data

Grafana存儲sqlite3數據庫（若是使用），基於文件的會話（若是使用）和其餘數據的路徑，此路徑一般經過init.d腳本或systemd服務文件中的命令行指定。

temp_data_lifetime

應保留data目錄中的臨時鏡像多長時間，默認爲：24h。支持的修飾符：h（小時），m（分鐘），例如：168h，30m，10h30m，使用0從不清理臨時文件。

logs

Grafana將存儲日誌的路徑，此路徑一般經過init.d腳本或systemd服務文件中的命令行指定，它能夠在配置文件或默認環境變量文件中重寫。

plugins

grafana將自動掃描並查找插件的目錄。

provisioning

包含grafana在啓動時應用的Provisioning配置文件的文件夾，當json文件更改時，將從新加載儀表盤。

[server]

http_addr

要綁定的IP地址，若是爲空將綁定到全部接口。

http_port

要綁定的端口，默認爲3000，要使用端口80，你須要提供Grafana二進制權限，例如：

$ sudo setcap 'cap_net_bind_service=+ep' /usr/sbin/grafana-server

或者使用如下命令將端口80重定向到Grafana端口：

$ sudo iptables -t nat -A PREROUTING -p tcp --dport 80 -j REDIRECT --to-port 3000

另外一種方法是將一個像Nginx或Apache這樣的網絡服務器放在Grafana面前，讓他們向Grafana提出代理請求。

protocol

http或https

注意早於3.0的Grafana版本容易受到 POODLE的攻擊，因此咱們強烈建議升級到3.x或爲ssl終端使用反向代理。

domain

此設置僅用做root_url設置的一部分（參見下文），若是你使用GitHub或Google OAuth，則很重要。

enforce_domain

若是主機header與域不匹配，則重定向到正確的域，防止DNS從新綁定攻擊，默認值爲false。

root_url

這是用於從Web瀏覽器訪問Grafana的完整URL，若是您使用Google或GitHub OAuth身份驗證（以使回調網址正確），這一點很重要。

注意若是Grafana前面有一個反向代理經過子路徑公開它，則此設置也很重要，在這種狀況下，將子路徑添加到此URL設置的末尾。

static_root_path

前端文件（HTML，JS和CSS文件）所在目錄的路徑，默認爲public，這就是爲何須要在將工做目錄設置爲安裝路徑的狀況下執行Grafana二進制文件的緣由。

cert_file

證書文件的路徑（若是協議設置爲https）。

cert_key

證書密鑰文件的路徑（若是協議設置爲https）。

router_logging

爲Grafana設置爲true以記錄全部HTTP請求（而不單單是錯誤），這些被記錄爲Info級別事件到grafana日誌。

---

---

[database]

Grafana須要一個數據庫來存儲用戶和儀表盤（以及其餘東西），默認狀況下，它配置爲使用sqlite3，這是一個嵌入式數據庫（包含在主Grafana二進制文件中）。

url

使用如下URL或其餘字段配置數據庫示例：

mysql://user:secret@host:port/database

type

不管是mysql，postgres仍是sqlite3，都是你的選擇。