dashboard.go 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490
  1. package api
  2. import (
  3. "encoding/json"
  4. "fmt"
  5. "os"
  6. "path"
  7. "github.com/grafana/grafana/pkg/services/dashboards"
  8. "github.com/grafana/grafana/pkg/api/dtos"
  9. "github.com/grafana/grafana/pkg/bus"
  10. "github.com/grafana/grafana/pkg/components/dashdiffs"
  11. "github.com/grafana/grafana/pkg/components/simplejson"
  12. "github.com/grafana/grafana/pkg/log"
  13. "github.com/grafana/grafana/pkg/metrics"
  14. "github.com/grafana/grafana/pkg/middleware"
  15. m "github.com/grafana/grafana/pkg/models"
  16. "github.com/grafana/grafana/pkg/plugins"
  17. "github.com/grafana/grafana/pkg/services/guardian"
  18. "github.com/grafana/grafana/pkg/setting"
  19. "github.com/grafana/grafana/pkg/util"
  20. )
  21. func isDashboardStarredByUser(c *middleware.Context, dashId int64) (bool, error) {
  22. if !c.IsSignedIn {
  23. return false, nil
  24. }
  25. query := m.IsStarredByUserQuery{UserId: c.UserId, DashboardId: dashId}
  26. if err := bus.Dispatch(&query); err != nil {
  27. return false, err
  28. }
  29. return query.Result, nil
  30. }
  31. func dashboardGuardianResponse(err error) Response {
  32. if err != nil {
  33. return ApiError(500, "Error while checking dashboard permissions", err)
  34. } else {
  35. return ApiError(403, "Access denied to this dashboard", nil)
  36. }
  37. }
  38. func GetDashboard(c *middleware.Context) Response {
  39. dash, rsp := getDashboardHelper(c.OrgId, c.Params(":slug"), 0, c.Params(":uid"))
  40. if rsp != nil {
  41. return rsp
  42. }
  43. guardian := guardian.NewDashboardGuardian(dash.Id, c.OrgId, c.SignedInUser)
  44. if canView, err := guardian.CanView(); err != nil || !canView {
  45. fmt.Printf("%v", err)
  46. return dashboardGuardianResponse(err)
  47. }
  48. canEdit, _ := guardian.CanEdit()
  49. canSave, _ := guardian.CanSave()
  50. canAdmin, _ := guardian.CanAdmin()
  51. isStarred, err := isDashboardStarredByUser(c, dash.Id)
  52. if err != nil {
  53. return ApiError(500, "Error while checking if dashboard was starred by user", err)
  54. }
  55. // Finding creator and last updater of the dashboard
  56. updater, creator := "Anonymous", "Anonymous"
  57. if dash.UpdatedBy > 0 {
  58. updater = getUserLogin(dash.UpdatedBy)
  59. }
  60. if dash.CreatedBy > 0 {
  61. creator = getUserLogin(dash.CreatedBy)
  62. }
  63. meta := dtos.DashboardMeta{
  64. IsStarred: isStarred,
  65. Slug: dash.Slug,
  66. Type: m.DashTypeDB,
  67. CanStar: c.IsSignedIn,
  68. CanSave: canSave,
  69. CanEdit: canEdit,
  70. CanAdmin: canAdmin,
  71. Created: dash.Created,
  72. Updated: dash.Updated,
  73. UpdatedBy: updater,
  74. CreatedBy: creator,
  75. Version: dash.Version,
  76. HasAcl: dash.HasAcl,
  77. IsFolder: dash.IsFolder,
  78. FolderId: dash.FolderId,
  79. FolderTitle: "Root",
  80. }
  81. // lookup folder title
  82. if dash.FolderId > 0 {
  83. query := m.GetDashboardQuery{Id: dash.FolderId, OrgId: c.OrgId}
  84. if err := bus.Dispatch(&query); err != nil {
  85. return ApiError(500, "Dashboard folder could not be read", err)
  86. }
  87. meta.FolderTitle = query.Result.Title
  88. }
  89. if dash.IsFolder {
  90. meta.Url = m.GetFolderUrl(dash.Uid, dash.Slug)
  91. } else {
  92. meta.Url = m.GetDashboardUrl(dash.Uid, dash.Slug)
  93. }
  94. // make sure db version is in sync with json model version
  95. dash.Data.Set("version", dash.Version)
  96. dto := dtos.DashboardFullWithMeta{
  97. Dashboard: dash.Data,
  98. Meta: meta,
  99. }
  100. c.TimeRequest(metrics.M_Api_Dashboard_Get)
  101. return Json(200, dto)
  102. }
  103. func getUserLogin(userId int64) string {
  104. query := m.GetUserByIdQuery{Id: userId}
  105. err := bus.Dispatch(&query)
  106. if err != nil {
  107. return "Anonymous"
  108. } else {
  109. user := query.Result
  110. return user.Login
  111. }
  112. }
  113. func getDashboardHelper(orgId int64, slug string, id int64, uid string) (*m.Dashboard, Response) {
  114. var query m.GetDashboardQuery
  115. if len(uid) > 0 {
  116. query = m.GetDashboardQuery{Uid: uid, Id: id, OrgId: orgId}
  117. } else {
  118. query = m.GetDashboardQuery{Slug: slug, Id: id, OrgId: orgId}
  119. }
  120. if err := bus.Dispatch(&query); err != nil {
  121. return nil, ApiError(404, "Dashboard not found", err)
  122. }
  123. return query.Result, nil
  124. }
  125. func DeleteDashboard(c *middleware.Context) Response {
  126. query := m.GetDashboardsBySlugQuery{OrgId: c.OrgId, Slug: c.Params(":slug")}
  127. if err := bus.Dispatch(&query); err != nil {
  128. return ApiError(500, "Failed to retrieve dashboards by slug", err)
  129. }
  130. if len(query.Result) > 1 {
  131. return Json(412, util.DynMap{"status": "multiple-slugs-exists", "message": m.ErrDashboardsWithSameSlugExists.Error()})
  132. }
  133. dash, rsp := getDashboardHelper(c.OrgId, c.Params(":slug"), 0, "")
  134. if rsp != nil {
  135. return rsp
  136. }
  137. guardian := guardian.NewDashboardGuardian(dash.Id, c.OrgId, c.SignedInUser)
  138. if canSave, err := guardian.CanSave(); err != nil || !canSave {
  139. return dashboardGuardianResponse(err)
  140. }
  141. cmd := m.DeleteDashboardCommand{OrgId: c.OrgId, Id: dash.Id}
  142. if err := bus.Dispatch(&cmd); err != nil {
  143. return ApiError(500, "Failed to delete dashboard", err)
  144. }
  145. var resp = map[string]interface{}{"title": dash.Title}
  146. return Json(200, resp)
  147. }
  148. func DeleteDashboardByUid(c *middleware.Context) Response {
  149. dash, rsp := getDashboardHelper(c.OrgId, "", 0, c.Params(":uid"))
  150. if rsp != nil {
  151. return rsp
  152. }
  153. guardian := guardian.NewDashboardGuardian(dash.Id, c.OrgId, c.SignedInUser)
  154. if canSave, err := guardian.CanSave(); err != nil || !canSave {
  155. return dashboardGuardianResponse(err)
  156. }
  157. cmd := m.DeleteDashboardCommand{OrgId: c.OrgId, Id: dash.Id}
  158. if err := bus.Dispatch(&cmd); err != nil {
  159. return ApiError(500, "Failed to delete dashboard", err)
  160. }
  161. var resp = map[string]interface{}{"title": dash.Title}
  162. return Json(200, resp)
  163. }
  164. func PostDashboard(c *middleware.Context, cmd m.SaveDashboardCommand) Response {
  165. cmd.OrgId = c.OrgId
  166. cmd.UserId = c.UserId
  167. dash := cmd.GetDashboardModel()
  168. guardian := guardian.NewDashboardGuardian(dash.Id, c.OrgId, c.SignedInUser)
  169. if canSave, err := guardian.CanSave(); err != nil || !canSave {
  170. return dashboardGuardianResponse(err)
  171. }
  172. if dash.IsFolder && dash.FolderId > 0 {
  173. return ApiError(400, m.ErrDashboardFolderCannotHaveParent.Error(), nil)
  174. }
  175. // Check if Title is empty
  176. if dash.Title == "" {
  177. return ApiError(400, m.ErrDashboardTitleEmpty.Error(), nil)
  178. }
  179. if dash.Id == 0 {
  180. limitReached, err := middleware.QuotaReached(c, "dashboard")
  181. if err != nil {
  182. return ApiError(500, "failed to get quota", err)
  183. }
  184. if limitReached {
  185. return ApiError(403, "Quota reached", nil)
  186. }
  187. }
  188. dashItem := &dashboards.SaveDashboardItem{
  189. Dashboard: dash,
  190. Message: cmd.Message,
  191. OrgId: c.OrgId,
  192. UserId: c.UserId,
  193. Overwrite: cmd.Overwrite,
  194. }
  195. dashboard, err := dashboards.GetRepository().SaveDashboard(dashItem)
  196. if err == m.ErrDashboardTitleEmpty {
  197. return ApiError(400, m.ErrDashboardTitleEmpty.Error(), nil)
  198. }
  199. if err == m.ErrDashboardContainsInvalidAlertData {
  200. return ApiError(500, "Invalid alert data. Cannot save dashboard", err)
  201. }
  202. if err != nil {
  203. if err == m.ErrDashboardWithSameNameExists {
  204. return Json(412, util.DynMap{"status": "name-exists", "message": err.Error()})
  205. }
  206. if err == m.ErrDashboardVersionMismatch {
  207. return Json(412, util.DynMap{"status": "version-mismatch", "message": err.Error()})
  208. }
  209. if pluginErr, ok := err.(m.UpdatePluginDashboardError); ok {
  210. message := "The dashboard belongs to plugin " + pluginErr.PluginId + "."
  211. // look up plugin name
  212. if pluginDef, exist := plugins.Plugins[pluginErr.PluginId]; exist {
  213. message = "The dashboard belongs to plugin " + pluginDef.Name + "."
  214. }
  215. return Json(412, util.DynMap{"status": "plugin-dashboard", "message": message})
  216. }
  217. if err == m.ErrDashboardNotFound {
  218. return Json(404, util.DynMap{"status": "not-found", "message": err.Error()})
  219. }
  220. return ApiError(500, "Failed to save dashboard", err)
  221. }
  222. if err == m.ErrDashboardFailedToUpdateAlertData {
  223. return ApiError(500, "Invalid alert data. Cannot save dashboard", err)
  224. }
  225. var url string
  226. if dash.IsFolder {
  227. url = m.GetFolderUrl(dashboard.Uid, dashboard.Slug)
  228. } else {
  229. url = m.GetDashboardUrl(dashboard.Uid, dashboard.Slug)
  230. }
  231. c.TimeRequest(metrics.M_Api_Dashboard_Save)
  232. return Json(200, util.DynMap{
  233. "status": "success",
  234. "slug": dashboard.Slug,
  235. "version": dashboard.Version,
  236. "id": dashboard.Id,
  237. "uid": dashboard.Uid,
  238. "url": url,
  239. })
  240. }
  241. func GetHomeDashboard(c *middleware.Context) Response {
  242. prefsQuery := m.GetPreferencesWithDefaultsQuery{OrgId: c.OrgId, UserId: c.UserId}
  243. if err := bus.Dispatch(&prefsQuery); err != nil {
  244. return ApiError(500, "Failed to get preferences", err)
  245. }
  246. if prefsQuery.Result.HomeDashboardId != 0 {
  247. slugQuery := m.GetDashboardSlugByIdQuery{Id: prefsQuery.Result.HomeDashboardId}
  248. err := bus.Dispatch(&slugQuery)
  249. if err == nil {
  250. dashRedirect := dtos.DashboardRedirect{RedirectUri: "db/" + slugQuery.Result}
  251. return Json(200, &dashRedirect)
  252. } else {
  253. log.Warn("Failed to get slug from database, %s", err.Error())
  254. }
  255. }
  256. filePath := path.Join(setting.StaticRootPath, "dashboards/home.json")
  257. file, err := os.Open(filePath)
  258. if err != nil {
  259. return ApiError(500, "Failed to load home dashboard", err)
  260. }
  261. dash := dtos.DashboardFullWithMeta{}
  262. dash.Meta.IsHome = true
  263. dash.Meta.CanEdit = c.SignedInUser.HasRole(m.ROLE_EDITOR)
  264. dash.Meta.FolderTitle = "Root"
  265. jsonParser := json.NewDecoder(file)
  266. if err := jsonParser.Decode(&dash.Dashboard); err != nil {
  267. return ApiError(500, "Failed to load home dashboard", err)
  268. }
  269. if c.HasUserRole(m.ROLE_ADMIN) && !c.HasHelpFlag(m.HelpFlagGettingStartedPanelDismissed) {
  270. addGettingStartedPanelToHomeDashboard(dash.Dashboard)
  271. }
  272. return Json(200, &dash)
  273. }
  274. func addGettingStartedPanelToHomeDashboard(dash *simplejson.Json) {
  275. panels := dash.Get("panels").MustArray()
  276. newpanel := simplejson.NewFromAny(map[string]interface{}{
  277. "type": "gettingstarted",
  278. "id": 123123,
  279. "gridPos": map[string]interface{}{
  280. "x": 0,
  281. "y": 3,
  282. "w": 24,
  283. "h": 4,
  284. },
  285. })
  286. panels = append(panels, newpanel)
  287. dash.Set("panels", panels)
  288. }
  289. // GetDashboardVersions returns all dashboard versions as JSON
  290. func GetDashboardVersions(c *middleware.Context) Response {
  291. dashId := c.ParamsInt64(":dashboardId")
  292. guardian := guardian.NewDashboardGuardian(dashId, c.OrgId, c.SignedInUser)
  293. if canSave, err := guardian.CanSave(); err != nil || !canSave {
  294. return dashboardGuardianResponse(err)
  295. }
  296. query := m.GetDashboardVersionsQuery{
  297. OrgId: c.OrgId,
  298. DashboardId: dashId,
  299. Limit: c.QueryInt("limit"),
  300. Start: c.QueryInt("start"),
  301. }
  302. if err := bus.Dispatch(&query); err != nil {
  303. return ApiError(404, fmt.Sprintf("No versions found for dashboardId %d", dashId), err)
  304. }
  305. for _, version := range query.Result {
  306. if version.RestoredFrom == version.Version {
  307. version.Message = "Initial save (created by migration)"
  308. continue
  309. }
  310. if version.RestoredFrom > 0 {
  311. version.Message = fmt.Sprintf("Restored from version %d", version.RestoredFrom)
  312. continue
  313. }
  314. if version.ParentVersion == 0 {
  315. version.Message = "Initial save"
  316. }
  317. }
  318. return Json(200, query.Result)
  319. }
  320. // GetDashboardVersion returns the dashboard version with the given ID.
  321. func GetDashboardVersion(c *middleware.Context) Response {
  322. dashId := c.ParamsInt64(":dashboardId")
  323. guardian := guardian.NewDashboardGuardian(dashId, c.OrgId, c.SignedInUser)
  324. if canSave, err := guardian.CanSave(); err != nil || !canSave {
  325. return dashboardGuardianResponse(err)
  326. }
  327. query := m.GetDashboardVersionQuery{
  328. OrgId: c.OrgId,
  329. DashboardId: dashId,
  330. Version: c.ParamsInt(":id"),
  331. }
  332. if err := bus.Dispatch(&query); err != nil {
  333. return ApiError(500, fmt.Sprintf("Dashboard version %d not found for dashboardId %d", query.Version, dashId), err)
  334. }
  335. creator := "Anonymous"
  336. if query.Result.CreatedBy > 0 {
  337. creator = getUserLogin(query.Result.CreatedBy)
  338. }
  339. dashVersionMeta := &m.DashboardVersionMeta{
  340. DashboardVersion: *query.Result,
  341. CreatedBy: creator,
  342. }
  343. return Json(200, dashVersionMeta)
  344. }
  345. // POST /api/dashboards/calculate-diff performs diffs on two dashboards
  346. func CalculateDashboardDiff(c *middleware.Context, apiOptions dtos.CalculateDiffOptions) Response {
  347. options := dashdiffs.Options{
  348. OrgId: c.OrgId,
  349. DiffType: dashdiffs.ParseDiffType(apiOptions.DiffType),
  350. Base: dashdiffs.DiffTarget{
  351. DashboardId: apiOptions.Base.DashboardId,
  352. Version: apiOptions.Base.Version,
  353. UnsavedDashboard: apiOptions.Base.UnsavedDashboard,
  354. },
  355. New: dashdiffs.DiffTarget{
  356. DashboardId: apiOptions.New.DashboardId,
  357. Version: apiOptions.New.Version,
  358. UnsavedDashboard: apiOptions.New.UnsavedDashboard,
  359. },
  360. }
  361. result, err := dashdiffs.CalculateDiff(&options)
  362. if err != nil {
  363. if err == m.ErrDashboardVersionNotFound {
  364. return ApiError(404, "Dashboard version not found", err)
  365. }
  366. return ApiError(500, "Unable to compute diff", err)
  367. }
  368. if options.DiffType == dashdiffs.DiffDelta {
  369. return Respond(200, result.Delta).Header("Content-Type", "application/json")
  370. } else {
  371. return Respond(200, result.Delta).Header("Content-Type", "text/html")
  372. }
  373. }
  374. // RestoreDashboardVersion restores a dashboard to the given version.
  375. func RestoreDashboardVersion(c *middleware.Context, apiCmd dtos.RestoreDashboardVersionCommand) Response {
  376. dash, rsp := getDashboardHelper(c.OrgId, "", c.ParamsInt64(":dashboardId"), "")
  377. if rsp != nil {
  378. return rsp
  379. }
  380. guardian := guardian.NewDashboardGuardian(dash.Id, c.OrgId, c.SignedInUser)
  381. if canSave, err := guardian.CanSave(); err != nil || !canSave {
  382. return dashboardGuardianResponse(err)
  383. }
  384. versionQuery := m.GetDashboardVersionQuery{DashboardId: dash.Id, Version: apiCmd.Version, OrgId: c.OrgId}
  385. if err := bus.Dispatch(&versionQuery); err != nil {
  386. return ApiError(404, "Dashboard version not found", nil)
  387. }
  388. version := versionQuery.Result
  389. saveCmd := m.SaveDashboardCommand{}
  390. saveCmd.RestoredFrom = version.Version
  391. saveCmd.OrgId = c.OrgId
  392. saveCmd.UserId = c.UserId
  393. saveCmd.Dashboard = version.Data
  394. saveCmd.Dashboard.Set("version", dash.Version)
  395. saveCmd.Message = fmt.Sprintf("Restored from version %d", version.Version)
  396. return PostDashboard(c, saveCmd)
  397. }
  398. func GetDashboardTags(c *middleware.Context) {
  399. query := m.GetDashboardTagsQuery{OrgId: c.OrgId}
  400. err := bus.Dispatch(&query)
  401. if err != nil {
  402. c.JsonApiErr(500, "Failed to get tags from database", err)
  403. return
  404. }
  405. c.JSON(200, query.Result)
  406. }