public/grafana
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Updated docs

Browse Source
This commit is contained in:
Torkel Ödegaard
2015-03-10 14:41:19 +01:00
parent b693c7515c
commit 0ff99dddb9
19 changed files with 38 additions and 61 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/sources/reference/annotations.md
+47
View File
@@ -0,0 +1,47 @@
----
page_title: Annotations
page_description: Annotations user guide
page_keywords: grafana, annotations, guide, documentation
---
# Annotations
![](/img/v1/annotated_graph1.png)
Annotations provide a way to mark points on the graph with rich events. When you hover over an annotation
you can get title, tags, and text information for the event.
To enable annotations open dashboard settings and the controls tab.
Under feature toggles you will find the checkbox for annotations.
When enabled they will appear in the sub menu controls area.
![](/img/v1/annotations_submenu1.png)
Click the cog wheel to open the dialog where you can add & edit annotations.
![](/img/v1/annotations_dialog1.png)
## Datasources
Grafana supports many data sources for annotation.
- Graphite metrics
- Graphite events
- InfluxDB query
- Elasticsearch query
## InfluxDB Annotations
![](/img/influxdb/influxdb_annotation.png)
For InfluxDB you need to enter a query like in the above screenshot. You need to have the ```where $timeFilter``` part.
If you only select one column you will not need to enter anything in the column mapping fields.
If you have multiple columns you need to specify which column should be treated as title, tags and text column.
## Elasticsearch Annotations
![](/img/v1/elasticsearch_annotations_edit.png)
You can use the same data source as you specified in config.js for storing grafana dashboards or you can specify another one.
The annotation definition contains an index name that will override the index name specified in config.js. The index name can
be the name of an alias or an index wildcard pattern. You can leave the search query blank or specify a lucene query.
If your elasticsearch document has a timestamp field other than ```@timestamp``` you will need to specify that. As well
as the name for the fields that should be used for the annotation title, tags and text. Tags and text are optional.
**The annotation timestamp field in elasticsearch need to be in UTC format**
docs/sources/reference/export_import.md
+50
View File
@@ -0,0 +1,50 @@
---
page_title: Export & Import Guide
page_description: Export & Import Guide for Grafana
page_keywords: grafana, export, import, documentation
---
# Export and Import
## Export (Json file)
Load the dashboard you wish to export (e.g. via search)
Click on the "Save" icon (floppy disk)
![](/img/v1/export_import_save_menu.png)
Click on "Export schema"
![](/img/v1/export_schema_link.png)
Save file on local disk
![](/img/v1/export_save_file.png)
## Import
Click the "Search" icon (open folder)
![](/img/v1/export_import_search_menu.png)
Click "Import" button
![](/img/v1/export_import_button.png)
Click "Browse" button and browse to previously exported dashboard on local disk (which should be a valid Json file)
![](/img/v1/export_import_browse_button.png)
Select exported dashboard
![](/img/v1/export_import_popup.png)
Click "Save" icon to show save menu
![](/img/v1/export_import_save_menu.png)
Click new save icon (floppy disk) to Save newly imported dashboard
![](/img/v1/export_import_save_dashboard.png)
docs/sources/reference/graphs.md
+32
View File
@@ -0,0 +1,32 @@
---
title: Docs - Graphing
---
# Graphing
The main panel for in Grafana is simply named Graph. It provides a very rich set of graphing options.
<img src="/img/v1/graph_overview.png" class="no-shadow">
## Axes, Grid & Legend options
![](/img/v1/graph_axes_grid_options.png)
### Legens values
Check ``Include Values`` under legend styles.
- Total - Sum of all values returned from metric query
- Current - Last value returned from the metric query
This means that if your series represents a rate, for example requests / second then the Total in the legend will
not represent the total number of requests. It is just the sum of all data points.
## Display options
![](/img/v1/graph_display_styles.png)
If you have stack enabled you can select what the mouse hover feature should show.
- Cumulative - Sum of series below plus the series you hover over
- Individual - Just the value for the series you hover over
docs/sources/reference/playlist.md
+33
View File
@@ -0,0 +1,33 @@
---
page_title: Playlist Guide
page_description: Playlist guide for Grafana
page_keywords: grafana, playlist, documentation
---
# Playlist Guide
In Grafana v1.5 a playlist feature was added. You can use this feature by first marking a couple
of dashboards as favorites. This is accomplished in the Save menu. Click on the save icon and then _Mark As Favorite_.
## Step 1 - Mark as favorire
![](/img/v1/mark_as_favorite.png)
Then open the playlist modal. You will find this button in the open dashboard / search popup (CTRL+F).
## Step 2 - Open playlist view
![](/img/v1/playlist_button.png)
This opens the playlist view.
## Step 3 - Select dashbords and interval
![](/img/v1/playlist_modal.png)
In this view you can select the dashboards you want to include in the playlist, and even remove dashboards from you favorites list. Set the time span between dashboard change, for example 1m, 10m, 1h for 1 minute, 10 minute or 1 hour interval.
To start the dashboard click the Start button.
When a dashboard playlist is running, most menu buttons and dashboard controls are hidden. This is in order to present as clear a view of the dashboard as possible for big tv displays. Click the stop playlist link in the top menu to the right to stop the playlist.
![](playlist_playing_hiden_menu.png)
docs/sources/reference/scripted_dashboards.md
+61
View File
@@ -0,0 +1,61 @@
----
page_title: Scripted dashboards
page_description: Scripted dashboards
page_keywords: grafana, scripted, guide, documentation
---
# Scripted Dashboards
If you have lots of metric names that change (new servers etc) in a defined pattern it is irritating to constantly have to create new dashboards.
With scripted dashboards you can dynamically create your dashboards using javascript. In the folder grafana install folder _app/dashboards/_ there is a file named _scripted.js_. This file contains an example of a scripted dashboard. You can access it by using the url:
> http://grafana_url/#/dashboard/script/scripted.js?rows=3&name=myName
If you open scripted.js you can see how it reads url paramters from ARGS variable and then adds rows and panels.
## Example
```javascript
var rows = 1;
var seriesName = 'argName';
if(!_.isUndefined(ARGS.rows)) {
rows = parseInt(ARGS.rows, 10);
}
if(!_.isUndefined(ARGS.name)) {
seriesName = ARGS.name;
}
for (var i = 0; i < rows; i++) {
dashboard.rows.push({
title: 'Scripted Graph ' + i,
height: '300px',
panels: [
{
title: 'Events',
type: 'graph',
span: 12,
fill: 1,
linewidth: 2,
targets: [
{
'target': "randomWalk('" + seriesName + "')"
},
{
'target': "randomWalk('random walk2')"
}
],
}
]
});
}
return dashboard;
```
## More examples
You can find more examples in `app/dashboards/` directory of your grafana installation.
docs/sources/reference/search.md
+34
View File
@@ -0,0 +1,34 @@
----
page_title: Search guide
page_description: Search guide
page_keywords: grafana, time range, guide, documentation
---
# Search Guide
To search and load dashboards click the open folder icon in the header or use the shortcut CTRL+F.
## Tags
![](/img/v1/dashboards_tags2_search.png)
Click on any dashboard or use the down arrow key to navigate the search result and hit enter to open the selected dashboard.
If you have a lot of dashboards use tags to organize them. You can add tags in the dashboards settings modal.
![](/img/v1/dashboards_tags1.png)
After you have added tags you can now view all available tags in the search popup. Click the tags link to the right in the search box, or just hit tab and then enter. You should now see a list of all tags. You can filter the tag list by continue writing in the search box, for example: "tags!:mongodb".
![](/img/v1/dashboards_tags3_search.png)
Click on any tag in the tag list to show dashboards with that tag (or just down arrow key to select a tag then enter key).
## Keyboard navigation
While the search input has focus you can use your keyboard arrow keys to navigate the results, hit enter to open the selected dashboard.
docs/sources/reference/templated_dashboards.md
+18
View File
@@ -0,0 +1,18 @@
----
page_title: Templated dashboards
page_description: Templated dashboards
page_keywords: grafana, templating, variables, guide, documentation
---
# Templated Dashboards
Templating feature can be enabled under dashboard settings, in the Features tab. The templating feature allows
you to create variables that can be used in your metric queries, series names and panel titles. Use this feature to
create generic dashboards that can quickly be changed to show graphs for different servers or metrics.
## Screencast - Templated Graphite Queries
<iframe width="561" height="315" src="//www.youtube.com/embed/FhNUrueWwOk?list=PLDGkOdUX1Ujo3wHw9-z5Vo12YLqXRjzg2" frameborder="0" allowfullscreen></iframe>
<br>
## Screencast - Templated InfluxDB Queries
Coming soon
docs/sources/reference/time_range.md
+26
View File
@@ -0,0 +1,26 @@
----
page_title: Time Range options
page_description: Time range user guide
page_keywords: grafana, time range, guide, documentation
---
# Time range controls
![](/img/v1/time_range_controls.png)
In the menu you have the time range dropdown (between to Zoom out and refresh links).
In this dropdown you have relative time options, auto refresh options and custom time options.
## Custom time
To customize the relative and auto refresh options open the dashboard settings and click the Timepicker tab.
In this tab you can specify the relative and auto refresh intervals. The Timepicker tab settings are saved
on per dashboard basis.
![](/img/v1/timepicker_editor.png)
## Time picker options
In dashboard settings, `Time Picker` tab you can add or remove the relative time intervals and refresh intervals
that should be available in the time picker dropdown.