X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=doc%2Frrdgraph_examples.txt;h=fa523bdfb1ecb6002a4ef8d0fb44f1cb94c68c37;hb=645054bac6187b0e83fd4125fd59e4feda216b64;hp=369e3b5562da12cf90fe4d33fcd93ea36fd76abc;hpb=ecfac614b914cef110a81ac665997a9b186da500;p=pkg-rrdtool.git diff --git a/doc/rrdgraph_examples.txt b/doc/rrdgraph_examples.txt index 369e3b5..fa523bd 100644 --- a/doc/rrdgraph_examples.txt +++ b/doc/rrdgraph_examples.txt @@ -12,12 +12,11 @@ SSYYNNOOPPSSIISS DDEESSCCRRIIPPTTIIOONN For your convenience some of the commands are explained here by using - detailed examples. They are not always cut-and-paste ready because com- - ments are intermixed with the examples. + detailed examples. They are not always cut-and-paste ready because + comments are intermixed with the examples. EEXXAAMMPPLLEESS - DDaattaa wwiitthh mmuullttiippllee rreessoolluuttiioonnss - + DDaattaa wwiitthh mmuullttiippllee rreessoolluuttiioonnss --end now --start end-120000s --width 400 DEF:ds0a=/home/rrdtool/data/router1.rrd:ds0:AVERAGE DEF:ds0b=/home/rrdtool/data/router1.rrd:ds0:AVERAGE:step=1800 @@ -26,8 +25,7 @@ EEXXAAMMPPLLEESS LINE1:ds0b#00CCFF:"resolution 1800 seconds per interval\l" LINE1:ds0c#FF00FF:"resolution 7200 seconds per interval\l" - NNiicceellyy ffoorrmmaatttteedd lleeggeenndd sseeccttiioonn - + NNiicceellyy ffoorrmmaatttteedd lleeggeenndd sseeccttiioonn DEF:ds0=/home/rrdtool/data/router1.rrd:ds0:AVERAGE DEF:ds1=/home/rrdtool/data/router1.rrd:ds1:AVERAGE VDEF:ds0max=ds0,MAXIMUM @@ -66,11 +64,10 @@ EEXXAAMMPPLLEESS GPRINT:ds1min:"%6.2lf %Sbps" GPRINT:ds1pct:"%6.2lf %Sbps\l" - OOffffsseettttiinngg aa lliinnee oonn tthhee yy--aaxxiiss - + OOffffsseettttiinngg aa lliinnee oonn tthhee yy--aaxxiiss Depending on your needs you can do this in two ways: - · Offset the data, then graph this + · Offset the data, then graph this DEF:mydata=my.rrd:ds:AVERAGE @@ -79,7 +76,7 @@ EEXXAAMMPPLLEESS CDEF:data=mydata,100,+ LINE1:data#FF0000:"Data with offset" - · Graph the original data, with an offset + · Graph the original data, with an offset DEF:mydata=my.rrd:ds:AVERAGE @@ -91,8 +88,17 @@ EEXXAAMMPPLLEESS LINE1:data#FF0000:"Data with offset":STACK - TTiimmee rraannggeess + DDrraawwiinngg ddaasshheedd lliinneess + Also works for HRULE and VRULE + + · default style: - - - - - + LINE1:data#FF0000:"dashed line":dashes + · more fancy style with offset: - - --- - --- - + LINE1:data#FF0000:"another dashed + line":dashes=15,5,5,10:dash-offset=10 + + TTiimmee rraannggeess Last four weeks: --start end-4w --end 00:00 January 2001: --start 20010101 --end start+31d January 2001: --start 20010101 --end 20010201 @@ -100,8 +106,7 @@ EEXXAAMMPPLLEESS Last 24 hours: Yesterday: --end 00:00 - VViieewwiinngg tthhee ccuurrrreenntt aanndd pprreevviioouuss wweeeekk ttooggeetthheerr - + VViieewwiinngg tthhee ccuurrrreenntt aanndd pprreevviioouuss wweeeekk ttooggeetthheerr --end now --start end-1w DEF:thisweek=router.rrd:ds0:AVERAGE DEF:lastweek=router.rrd:ds0:AVERAGE:end=now-1w:start=end-1w @@ -113,19 +118,75 @@ EEXXAAMMPPLLEESS AREA:lastweek#0000FF:Last\ week LINE1:thisweek#FF0000:This\ week + AAbbeerrrraanntt BBeehhaavviioouurr DDeetteeccttiioonn + If the specialized function RRRRAAss exist for aberrant behavior detection, + they can be used to generate the graph of a time series with confidence + bands and failures. + + rrdtool graph example.png \ + DEF:obs=monitor.rrd:ifOutOctets:AVERAGE \ + DEF:pred=monitor.rrd:ifOutOctets:HWPREDICT \ + DEF:dev=monitor.rrd:ifOutOctets:DEVPREDICT \ + DEF:fail=monitor.rrd:ifOutOctets:FAILURES \ + TICK:fail#ffffa0:1.0:"Failures\: Average bits out" \ + CDEF:scaledobs=obs,8,* \ + CDEF:upper=pred,dev,2,*,+ \ + CDEF:lower=pred,dev,2,*,- \ + CDEF:scaledupper=upper,8,* \ + CDEF:scaledlower=lower,8,* \ + LINE2:scaledobs#0000ff:"Average bits out" \ + LINE1:scaledupper#ff0000:"Upper Confidence Bound: Average bits out" \ + LINE1:scaledlower#ff0000:"Lower Confidence Bound: Average bits out" + + This example generates a graph of the data series in blue (LINE2 with + the scaledobs virtual data source), confidence bounds in red + (scaledupper and scaledlower virtual data sources), and potential + failures (i.e. potential aberrant aberrant behavior) marked by vertical + yellow lines (the fail data source). + + The raw data comes from an AVERAGE RRRRAA, the finest resolution of the + observed time series (one consolidated data point per primary data + point). The predicted (or smoothed) values are stored in the HWPREDICT + RRRRAA. The predicted deviations (think standard deviation) values are + stored in the DEVPREDICT RRRRAA. Finally, the FAILURES RRRRAA contains + indicators, with 1 denoting a potential failure. + + All of the data is rescaled to bits (instead of Octets) by multiplying + by 8. The confidence bounds are computed by an offset of 2 deviations + both above and below the predicted values (the CDEFs upper and lower). + Vertical lines indicated potential failures are graphed via the TICK + graph element, which converts non-zero values in an RRRRAA into tick + marks. Here an axis-fraction argument of 1.0 means the tick marks span + the entire y-axis, and hence become vertical lines on the graph. + + The choice of 2 deviations (a scaling factor) matches the default used + internally by the FAILURES RRRRAA. If the internal value is changed (see + rrdtune), this graphing command should be changed to be consistent. + + _A _n_o_t_e _o_n _d_a_t_a _r_e_d_u_c_t_i_o_n_: + + The rrrrddttooooll _g_r_a_p_h command is designed to plot data at a specified + temporal resolution, regardless of the actually resolution of the data + in the RRD file. This can present a problem for the specialized + consolidation functions which maintain a one-to-one mapping between + primary data points and consolidated data points. If a graph insists on + viewing the contents of these RRRRAAss on a coarser temporal scale, the + _g_r_a_p_h command tries to do something intelligent, but the confidence + bands and failures no longer have the same meaning and may be + misleading. + SSEEEE AALLSSOO rrdgraph gives an overview of how rrrrddttooooll ggrraapphh works. rrdgraph_data describes DDEEFF,CCDDEEFF and VVDDEEFF in detail. rrdgraph_rpn describes the RRPPNN language used in the xxDDEEFF statements. rrdgraph_graph page describes all the graph and print functions. - Make sure to read rrdgraph_examples for tips&tricks. - AAUUTTHHOORR Program by Tobias Oetiker - This manual page by Alex van den Bogaerdt + This manual page by Alex van den Bogaerdt with + corrections and/or additions by several people -1.2.26 2007-11-20 RRDGRAPH_EXAMPLES(1) +1.3.999 2009-05-10 RRDGRAPH_EXAMPLES(1)