X-Git-Url: https://git.tokkee.org/?p=pkg-rrdtool.git;a=blobdiff_plain;f=doc%2Frrdgraph_examples.txt;h=fa523bdfb1ecb6002a4ef8d0fb44f1cb94c68c37;hp=ff3567dc4eedc6c0f06467a65c41b6588d1073c5;hb=645054bac6187b0e83fd4125fd59e4feda216b64;hpb=ffa00ac697dccce18dca8880ca7a14066521ac5c diff --git a/doc/rrdgraph_examples.txt b/doc/rrdgraph_examples.txt index ff3567d..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,19 +88,17 @@ EEXXAAMMPPLLEESS LINE1:data#FF0000:"Data with offset":STACK - DDrraawwiinngg ddaasshheedd lliinneess - + DDrraawwiinngg ddaasshheedd lliinneess Also works for HRULE and VRULE - · default style: - - - - - + · default style: - - - - - LINE1:data#FF0000:"dashed line":dashes - · more fancy style with offset: - - --- - --- - + · more fancy style with offset: - - --- - --- - LINE1:data#FF0000:"another dashed line":dashes=15,5,5,10:dash-offset=10 - TTiimmee rraannggeess - + TTiimmee rraannggeess Last four weeks: --start end-4w --end 00:00 January 2001: --start 20010101 --end start+31d January 2001: --start 20010101 --end 20010201 @@ -111,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 @@ -124,8 +118,7 @@ EEXXAAMMPPLLEESS AREA:lastweek#0000FF:Last\ week LINE1:thisweek#FF0000:This\ week - AAbbeerrrraanntt BBeehhaavviioouurr DDeetteeccttiioonn - + 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. @@ -146,17 +139,17 @@ EEXXAAMMPPLLEESS 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 (scaledup- - per and scaledlower virtual data sources), and potential failures (i.e. - potential aberrant aberrant behavior) marked by vertical yellow lines - (the fail data source). + 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 indi- - cators, with 1 denoting a potential failure. + 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 @@ -172,14 +165,15 @@ EEXXAAMMPPLLEESS _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 tem- - poral resolution, regardless of the actually resolution of the data in - the RRD file. This can present a problem for the specialized consoli- - dation 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 com- - mand tries to do something intelligent, but the confidence bands and - failures no longer have the same meaning and may be misleading. + 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 @@ -195,4 +189,4 @@ AAUUTTHHOORR -1.3.99909060808 2009-02-21 RRDGRAPH_EXAMPLES(1) +1.3.999 2009-05-10 RRDGRAPH_EXAMPLES(1)