Skip to content

Commit 3d0ae62

Browse files
committed
updated readme
1 parent 38caeb3 commit 3d0ae62

File tree

1 file changed

+80
-2
lines changed

1 file changed

+80
-2
lines changed

README.md

Lines changed: 80 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,82 @@
1-
# Grafana
1+
# Grafana - Graphite Dashboard
22

3-
Experimenting with a a custom graph dashboard based on [kibana](https://github.com/elasticsearch/kibana).
3+
A beautifully, easy to use and feature rich Graphite dashboard replacement and graph editor. Visit [grafana.org](http://grafana.org) for screenshots and feature lists.
44

5+
# Features
6+
## Graphite Target Editor
7+
- Graphite target expression parser
8+
- Quickly add / edit / remove function
9+
- Function parameters can be easily changed
10+
- Quickly navigate graphite metric structure
11+
- Templating
12+
- Integrated function documentation (TODO)
13+
- Click & drag functions to rearrange order (TODO)
14+
- Much more...
15+
16+
## Graphing
17+
- Fast rendering, even over large timespans.
18+
- Click and drag to zoom.
19+
- Multiple Y-axis.
20+
- Bars, Lines, Points.
21+
- Smart Y-axis formating
22+
- Series toggles & color selector
23+
- Axis labels
24+
- Fullscreen views and more...
25+
26+
## Dashboards
27+
- Create and edit dashboards
28+
- Drag and drop graphs to rearrange
29+
- Set column spans and row heights
30+
- Save & search dashboards (ElasticSearch)
31+
- Import & export dashboard (json file)
32+
- Import dashboard from Graphite
33+
- Templating
34+
- Much more...
35+
36+
# Requirements
37+
Grafana is very easy to install. It is a client side web app with no backend. Any webserver will do. Optionally you will need ElasticSearch if you want to be able to save and load dashboards quickly instead of json files or local storage.
38+
39+
# Installation
40+
- Download and extract the [latest release](https://github.com/asimov-deploy/asimov-deploy-winagent/releases/latest).
41+
- Edit config.js , the change graphiteUrl and elasticsearch to the correct urls. The urls entered here must be reachable by your browser.
42+
- Point your browser to the installation.
43+
44+
# Graphite server config
45+
If you haven't used an alternative dashboard for graphite before you need to enable cross-domain origin request. For Apache 2.x:
46+
```
47+
Header set Access-Control-Allow-Origin "*"
48+
Header set Access-Control-Allow-Methods "GET, OPTIONS"
49+
Header set Access-Control-Allow-Headers "origin, authorization, accept"
50+
```
51+
52+
If your Graphite web is proteced by basic authentication, you have to enable the HTTP verb OPTIONS. This looks like the following for Apache:
53+
```
54+
<Location />
55+
AuthName "graphs restricted"
56+
AuthType Basic
57+
AuthUserFile /etc/apache2/htpasswd
58+
<LimitExcept OPTIONS>
59+
require valid-user
60+
</LimitExcept>
61+
</Location>
62+
```
63+
64+
# Roadmap
65+
- Improve and refine the target parser and editing
66+
- Improve graphite import feature
67+
- Refine and simplify common tasks
68+
- More panel types (not just graphs)
69+
- Use elasticsearch to search for metrics
70+
- Improve template support
71+
- Add support for other time series databases like InfluxDB
72+
73+
# Contribute
74+
If you have any idea for 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!
75+
76+
![](http://grafana.org/assets/img/edit_dashboards.png)
77+
78+
# Notice
79+
This software is based on the great log dashboard [kibana](https://github.com/elasticsearch/kibana).
80+
81+
# License
82+
Grafana is distributed under Apache 2.0 License.

0 commit comments

Comments
 (0)