setting.go 15 KB

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