RRDGRAPH_EXAMPLES(1)                rrdtool               RRDGRAPH_EXAMPLES(1)


<?><?><?> (NAME)
       rrdgraph_examples - <?><?><?><?><?><?><?><?><?> <?><?><?><?> rrdtool
       graph

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       rrdtool graph /home/httpd/html/test.png --imgformat PNG

       <?><?> <?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?>

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>.
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?> <?> <?><?><?><?><?><?><?> (cut-and-paste)
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
   <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?>
           --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\l"
           LINE1:ds0b#00CCFF:"resolution 1800 seconds per interval\l"
           LINE1:ds0c#FF00FF:"resolution 7200 seconds per interval\l"

   <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?>
           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

       <?><?><?><?>: <?><?><?><?><?> (consolidation) <?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?>.

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

       <?><?><?><?>: <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?> <?><?><?><?>

           COMMENT:"          "

       <?><?><?><?>: <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>

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

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

   <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?> y
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?> <?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?>:

       o   <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?> (offset)<?>
           <?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?>

               DEF:mydata=my.rrd:ds:AVERAGE

           <?><?><?><?>: <?><?><?> <?><?><?> <?><?> <?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <<data>>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?>
           <?><?><?><?><?><?><?><?>

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

       o   <?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?>
           <?><?><?> <?><?><?><?>

               DEF:mydata=my.rrd:ds:AVERAGE

           <?><?><?><?>: <?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>

               LINE1:100

           <?><?><?><?>: <?><?> <?><?><?> <?><?> <?><?><?> <?><?> <?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> (STACK <?><?><?><?><?><?>)

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

   <?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> HRULE <?> VRULE <?><?><?> <?><?><?> <?><?><?><?><?><?>

       o   <?><?><?> <?><?><?><?><?><?><?>: - - - - -

               LINE1:data#FF0000:"dashed line":dashes

       o   <?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>: - -
           --- -  --- -

               LINE1:data#FF0000:"another dashed line":dashes=15,5,5,10:dash-offset=10

   <?><?><?><?><?><?><?><?> <?><?><?><?><?>
           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

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

       <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> (<?><?><?><?><?><?> <?><?><?><?><?>) <?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> (Shift)

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

   <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?> RRA<?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?>.

          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"

       <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?> (LINE2 <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> scaledobs)<?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?>
       <?><?><?><?> (<?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       scaledupper <?> scaledlower)<?> <?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> (<?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>) <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?> (<?><?><?><?> <?><?><?><?><?> fail)
       <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?> RRA <?><?> <?><?><?>
       AVERAGE <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?> (<?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>).
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> (<?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?>) <?><?> RRA <?><?> <?><?><?>
       HWPREDICT <?><?><?><?><?> <?><?><?><?><?><?><?>.  <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
       (<?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>) <?><?> RRA <?><?>
       <?><?><?> DEVPREDICT <?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?>
       <?><?><?><?><?><?> RRA <?><?> <?><?><?> FAILURES <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?>.

       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?>
       <?><?> <?><?> <?><?><?> (<?><?> <?><?><?> <?><?><?><?> <?><?> Octet)
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>.
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?> <?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?> <?><?><?><?> <?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> (CDEF<?><?><?> upper <?>
       lower). <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> TICK <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?> RRA <?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>. <?><?> <?><?><?><?><?>
       <?><?><?><?><?> 1.0 <?><?><?><?> <?><?><?><?><?><?><?> axis-fraction
       <?><?> <?><?><?> <?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?> y
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>.

       <?><?><?><?><?><?> <?> <?><?><?><?><?><?> (<?><?> <?><?><?><?>
       <?><?><?><?><?>) <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> RRA <?><?> <?><?><?>
       FAILURES <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>. <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?> (<?><?> rrdtune
       <?><?><?><?><?><?> <?><?><?><?>)<?> <?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>.

       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?>:

       <?><?><?><?><?> graph <?><?> rrdtool <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> RRD. <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?>. <?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> RRA<?><?>
       <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> graph
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       <?><?><?><?><?> rrdgraph <?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> rrdtool graph <?><?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?><?><?> rrdgraph_data
       <?><?><?><?><?><?><?><?> DEF<?> CDEF <?> VDEF <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>.  <?><?><?><?><?>
       rrdgraph_rpn <?><?><?><?> RPN <?><?> <?><?> <?><?> <?><?><?><?><?><?>
       xDEF <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?><?><?> rrdgraph_graph <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?> <?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (AUTHOR)
       <?><?><?><?><?><?> <?><?><?><?> Tobias Oetiker <tobi@oetiker.ch>

       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> Alex van den
       Bogaerdt <alex@vandenbogaerdt.nl> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?>/<?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?>

1.11.0                            2026-08-08              RRDGRAPH_EXAMPLES(1)