


     RRRRRRRRDDDDGGGGRRRRAAAAPPPPHHHH____EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS((((1111))))   1111....2222....11113333 ((((2222000000006666----00005555----00004444))))   RRRRRRRRDDDDGGGGRRRRAAAAPPPPHHHH____EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS((((1111))))



     NNNNAAAAMMMMEEEE
          rrdgraph_examples - Examples for rrdtool graph

     SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
          rrrrrrrrddddttttoooooooollll ggggrrrraaaapppphhhh ////hhhhoooommmmeeee////hhhhttttttttppppdddd////hhhhttttmmmmllll////tttteeeesssstttt....ppppnnnngggg --------iiiimmmmgggg----ffffoooorrrrmmmmaaaatttt PPPPNNNNGGGG \\\\

          followed by any of the examples below

     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
          For your convenience some of the commands are explained here
          by using detailed examples. They are not always cut-and-
          paste ready because comments are intermixed with the
          examples.

     EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
          DDDDaaaattttaaaa wwwwiiiitttthhhh mmmmuuuullllttttiiiipppplllleeee rrrreeeessssoooolllluuuuttttiiiioooonnnnssss

              --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
              DEF:ds0c=/home/rrdtool/data/router1.rrd:ds0:AVERAGE:step=7200
              LINE1:ds0a#0000FF:"default resolution\n"
              LINE1:ds0b#00CCFF:"resolution 1800 seconds per interval\n"
              LINE1:ds0c#FF00FF:"resolution 7200 seconds per interval\n"

          NNNNiiiicccceeeellllyyyy ffffoooorrrrmmmmaaaatttttttteeeedddd lllleeeeggggeeeennnndddd sssseeeeccccttttiiiioooonnnn

              DEF:ds0=/home/rrdtool/data/router1.rrd:ds0:AVERAGE
              DEF:ds1=/home/rrdtool/data/router1.rrd:ds1:AVERAGE
              VDEF:ds0max=ds0,MAXIMUM
              VDEF:ds0avg=ds0,AVERAGE
              VDEF:ds0min=ds0,MINIMUM
              VDEF:ds0pct=ds0,95,PERCENT
              VDEF:ds1max=ds1,MAXIMUM
              VDEF:ds1avg=ds1,AVERAGE
              VDEF:ds1min=ds1,MINIMUM
              VDEF:ds1pct=ds1,95,PERCENT

          Note: consolidation occurs here.

              CDEF:ds0bits=ds0,8,*
              CDEF:ds1bits=ds1,8,*

          Note: 10 spaces to move text to the right

              COMMENT:"          "

          Note: the column titles have to be as wide as the columns

              COMMENT:"Maximum    "
              COMMENT:"Average    "
              COMMENT:"Minimum    "



     Page 1                                          (printed 6/13/06)






     RRRRRRRRDDDDGGGGRRRRAAAAPPPPHHHH____EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS((((1111))))   1111....2222....11113333 ((((2222000000006666----00005555----00004444))))   RRRRRRRRDDDDGGGGRRRRAAAAPPPPHHHH____EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS((((1111))))



          Note: some lines contains the new-line character "\n"

              COMMENT:"95th percentile\n"
              AREA:ds0bits#00C000:"Inbound "
              GPRINT:ds0max:"%6.2lf %Sbps"
              GPRINT:ds0avg:"%6.2lf %Sbps"
              GPRINT:ds0min:"%6.2lf %Sbps"
              GPRINT:ds0pct:"%6.2lf %Sbps\n"
              LINE1:ds1bits#0000FF:"Outbound"
              GPRINT:ds1max:"%6.2lf %Sbps"
              GPRINT:ds1avg:"%6.2lf %Sbps"
              GPRINT:ds1min:"%6.2lf %Sbps"
              GPRINT:ds1pct:"%6.2lf %Sbps\n"

          OOOOffffffffsssseeeettttttttiiiinnnngggg aaaa lllliiiinnnneeee oooonnnn tttthhhheeee yyyy-aaaaxxxxiiiissss

          Depending on your needs you can do this in two ways:

          +o   Offset the data, then graph this

                  DEF:mydata=my.rrd:ds:AVERAGE

              Note: this will also influence any other command that
              uses "data"

                  CDEF:data=mydata,100,+
                  LINE1:data#FF0000:"Data with offset"

          +o   Graph the original data, with an offset

                  DEF:mydata=my.rrd:ds:AVERAGE

              Note: no color in the first line so it is not visible

                  LINE1:100

              Note: the second line gets stacked on top of the first
              one

                  LINE1:data#FF0000:"Data with offset":STACK

          TTTTiiiimmmmeeee rrrraaaannnnggggeeeessss

              Last four weeks: --start end-4w --end 00:00
              January 2001:    --start 20010101 --end start+31d
              January 2001:    --start 20010101 --end 20010201
              Last hour:       --start end-1h
              Last 24 hours:   <nothing at all>
              Yesterday:       --end 00:00






     Page 2                                          (printed 6/13/06)






     RRRRRRRRDDDDGGGGRRRRAAAAPPPPHHHH____EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS((((1111))))   1111....2222....11113333 ((((2222000000006666----00005555----00004444))))   RRRRRRRRDDDDGGGGRRRRAAAAPPPPHHHH____EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS((((1111))))



          VVVViiiieeeewwwwiiiinnnngggg tttthhhheeee ccccuuuurrrrrrrreeeennnntttt aaaannnndddd pppprrrreeeevvvviiiioooouuuussss wwwweeeeeeeekkkk ttttooooggggeeeetttthhhheeeerrrr

              --end now --start end-1w
              DEF:thisweek=router.rrd:ds0:AVERAGE
              DEF:lastweek=router.rrd:ds0:AVERAGE:end=now-1w:start=end-1w

          Shift the data forward by one week (604800 seconds)

              SHIFT:lastweek:604800
              [ more of the usual VDEF and CDEF stuff if you like ]
              AREA:lastweek#0000FF:Last\ week
              LINE1:thisweek#FF0000:This\ week

     SSSSEEEEEEEE AAAALLLLSSSSOOOO
          rrdgraph gives an overview of how rrrrrrrrddddttttoooooooollll ggggrrrraaaapppphhhh works.
          rrdgraph_data describes DDDDEEEEFFFF,CCCCDDDDEEEEFFFF and VVVVDDDDEEEEFFFF in detail.
          rrdgraph_rpn describes the RRRRPPPPNNNN language used in the ????DDDDEEEEFFFF
          statements.  rrdgraph_graph page describes all the graph and
          print functions.

          Make sure to read rrdgraph_examples for tips&tricks.

     AAAAUUUUTTTTHHHHOOOORRRR
          Program by Tobias Oetiker <tobi@oetiker.ch>

          This manual page by Alex van den Bogaerdt
          <alex@ergens.op.het.net>




























     Page 3                                          (printed 6/13/06)



