The open and composable observability and data visualization platform. Visualize metrics, logs, and traces from multiple sources like Prometheus, Loki, Elasticsearch, InfluxDB, Postgres and many more.
Go to file
bergquist 8573f73d72 Merge branch 'master' into backend_plugins
* master: (584 commits)
  prometheus: change default resolution to 1/1
  fix: viewers can edit now works correctly
  fix: fixed minor ux and firefox issues, fixes #10228
  ux: minor fixes
  profile: use name or fallback for profile page
  fix: sidemenu profile main text is now username instead of name
  build: update master version to 5.0.0-pre1
  dashfolder: change to migration text
  ux:s sidemenu icon rules
  teams: add team count when searching for team
  changed background color for infobox and new blues in light theme, light theme now uses blue-dark in panel query (#10211)
  ux: fixed navbar issue when sidemenu closes
  ux: minor position change for layout selector, fixes #10217
  fix: view json from share modal now works, #10217
  ux: used new add data sources icon
  dashfolders: styling of selected filters
  dashfolders: styling of selected filters
  dashfolders: fix moving plugin dashboard to folder
  changelog: adds note about closing #9170
  dashfolders: fix folder selection dropdown in dashboard settings
  ...
2017-12-15 14:34:55 +01:00
.github github: dont require bug/fr in title 2017-10-31 14:14:50 +01:00
conf Replace Read Only Editor role with ViewersCanEdit setting (#10166) 2017-12-13 18:53:42 +01:00
docker graphite: remove check so that query is sent even for possible non leaf nodes 2017-12-12 17:00:00 +01:00
docs docs: include all notifiers type 2017-12-14 14:45:17 +01:00
emails include error message in email notification (#8392) 2017-05-17 09:51:51 +02:00
examples update broken links (#6961) 2016-12-14 22:20:22 +01:00
packaging update version for packagecloud 2017-12-14 11:30:10 +01:00
pkg Merge branch 'master' into backend_plugins 2017-12-15 14:34:55 +01:00
public prometheus: change default resolution to 1/1 2017-12-15 14:24:31 +01:00
scripts Merge branch 'master' into develop 2017-12-12 13:19:07 +01:00
tasks/options Create annotations (#8197) 2017-10-07 10:31:39 +02:00
tests data source with token auth is starting to work, #9078 2017-08-24 11:07:37 +02:00
vendor add go-plugin deps to vendor 2017-12-07 16:33:36 +01:00
.bra.toml Webpack (#9391) 2017-10-01 20:02:25 +02:00
.editorconfig Reorder editorconfig 2017-08-24 13:40:19 +02:00
.gitignore Merge branch 'master' into develop 2017-12-12 13:19:07 +01:00
.jscs.json feat(import): things are starting to work 2016-05-13 11:26:02 +02:00
.jshintrc Webpack (#9391) 2017-10-01 20:02:25 +02:00
appveyor.yml tech: switch to golang 1.9.2 2017-10-31 12:36:52 +01:00
build.go formatting in build file 2017-11-29 11:15:27 +01:00
CHANGELOG.md Merge branch Grafana v5 'develop' branch 2017-12-15 12:06:09 +01:00
circle.yml tech: switch to golang 1.9.2 2017-10-31 12:36:52 +01:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md (#8960) 2017-07-31 17:31:05 +02:00
codecov.yml Update codecov.yml 2017-10-31 13:58:01 +01:00
Gruntfile.js [Tech]: Start migrating to Jest for tests (#9610) 2017-10-22 07:03:26 +02:00
jest.config.js fix: build & tests 2017-11-17 16:18:30 +01:00
karma.conf.js shore: minor cleanup 2017-10-01 20:35:01 +02:00
latest.json Update latest.json 2017-11-22 14:44:18 +01:00
LICENSE.md Update LICENSE.md 2017-11-24 09:11:10 +01:00
Makefile separate plugin impl and proto files 2017-12-07 16:33:36 +01:00
NOTICE.md Update NOTICE.md 2017-11-24 09:14:14 +01:00
package.json build: update master version to 5.0.0-pre1 2017-12-15 12:09:11 +01:00
PLUGIN_DEV.md fix typo 2017-10-17 01:10:40 +02:00
README.md hyphenhyphen 2017-12-10 18:38:48 +02:00
ROADMAP.md refactor: user groups to teams, replace rest mentions 2017-12-08 19:01:10 +03:00
tsconfig.json Create annotations (#8197) 2017-10-07 10:31:39 +02:00
tslint.json Merge branch 'master' into develop 2017-11-24 09:25:14 +01:00
yarn.lock tech: updated version for react-grid item 2017-12-12 13:27:56 +01:00

Grafana Circle CI Go Report Card codecov

Website | Twitter | Community & Forum

Grafana is an open source, feature rich metrics dashboard and graph editor for Graphite, Elasticsearch, OpenTSDB, Prometheus and InfluxDB.

Installation

Head to docs.grafana.org and download the latest release.

If you have any problems please read the troubleshooting guide.

Documentation & Support

Be sure to read the getting started guide and the other feature guides.

Run from master

If you want to build a package yourself, or contribute - Here is a guide for how to do that. You can always find the latest master builds here

Dependencies

  • Go 1.9
  • NodeJS LTS

Building the backend

go get github.com/grafana/grafana
cd ~/go/src/github.com/grafana/grafana
go run build.go setup
go run build.go build

Building frontend assets

For this you need nodejs (v.6+).

npm install -g yarn
yarn install --pure-lockfile
npm run build

To rebuild frontend assets (typescript, sass etc) as you change them start the watcher via.

npm run watch

Run tests

npm run test

Run tests in watch mode

npm run watch-test

Recompile backend on source change

To rebuild on source change.

go get github.com/Unknwon/bra
bra run

Open grafana in your browser (default: http://localhost:3000) and login with admin user (default: user/pass = admin/admin).

Dev config

Create a custom.ini in the conf directory to override default configuration options. You only need to add the options you want to override. Config files are applied in the order of:

  1. grafana.ini
  2. custom.ini

In your custom.ini uncomment (remove the leading ;) sign. And set app_mode = development.

Running tests

  • You can run backend Golang tests using "go test ./pkg/...".
  • Execute all frontend tests with "npm run test"

Writing & watching frontend tests (we have two test runners)

  • jest for all new tests that do not require browser context (React+more)
    • Start watcher: npm run jest
    • Jest will run all test files that end with the name ".jest.ts"
  • karma + mocha is used for testing angularjs components. We do want to migrate these test to jest over time (if possible).
    • Start watcher: npm run karma
    • Karma+Mocha runs all files that end with the name "_specs.ts".

Contribute

If you have any idea for an improvement or found a bug, do not hesitate to open an issue. And if you have time clone this repo and submit a pull request and help me make Grafana the kickass metrics & devops dashboard we all dream about!

Plugin development

Checkout the Plugin Development Guide and checkout the PLUGIN_DEV.md file for changes in Grafana that relate to plugin development.

License

Grafana is distributed under Apache 2.0 License.