setting.go 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572
  1. // Copyright 2014 Unknwon
  2. // Copyright 2014 Torkel Ödegaard
  3. package setting
  4. import (
  5. "bytes"
  6. "encoding/json"
  7. "fmt"
  8. "net/url"
  9. "os"
  10. "path"
  11. "path/filepath"
  12. "regexp"
  13. "runtime"
  14. "strings"
  15. "github.com/macaron-contrib/session"
  16. "gopkg.in/ini.v1"
  17. "github.com/grafana/grafana/pkg/log"
  18. "github.com/grafana/grafana/pkg/util"
  19. )
  20. type Scheme string
  21. const (
  22. HTTP Scheme = "http"
  23. HTTPS Scheme = "https"
  24. )
  25. const (
  26. DEV string = "development"
  27. PROD string = "production"
  28. TEST string = "test"
  29. )
  30. var (
  31. // App settings.
  32. Env string = DEV
  33. AppUrl string
  34. AppSubUrl string
  35. // build
  36. BuildVersion string
  37. BuildCommit string
  38. BuildStamp int64
  39. // Paths
  40. LogsPath string
  41. HomePath string
  42. DataPath string
  43. // Log settings.
  44. LogModes []string
  45. LogConfigs []util.DynMap
  46. // Http server options
  47. Protocol Scheme
  48. Domain string
  49. HttpAddr, HttpPort string
  50. SshPort int
  51. CertFile, KeyFile string
  52. RouterLogging bool
  53. StaticRootPath string
  54. EnableGzip bool
  55. EnforceDomain bool
  56. // Security settings.
  57. SecretKey string
  58. LogInRememberDays int
  59. CookieUserName string
  60. CookieRememberName string
  61. DisableGravatar bool
  62. EmailCodeValidMinutes int
  63. DataProxyWhiteList map[string]bool
  64. // User settings
  65. AllowUserSignUp bool
  66. AllowUserOrgCreate bool
  67. AutoAssignOrg bool
  68. AutoAssignOrgRole string
  69. VerifyEmailEnabled bool
  70. // Http auth
  71. AdminUser string
  72. AdminPassword string
  73. AnonymousEnabled bool
  74. AnonymousOrgName string
  75. AnonymousOrgRole string
  76. // Auth proxy settings
  77. AuthProxyEnabled bool
  78. AuthProxyHeaderName string
  79. AuthProxyHeaderProperty string
  80. AuthProxyAutoSignUp bool
  81. // Basic Auth
  82. BasicAuthEnabled bool
  83. // Session settings.
  84. SessionOptions session.Options
  85. // Global setting objects.
  86. Cfg *ini.File
  87. ConfRootPath string
  88. IsWindows bool
  89. // PhantomJs Rendering
  90. ImagesDir string
  91. PhantomDir string
  92. // for logging purposes
  93. configFiles []string
  94. appliedCommandLineProperties []string
  95. appliedEnvOverrides []string
  96. ReportingEnabled bool
  97. GoogleAnalyticsId string
  98. GoogleTagManagerId string
  99. // LDAP
  100. LdapEnabled bool
  101. LdapConfigFile string
  102. // SMTP email settings
  103. Smtp SmtpSettings
  104. )
  105. type CommandLineArgs struct {
  106. Config string
  107. HomePath string
  108. Args []string
  109. }
  110. func init() {
  111. IsWindows = runtime.GOOS == "windows"
  112. log.NewLogger(0, "console", `{"level": 0}`)
  113. }
  114. func parseAppUrlAndSubUrl(section *ini.Section) (string, string) {
  115. appUrl := section.Key("root_url").MustString("http://localhost:3000/")
  116. if appUrl[len(appUrl)-1] != '/' {
  117. appUrl += "/"
  118. }
  119. // Check if has app suburl.
  120. url, err := url.Parse(appUrl)
  121. if err != nil {
  122. log.Fatal(4, "Invalid root_url(%s): %s", appUrl, err)
  123. }
  124. appSubUrl := strings.TrimSuffix(url.Path, "/")
  125. return appUrl, appSubUrl
  126. }
  127. func ToAbsUrl(relativeUrl string) string {
  128. return AppUrl + relativeUrl
  129. }
  130. func applyEnvVariableOverrides() {
  131. appliedEnvOverrides = make([]string, 0)
  132. for _, section := range Cfg.Sections() {
  133. for _, key := range section.Keys() {
  134. sectionName := strings.ToUpper(strings.Replace(section.Name(), ".", "_", -1))
  135. keyName := strings.ToUpper(strings.Replace(key.Name(), ".", "_", -1))
  136. envKey := fmt.Sprintf("GF_%s_%s", sectionName, keyName)
  137. envValue := os.Getenv(envKey)
  138. if len(envValue) > 0 {
  139. key.SetValue(envValue)
  140. appliedEnvOverrides = append(appliedEnvOverrides, fmt.Sprintf("%s=%s", envKey, envValue))
  141. }
  142. }
  143. }
  144. }
  145. func applyCommandLineDefaultProperties(props map[string]string) {
  146. appliedCommandLineProperties = make([]string, 0)
  147. for _, section := range Cfg.Sections() {
  148. for _, key := range section.Keys() {
  149. keyString := fmt.Sprintf("default.%s.%s", section.Name(), key.Name())
  150. value, exists := props[keyString]
  151. if exists {
  152. key.SetValue(value)
  153. appliedCommandLineProperties = append(appliedCommandLineProperties, fmt.Sprintf("%s=%s", keyString, value))
  154. }
  155. }
  156. }
  157. }
  158. func applyCommandLineProperties(props map[string]string) {
  159. for _, section := range Cfg.Sections() {
  160. for _, key := range section.Keys() {
  161. keyString := fmt.Sprintf("%s.%s", section.Name(), key.Name())
  162. value, exists := props[keyString]
  163. if exists {
  164. key.SetValue(value)
  165. appliedCommandLineProperties = append(appliedCommandLineProperties, fmt.Sprintf("%s=%s", keyString, value))
  166. }
  167. }
  168. }
  169. }
  170. func getCommandLineProperties(args []string) map[string]string {
  171. props := make(map[string]string)
  172. for _, arg := range args {
  173. if !strings.HasPrefix(arg, "cfg:") {
  174. continue
  175. }
  176. trimmed := strings.TrimPrefix(arg, "cfg:")
  177. parts := strings.Split(trimmed, "=")
  178. if len(parts) != 2 {
  179. log.Fatal(3, "Invalid command line argument", arg)
  180. return nil
  181. }
  182. props[parts[0]] = parts[1]
  183. }
  184. return props
  185. }
  186. func makeAbsolute(path string, root string) string {
  187. if filepath.IsAbs(path) {
  188. return path
  189. }
  190. return filepath.Join(root, path)
  191. }
  192. func evalEnvVarExpression(value string) string {
  193. regex := regexp.MustCompile(`\${(\w+)}`)
  194. return regex.ReplaceAllStringFunc(value, func(envVar string) string {
  195. envVar = strings.TrimPrefix(envVar, "${")
  196. envVar = strings.TrimSuffix(envVar, "}")
  197. envValue := os.Getenv(envVar)
  198. return envValue
  199. })
  200. }
  201. func evalConfigValues() {
  202. for _, section := range Cfg.Sections() {
  203. for _, key := range section.Keys() {
  204. key.SetValue(evalEnvVarExpression(key.Value()))
  205. }
  206. }
  207. }
  208. func loadSpecifedConfigFile(configFile string) {
  209. if configFile == "" {
  210. configFile = filepath.Join(HomePath, "conf/custom.ini")
  211. // return without error if custom file does not exist
  212. if !pathExists(configFile) {
  213. return
  214. }
  215. }
  216. userConfig, err := ini.Load(configFile)
  217. userConfig.BlockMode = false
  218. if err != nil {
  219. log.Fatal(3, "Failed to parse %v, %v", configFile, err)
  220. }
  221. for _, section := range userConfig.Sections() {
  222. for _, key := range section.Keys() {
  223. if key.Value() == "" {
  224. continue
  225. }
  226. defaultSec, err := Cfg.GetSection(section.Name())
  227. if err != nil {
  228. log.Error(3, "Unknown config section %s defined in %s", section.Name(), configFile)
  229. continue
  230. }
  231. defaultKey, err := defaultSec.GetKey(key.Name())
  232. if err != nil {
  233. log.Error(3, "Unknown config key %s defined in section %s, in file %s", key.Name(), section.Name(), configFile)
  234. continue
  235. }
  236. defaultKey.SetValue(key.Value())
  237. }
  238. }
  239. configFiles = append(configFiles, configFile)
  240. }
  241. func loadConfiguration(args *CommandLineArgs) {
  242. var err error
  243. // load config defaults
  244. defaultConfigFile := path.Join(HomePath, "conf/defaults.ini")
  245. configFiles = append(configFiles, defaultConfigFile)
  246. Cfg, err = ini.Load(defaultConfigFile)
  247. Cfg.BlockMode = false
  248. if err != nil {
  249. log.Fatal(3, "Failed to parse defaults.ini, %v", err)
  250. }
  251. // command line props
  252. commandLineProps := getCommandLineProperties(args.Args)
  253. // load default overrides
  254. applyCommandLineDefaultProperties(commandLineProps)
  255. // init logging before specific config so we can log errors from here on
  256. DataPath = makeAbsolute(Cfg.Section("paths").Key("data").String(), HomePath)
  257. initLogging(args)
  258. // load specified config file
  259. loadSpecifedConfigFile(args.Config)
  260. // apply environment overrides
  261. applyEnvVariableOverrides()
  262. // apply command line overrides
  263. applyCommandLineProperties(commandLineProps)
  264. // evaluate config values containing environment variables
  265. evalConfigValues()
  266. // update data path and logging config
  267. DataPath = makeAbsolute(Cfg.Section("paths").Key("data").String(), HomePath)
  268. initLogging(args)
  269. }
  270. func pathExists(path string) bool {
  271. _, err := os.Stat(path)
  272. if err == nil {
  273. return true
  274. }
  275. if os.IsNotExist(err) {
  276. return false
  277. }
  278. return false
  279. }
  280. func setHomePath(args *CommandLineArgs) {
  281. if args.HomePath != "" {
  282. HomePath = args.HomePath
  283. return
  284. }
  285. HomePath, _ = filepath.Abs(".")
  286. // check if homepath is correct
  287. if pathExists(filepath.Join(HomePath, "conf/defaults.ini")) {
  288. return
  289. }
  290. // try down one path
  291. if pathExists(filepath.Join(HomePath, "../conf/defaults.ini")) {
  292. HomePath = filepath.Join(HomePath, "../")
  293. }
  294. }
  295. func NewConfigContext(args *CommandLineArgs) {
  296. setHomePath(args)
  297. loadConfiguration(args)
  298. Env = Cfg.Section("").Key("app_mode").MustString("development")
  299. server := Cfg.Section("server")
  300. AppUrl, AppSubUrl = parseAppUrlAndSubUrl(server)
  301. Protocol = HTTP
  302. if server.Key("protocol").MustString("http") == "https" {
  303. Protocol = HTTPS
  304. CertFile = server.Key("cert_file").String()
  305. KeyFile = server.Key("cert_key").String()
  306. }
  307. Domain = server.Key("domain").MustString("localhost")
  308. HttpAddr = server.Key("http_addr").MustString("0.0.0.0")
  309. HttpPort = server.Key("http_port").MustString("3000")
  310. StaticRootPath = makeAbsolute(server.Key("static_root_path").String(), HomePath)
  311. RouterLogging = server.Key("router_logging").MustBool(false)
  312. EnableGzip = server.Key("enable_gzip").MustBool(false)
  313. EnforceDomain = server.Key("enforce_domain").MustBool(false)
  314. // read security settings
  315. security := Cfg.Section("security")
  316. SecretKey = security.Key("secret_key").String()
  317. LogInRememberDays = security.Key("login_remember_days").MustInt()
  318. CookieUserName = security.Key("cookie_username").String()
  319. CookieRememberName = security.Key("cookie_remember_name").String()
  320. DisableGravatar = security.Key("disable_gravatar").MustBool(true)
  321. // read data source proxy white list
  322. DataProxyWhiteList = make(map[string]bool)
  323. for _, hostAndIp := range security.Key("data_source_proxy_whitelist").Strings(" ") {
  324. DataProxyWhiteList[hostAndIp] = true
  325. }
  326. // admin
  327. AdminUser = security.Key("admin_user").String()
  328. AdminPassword = security.Key("admin_password").String()
  329. users := Cfg.Section("users")
  330. AllowUserSignUp = users.Key("allow_sign_up").MustBool(true)
  331. AllowUserOrgCreate = users.Key("allow_org_create").MustBool(true)
  332. AutoAssignOrg = users.Key("auto_assign_org").MustBool(true)
  333. AutoAssignOrgRole = users.Key("auto_assign_org_role").In("Editor", []string{"Editor", "Admin", "Read Only Editor", "Viewer"})
  334. VerifyEmailEnabled = users.Key("verify_email_enabled").MustBool(false)
  335. // anonymous access
  336. AnonymousEnabled = Cfg.Section("auth.anonymous").Key("enabled").MustBool(false)
  337. AnonymousOrgName = Cfg.Section("auth.anonymous").Key("org_name").String()
  338. AnonymousOrgRole = Cfg.Section("auth.anonymous").Key("org_role").String()
  339. // auth proxy
  340. authProxy := Cfg.Section("auth.proxy")
  341. AuthProxyEnabled = authProxy.Key("enabled").MustBool(false)
  342. AuthProxyHeaderName = authProxy.Key("header_name").String()
  343. AuthProxyHeaderProperty = authProxy.Key("header_property").String()
  344. AuthProxyAutoSignUp = authProxy.Key("auto_sign_up").MustBool(true)
  345. authBasic := Cfg.Section("auth.basic")
  346. BasicAuthEnabled = authBasic.Key("enabled").MustBool(true)
  347. // PhantomJS rendering
  348. ImagesDir = filepath.Join(DataPath, "png")
  349. PhantomDir = filepath.Join(HomePath, "vendor/phantomjs")
  350. analytics := Cfg.Section("analytics")
  351. ReportingEnabled = analytics.Key("reporting_enabled").MustBool(true)
  352. GoogleAnalyticsId = analytics.Key("google_analytics_ua_id").String()
  353. GoogleTagManagerId = analytics.Key("google_tag_manager_id").String()
  354. ldapSec := Cfg.Section("auth.ldap")
  355. LdapEnabled = ldapSec.Key("enabled").MustBool(false)
  356. LdapConfigFile = ldapSec.Key("config_file").String()
  357. readSessionConfig()
  358. readSmtpSettings()
  359. if VerifyEmailEnabled && !Smtp.Enabled {
  360. log.Warn("require_email_validation is enabled but smpt is disabled")
  361. }
  362. }
  363. func readSessionConfig() {
  364. sec := Cfg.Section("session")
  365. SessionOptions = session.Options{}
  366. SessionOptions.Provider = sec.Key("provider").In("memory", []string{"memory", "file", "redis", "mysql", "postgres"})
  367. SessionOptions.ProviderConfig = strings.Trim(sec.Key("provider_config").String(), "\" ")
  368. SessionOptions.CookieName = sec.Key("cookie_name").MustString("grafana_sess")
  369. SessionOptions.CookiePath = AppSubUrl
  370. SessionOptions.Secure = sec.Key("cookie_secure").MustBool()
  371. SessionOptions.Gclifetime = Cfg.Section("session").Key("gc_interval_time").MustInt64(86400)
  372. SessionOptions.Maxlifetime = Cfg.Section("session").Key("session_life_time").MustInt64(86400)
  373. SessionOptions.IDLength = 16
  374. if SessionOptions.Provider == "file" {
  375. SessionOptions.ProviderConfig = makeAbsolute(SessionOptions.ProviderConfig, DataPath)
  376. os.MkdirAll(path.Dir(SessionOptions.ProviderConfig), os.ModePerm)
  377. }
  378. if SessionOptions.CookiePath == "" {
  379. SessionOptions.CookiePath = "/"
  380. }
  381. }
  382. var logLevels = map[string]int{
  383. "Trace": 0,
  384. "Debug": 1,
  385. "Info": 2,
  386. "Warn": 3,
  387. "Error": 4,
  388. "Critical": 5,
  389. }
  390. func initLogging(args *CommandLineArgs) {
  391. //close any existing log handlers.
  392. log.Close()
  393. // Get and check log mode.
  394. LogModes = strings.Split(Cfg.Section("log").Key("mode").MustString("console"), ",")
  395. LogsPath = makeAbsolute(Cfg.Section("paths").Key("logs").String(), HomePath)
  396. LogConfigs = make([]util.DynMap, len(LogModes))
  397. for i, mode := range LogModes {
  398. mode = strings.TrimSpace(mode)
  399. sec, err := Cfg.GetSection("log." + mode)
  400. if err != nil {
  401. log.Fatal(4, "Unknown log mode: %s", mode)
  402. }
  403. // Log level.
  404. levelName := Cfg.Section("log."+mode).Key("level").In("Trace",
  405. []string{"Trace", "Debug", "Info", "Warn", "Error", "Critical"})
  406. level, ok := logLevels[levelName]
  407. if !ok {
  408. log.Fatal(4, "Unknown log level: %s", levelName)
  409. }
  410. // Generate log configuration.
  411. switch mode {
  412. case "console":
  413. LogConfigs[i] = util.DynMap{"level": level}
  414. case "file":
  415. logPath := sec.Key("file_name").MustString(filepath.Join(LogsPath, "grafana.log"))
  416. os.MkdirAll(filepath.Dir(logPath), os.ModePerm)
  417. LogConfigs[i] = util.DynMap{
  418. "level": level,
  419. "filename": logPath,
  420. "rotate": sec.Key("log_rotate").MustBool(true),
  421. "maxlines": sec.Key("max_lines").MustInt(1000000),
  422. "maxsize": 1 << uint(sec.Key("max_size_shift").MustInt(28)),
  423. "daily": sec.Key("daily_rotate").MustBool(true),
  424. "maxdays": sec.Key("max_days").MustInt(7),
  425. }
  426. case "conn":
  427. LogConfigs[i] = util.DynMap{
  428. "level": level,
  429. "reconnectOnMsg": sec.Key("reconnect_on_msg").MustBool(),
  430. "reconnect": sec.Key("reconnect").MustBool(),
  431. "net": sec.Key("protocol").In("tcp", []string{"tcp", "unix", "udp"}),
  432. "addr": sec.Key("addr").MustString(":7020"),
  433. }
  434. case "smtp":
  435. LogConfigs[i] = util.DynMap{
  436. "level": level,
  437. "user": sec.Key("user").MustString("example@example.com"),
  438. "passwd": sec.Key("passwd").MustString("******"),
  439. "host": sec.Key("host").MustString("127.0.0.1:25"),
  440. "receivers": sec.Key("receivers").MustString("[]"),
  441. "subject": sec.Key("subject").MustString("Diagnostic message from serve"),
  442. }
  443. case "database":
  444. LogConfigs[i] = util.DynMap{
  445. "level": level,
  446. "driver": sec.Key("driver").String(),
  447. "conn": sec.Key("conn").String(),
  448. }
  449. }
  450. cfgJsonBytes, _ := json.Marshal(LogConfigs[i])
  451. log.NewLogger(Cfg.Section("log").Key("buffer_len").MustInt64(10000), mode, string(cfgJsonBytes))
  452. }
  453. }
  454. func LogConfigurationInfo() {
  455. var text bytes.Buffer
  456. text.WriteString("Configuration Info\n")
  457. text.WriteString("Config files:\n")
  458. for i, file := range configFiles {
  459. text.WriteString(fmt.Sprintf(" [%d]: %s\n", i, file))
  460. }
  461. if len(appliedCommandLineProperties) > 0 {
  462. text.WriteString("Command lines overrides:\n")
  463. for i, prop := range appliedCommandLineProperties {
  464. text.WriteString(fmt.Sprintf(" [%d]: %s\n", i, prop))
  465. }
  466. }
  467. if len(appliedEnvOverrides) > 0 {
  468. text.WriteString("\tEnvironment variables used:\n")
  469. for i, prop := range appliedEnvOverrides {
  470. text.WriteString(fmt.Sprintf(" [%d]: %s\n", i, prop))
  471. }
  472. }
  473. text.WriteString("Paths:\n")
  474. text.WriteString(fmt.Sprintf(" home: %s\n", HomePath))
  475. text.WriteString(fmt.Sprintf(" data: %s\n", DataPath))
  476. text.WriteString(fmt.Sprintf(" logs: %s\n", LogsPath))
  477. log.Info(text.String())
  478. }