grafana

command module

v2.0.0-beta1+incompatible Latest Latest Go to latest Published: Mar 30, 2015 License: Apache-2.0 Imports: 8 Imported by: 0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/wujiang/grafana

README ¶

Grafana ![Gitter](https://badges.gitter.im/Join Chat.svg)

Website | Twitter | IRC | Email

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

Grafana 2.0

The develop branch has now been merged with master. For 1.9 users this is a big change as Grafana is no longer a standalone frontend only web application. Grafana 2.0 comes with a backend.

Features

Graphite Target Editor

Graphite target expression parser
Feature rich query composer
Quickly add and edit functions & parameters
Templated queries
See it in action

Graphing

Fast rendering, even over large timespans
Click and drag to zoom
Multiple Y-axis, logarithmic scales
Bars, Lines, Points
Smart Y-axis formating
Series toggles & color selector
Legend values, and formatting options
Grid thresholds, axis labels
Annotations
Any panel can be rendered to PNG (server side using phantomjs)

Dashboards

Create, edit, save & search dashboards
Change column spans and row heights
Drag and drop panels to rearrange
Templating
Scripted dashboards
Dashboard playlists
Time range controls
Share snapshots publicly

InfluxDB

Use InfluxDB as a metric data source, annotation source
Query editor with series and column typeahead, easy group by and function selection

OpenTSDB

Use as metric data source
Query editor with metric name typeahead and tag filtering

Requirements

There are no dependencies except an external time series data store. For dashboards and user accounts Grafana can use an embedded database (sqlite3) or you can use an external SQL data base like MySQL or Postgres.

Installation

Head to 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 your self, or contribute. Here is a guide for how to do that. You can always find the latest master builds here

Dependencies

Go 1.4
NodeJS

Get Code

go get github.com/grafana/grafana

Building the backend

cd $GOPATH/src/github.com/grafana/grafana
go run build.go setup            (only needed once to install godep)
godep restore                    (will pull down all golang lib dependecies in your current GOPATH)
go build .

Building frontend assets

To build less to css for the frontend you will need a recent version of of node (v0.12.0), npm (v2.5.0) and grunt (v0.4.5). Run the following:

npm install
npm install -g grunt-cli
grunt

Recompile backend on source change

To rebuild on source change (requires that you executed godep restore)

go get github.com/Unknwon/bra
bra run

Running

./grafana web

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:

grafana.ini
dev.ini (if found)
custom.ini

Create a pull requests

Before or after your create a pull requests, sign the contributor license aggrement.## 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!

Before creating a pull request be sure that "grunt test" runs without any style or unit test errors, also please sign the CLA

License

Grafana is distributed under Apache 2.0 License. Work in progress Grafana 2.0 (with included Grafana backend)

Documentation ¶

There is no documentation for this package.

Source Files ¶

View all Source files

main.go

Directories ¶

Path	Synopsis
Godeps
_workspace/src/github.com/Unknwon/com Package com is an open source project for commonly used functions for the Go programming language.	Package com is an open source project for commonly used functions for the Go programming language.
_workspace/src/github.com/Unknwon/macaron Package macaron is a high productive and modular design web framework in Go.	Package macaron is a high productive and modular design web framework in Go.
_workspace/src/github.com/Unknwon/macaron/inject Package inject provides utilities for mapping and injecting dependencies in various ways.	Package inject provides utilities for mapping and injecting dependencies in various ways.
_workspace/src/github.com/codegangsta/cli Package cli provides a minimal framework for creating and organizing command line Go applications.	Package cli provides a minimal framework for creating and organizing command line Go applications.
_workspace/src/github.com/go-sql-driver/mysql Go MySQL Driver - A MySQL-Driver for Go's database/sql package	Go MySQL Driver - A MySQL-Driver for Go's database/sql package
_workspace/src/github.com/go-xorm/core
_workspace/src/github.com/go-xorm/xorm Package xorm is a simple and powerful ORM for Go.	Package xorm is a simple and powerful ORM for Go.
_workspace/src/github.com/go-xorm/xorm/examples
_workspace/src/github.com/jtolds/gls Package gls implements goroutine-local storage.	Package gls implements goroutine-local storage.
_workspace/src/github.com/lib/pq Package pq is a pure Go Postgres driver for the database/sql package.	Package pq is a pure Go Postgres driver for the database/sql package.
_workspace/src/github.com/lib/pq/hstore
_workspace/src/github.com/lib/pq/listen_example Below you will find a self-contained Go program which uses the LISTEN / NOTIFY mechanism to avoid polling the database while waiting for more work to arrive.	Below you will find a self-contained Go program which uses the LISTEN / NOTIFY mechanism to avoid polling the database while waiting for more work to arrive.
_workspace/src/github.com/lib/pq/oid Package oid contains OID constants as defined by the Postgres server.	Package oid contains OID constants as defined by the Postgres server.
_workspace/src/github.com/macaron-contrib/binding Package binding is a middleware that provides request data binding and validation for Macaron.	Package binding is a middleware that provides request data binding and validation for Macaron.
_workspace/src/github.com/macaron-contrib/session Package session a middleware that provides the session manager of Macaron.	Package session a middleware that provides the session manager of Macaron.
_workspace/src/github.com/macaron-contrib/session/couchbase
_workspace/src/github.com/macaron-contrib/session/ledis
_workspace/src/github.com/macaron-contrib/session/memcache
_workspace/src/github.com/macaron-contrib/session/mysql
_workspace/src/github.com/macaron-contrib/session/postgres
_workspace/src/github.com/macaron-contrib/session/redis
_workspace/src/github.com/mattn/go-sqlite3 Package sqlite3 provides interface to SQLite3 databases.	Package sqlite3 provides interface to SQLite3 databases.
_workspace/src/github.com/mattn/go-sqlite3/sqlite3_test
_workspace/src/github.com/smartystreets/goconvey/convey Package convey contains all of the public-facing entry points to this project.	Package convey contains all of the public-facing entry points to this project.
_workspace/src/github.com/smartystreets/goconvey/convey/assertions Package assertions contains the implementations for all assertions which are referenced in the convey package for use with the So(...) method.	Package assertions contains the implementations for all assertions which are referenced in the convey package for use with the So(...) method.
_workspace/src/github.com/smartystreets/goconvey/convey/assertions/oglematchers Package oglematchers provides a set of matchers useful in a testing or mocking framework.	Package oglematchers provides a set of matchers useful in a testing or mocking framework.
_workspace/src/github.com/smartystreets/goconvey/convey/assertions/oglemock
_workspace/src/github.com/smartystreets/goconvey/convey/assertions/oglemock/createmock createmock is used to generate source code for mock versions of interfaces from installed packages.	createmock is used to generate source code for mock versions of interfaces from installed packages.
_workspace/src/github.com/smartystreets/goconvey/convey/assertions/oglemock/generate Package generate implements code generation for mock classes.	Package generate implements code generation for mock classes.
_workspace/src/github.com/smartystreets/goconvey/convey/assertions/oglemock/generate/test_cases
_workspace/src/github.com/smartystreets/goconvey/convey/assertions/oglemock/generate/test_cases/complicated_pkg Package complicated_pkg contains an interface with lots of interesting cases, for use in integration testing.	Package complicated_pkg contains an interface with lots of interesting cases, for use in integration testing.
_workspace/src/github.com/smartystreets/goconvey/convey/assertions/oglemock/generate/test_cases/renamed_pkg A package that calls itself something different than its package path would have you believe.	A package that calls itself something different than its package path would have you believe.
_workspace/src/github.com/smartystreets/goconvey/convey/assertions/oglemock/sample/mock_io
_workspace/src/github.com/smartystreets/goconvey/convey/assertions/ogletest Package ogletest provides a framework for writing expressive unit tests.	Package ogletest provides a framework for writing expressive unit tests.
_workspace/src/github.com/smartystreets/goconvey/convey/assertions/ogletest/test_cases
_workspace/src/github.com/smartystreets/goconvey/convey/assertions/ogletest/test_cases/mock_image
_workspace/src/github.com/smartystreets/goconvey/convey/gotest Package gotest contains internal functionality.	Package gotest contains internal functionality.
_workspace/src/github.com/smartystreets/goconvey/convey/reporting Package reporting contains internal functionality related to console reporting and output.	Package reporting contains internal functionality related to console reporting and output.
_workspace/src/github.com/streadway/amqp AMQP 0.9.1 client with RabbitMQ extensions	AMQP 0.9.1 client with RabbitMQ extensions
_workspace/src/golang.org/x/net/context Package context defines the Context type, which carries deadlines, cancelation signals, and other request-scoped values across API boundaries and between processes.	Package context defines the Context type, which carries deadlines, cancelation signals, and other request-scoped values across API boundaries and between processes.
_workspace/src/golang.org/x/oauth2 Package oauth2 provides support for making OAuth2 authorized and authenticated HTTP requests.	Package oauth2 provides support for making OAuth2 authorized and authenticated HTTP requests.
_workspace/src/golang.org/x/oauth2/github Package github provides constants for using OAuth2 to access Github.	Package github provides constants for using OAuth2 to access Github.
_workspace/src/golang.org/x/oauth2/google Package google provides support for making OAuth2 authorized and authenticated HTTP requests to Google APIs.	Package google provides support for making OAuth2 authorized and authenticated HTTP requests to Google APIs.
_workspace/src/golang.org/x/oauth2/internal Package internal contains support packages for oauth2 package.	Package internal contains support packages for oauth2 package.
_workspace/src/golang.org/x/oauth2/jws Package jws provides encoding and decoding utilities for signed JWS messages.	Package jws provides encoding and decoding utilities for signed JWS messages.
_workspace/src/gopkg.in/ini.v1 Package ini provides INI file read and write functionality in Go.	Package ini provides INI file read and write functionality in Go.
pkg
api
api/dtos
api/static
bus
cmd
components/apikeygen
components/renderer
events
log
metrics
middleware
models
plugins
services/eventpublisher
services/sqlstore
services/sqlstore/migrations
services/sqlstore/migrator
services/sqlstore/sqlutil
setting
social
util

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL