graphite-dev team mailing list archive

["nleskiw@xxxxxxxxx" <nleskiw@xxxxxxxxx>]

Hello,

After a bit of technical difficulties while merging (Thanks for your help,
Chris!) the Second y-Axis feature has been added to trunk.
This allows you to graph sets of metrics with very different y-Values on the
same graph (usually to help find correlations.)

Basically, it's like any other function:

http://my.graphite-server.com/render/?target=my.very.large.metric&target=secondYAxis(my.very.small.metric)

my.very.large.metric would be drawn according to the scale of the left-side
axis, and my.very.small.metric would be draw according to the scale of the
right-side axis.


   - Options for enabling two axes have been added to the UI as well.  Go to
   Graph Data, select one or more metrics, click "Apply Fucntion" > "Special" >
   "Draw in Second Y Axis."
   - To visually distinguish which lines are associated with each axis,
   several parameters can also be set to all the lines drawn to the right axis
   scale, or left axis scale.  They're available under "Graph Options" > "Left
   / Right Y Axis Options." For example, &leftColor=blue&rightColor=red would
   color all left y-axis lines blue, and all right y-axis lines red.  There are
   similar functions for Dashed, and Width as well.
   - You can also set yMax, yMin, yLimit, yStep, per-axis as well.
   - One caveat, areaMode=stacked does not work with two axes. I can't see
   how it would be useful (the right-stacked area would simply cover the
   left-stacked area) but if there's a widespread need for that I'll look into
   it.


Also, for a long time the yAxisSide=right / left has been in Graphite, but
there was no selector in the Composer UI. One has been added to the yAxis
menu.  (Note the "Left / Right Y Axis Options" do not apply to the graph is
there is only one axis drawn. Use the standard yAxis options in that case.)

Please let me know if you'd like to see some changes to this configuration
or have any questions and always, please report any bugs you find (related
to this change or not) on the Graphite Launchpad page at:

http://launchpad.net/graphite

-Nicholas Leskiw