Merge pull request #1597 from jwilder/jw-graph

Update graph docs for v2

docs/sources/reference/graph.md

@@ -4,29 +4,136 @@ title: Docs - Graphing
 
 # Graphing
 
-The main panel for in Grafana is simply named Graph. It provides a very rich set of graphing options.
+The main panel 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)
+Clicking the title for a panel exposes a menu.  The `edit` option opens additional configuration
+options for the panel.
 
-### Legens values
+## General
+![](/img/v2/graph_general.png)
 
-Check ``Include Values`` under legend styles.
+The general tab allows customization of a panel's appearance and menu options.
 
-- Total   - Sum of all values returned from metric query
-- Current - Last value returned from the metric query
+### General Options
+
+- ``Title`` - The panel title on the dashboard
+- ``Span`` - The panel width in columns
+- ``Height`` - The panel contents height in pixels
+
+### Drilldown / detail link
+
+The drilldown section allows adding dynamic links to the panel that can link to other dashboards
+or URLs
+
+Each link has a title, a type and params.  A link can be either a ``dashboard`` or ``absolute`` links.
+If it is a dashboard links, the `dashboard` value must be the name of a dashbaord.  If it's an
+`absolute` link, the URL is the URL to link.
+
+``params`` allows adding additional URL params to the links.  The format is the ``name=value`` with
+multiple params separate by ``&``.  Template variables can be added as values using ``$myvar``.
+
+When linking to another dashboard that uses template variables, you can use ``var-myvar=value`` to
+populate the template variable to a desired value from the link.
+
+## Metrics
+
+The metrics tab defines what series data and sources to render.  Each datasource provides different
+options.
+
+### Graphite
+
+### InfluxDB
+
+### OpenTSDB
+
+## Axes & Grid
+
+![](/img/v2/graph_axes_grid_options.png)
+
+The Axes & Grid tab controls the display of axes, grids and legend.
+
+### Axes
+
+The ``Left Y`` and ``Right Y`` can be customized using:
+
+- ``Unit`` - The display unit for the Y value
+- ``Grid Max`` - The maximum Y value. (default auto)
+- ``Grid Min`` - The minium Y value. (default auto)
+- ``Label`` - The Y axis label (default "")
+
+Axes can also be hidden by unchecking the appropriate box from `Show Axis`.
+
+Thresholds allow you to add arbitrary lines or sections to the graph to make it easier to see when
+the graph crosses a particular threshold.
+
+### Legend
+
+The legend hand be hidden by checking the ``Show`` checkbox.  If it's shown, it can be
+displayed as a table of values by checking the ``Table`` checkbox.  Series with no
+values can be hidden from the legend using the ``Hide empty`` checkbox.
+
+### Legend Values
+
+Additional values can be shown along-side the legend names:
+
+- ``Total`` - Sum of all values returned from metric query
+- ``Current`` - Last value returned from the metric query
+- ``Min`` - Minimum of all values returned from metric query
+- ``Max`` - Maximum of all values returned from the metric query
+- ``Avg`` - Average of all values returned from metric query
+- ``Decimals`` - Controls how many decimals are displayed for legend values
 
 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)
+## Display styles
+
+![](/img/v2/graph_display_styles.png)
+
+Display styles controls properties of the graph.
+
+### Chart Options
+
+- ``Bar`` - Display values as a bar chart
+- ``Lines`` - Display values as a line graph
+- ``Points`` - Display points for values
+
+### Line Options
+
+- ``Line Fill`` - Amount of color fill for a series.  0 is none.
+- ``Line Width`` - The width of the line for a series.
+- ``Null point mode`` - How null values are displayed
+- ``Staircase line`` - Draws adjacent points as staircase
+
+### Multiple Series
+
+If there are multiple series, they can be display as a group.
+
+- ``Stack`` - Each series is stacked on top of another
+- ``Percent`` - Each series is draw as a percent of the total of all series
 
 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
 
+### Rendering
+
+- ``Flot`` - Render the graphs in the browser using Flot (default)
+- ``Graphite PNG`` - Render the graph on the server using graphites render API.
+
+### Tooltip
+
+- ``All series`` - Show all series on the same tooltip and a x crosshairs to help follow all series
+
+### Series specific overrides
+
+The section allows a series to be render different from the rest.  For example, one series can be given
+a thicker line width to make it standout.
+
+## Time range
+
+![](/img/v2/graph_time_range.png)